@module-federation/nextjs-mf 5.2.2 → 5.3.0

package/lib/_virtual/UrlNode.js

@@ -0,0 +1,8 @@
+'use strict';
+
+var _commonjsHelpers = require('./_commonjsHelpers.js');
+var UrlNode = require('../loaders/UrlNode.js');
+
+var require$$2 = /*@__PURE__*/_commonjsHelpers.getAugmentedNamespace(UrlNode);
+
+module.exports = require$$2;

package/lib/_virtual/_commonjsHelpers.js

@@ -0,0 +1,26 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+function getAugmentedNamespace(n) {
+  var f = n.default;
+	if (typeof f == "function") {
+		var a = function () {
+			return f.apply(this, arguments);
+		};
+		a.prototype = f.prototype;
+  } else a = {};
+  Object.defineProperty(a, '__esModule', {value: true});
+	Object.keys(n).forEach(function (k) {
+		var d = Object.getOwnPropertyDescriptor(n, k);
+		Object.defineProperty(a, k, d.get ? d : {
+			enumerable: true,
+			get: function () {
+				return n[k];
+			}
+		});
+	});
+	return a;
+}
+
+exports.getAugmentedNamespace = getAugmentedNamespace;

package/lib/_virtual/_tslib.js

@@ -0,0 +1,101 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+
+function __awaiter(thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+}
+
+function __generator(thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+}
+
+function __values(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+}
+
+function __read(o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+}
+
+function __spreadArray(to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+}
+
+exports.__awaiter = __awaiter;
+exports.__generator = __generator;
+exports.__read = __read;
+exports.__spreadArray = __spreadArray;
+exports.__values = __values;

package/lib/_virtual/helpers.js

@@ -0,0 +1,7 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var helpers = {};
+
+exports.__exports = helpers;

package/lib/_virtual/nextPageMapLoader.js

@@ -0,0 +1,7 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var nextPageMapLoader = {exports: {}};
+
+exports.nextPageMapLoader = nextPageMapLoader;

package/lib/client/CombinedPages.d.ts

@@ -0,0 +1,28 @@
+import { RemotePages } from './RemotePages';
+/**
+ * Class which provides combined sorted list of local and remote routes.
+ */
+export declare class CombinedPages {
+    /** Computable list of available local & remote pages in proper sorted order. */
+    private sortedPageCache;
+    /** List of pages that belongs to the current host application */
+    private localPagesCache;
+    /** List of known remote pages this list might be extent during runtime */
+    private remotePagesCache;
+    /** Nextjs getter which obtained from patchNextClientPageLoader */
+    private localPagesGetter;
+    /** Loader of remote pages  */
+    private remotePages;
+    constructor(localPagesGetter: () => Promise<string[]>, remotePages: RemotePages);
+    /**
+     * Check that provided route belongs to host application
+     */
+    isLocalRoute(route: string): Promise<boolean>;
+    /**
+     * Return sorted list of local & remotes routes.
+     * This method is used in patchNextClientPageLoader
+     * for patching nextjs' getPageList method.
+     */
+    getPageList(): Promise<string[]>;
+}
+//# sourceMappingURL=CombinedPages.d.ts.map

package/lib/client/CombinedPages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CombinedPages.d.ts","sourceRoot":"","sources":["../../src/client/CombinedPages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;GAEG;AACH,qBAAa,aAAa;IACxB,gFAAgF;IAChF,OAAO,CAAC,eAAe,CAAW;IAElC,iEAAiE;IACjE,OAAO,CAAC,eAAe,CAAW;IAClC,0EAA0E;IAC1E,OAAO,CAAC,gBAAgB,CAAW;IACnC,kEAAkE;IAClE,OAAO,CAAC,gBAAgB,CAA0B;IAClD,8BAA8B;IAC9B,OAAO,CAAC,WAAW,CAAc;gBAG/B,gBAAgB,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,EACzC,WAAW,EAAE,WAAW;IAM1B;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM;IAKhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAavC"}

package/lib/client/CombinedPages.js

@@ -0,0 +1,60 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../_virtual/_tslib.js');
+var helpers = require('./helpers.js');
+
+/**
+ * Class which provides combined sorted list of local and remote routes.
+ */
+var CombinedPages = /** @class */ (function () {
+    function CombinedPages(localPagesGetter, remotePages) {
+        this.localPagesGetter = localPagesGetter;
+        this.remotePages = remotePages;
+    }
+    /**
+     * Check that provided route belongs to host application
+     */
+    CombinedPages.prototype.isLocalRoute = function (route) {
+        return _tslib.__awaiter(this, void 0, void 0, function () {
+            var localPages;
+            return _tslib.__generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.localPagesGetter()];
+                    case 1:
+                        localPages = _a.sent();
+                        return [2 /*return*/, localPages.includes(route)];
+                }
+            });
+        });
+    };
+    /**
+     * Return sorted list of local & remotes routes.
+     * This method is used in patchNextClientPageLoader
+     * for patching nextjs' getPageList method.
+     */
+    CombinedPages.prototype.getPageList = function () {
+        return _tslib.__awaiter(this, void 0, void 0, function () {
+            var localPages, remotePages;
+            return _tslib.__generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.localPagesGetter()];
+                    case 1:
+                        localPages = _a.sent();
+                        remotePages = this.remotePages.getPageList();
+                        if (localPages !== this.localPagesCache ||
+                            remotePages !== this.remotePagesCache) {
+                            this.localPagesCache = localPages;
+                            this.remotePagesCache = remotePages;
+                            this.sortedPageCache = helpers.sortNextPages(_tslib.__spreadArray(_tslib.__spreadArray([], _tslib.__read(localPages), false), _tslib.__read(remotePages), false));
+                        }
+                        return [2 /*return*/, this.sortedPageCache];
+                }
+            });
+        });
+    };
+    return CombinedPages;
+}());
+
+exports.CombinedPages = CombinedPages;

package/lib/client/MFClient.d.ts

@@ -0,0 +1,70 @@
+import type PageLoader from 'next/dist/client/page-loader';
+import EventEmitter from 'eventemitter3';
+import { CombinedPages } from './CombinedPages';
+import { RemotePages } from './RemotePages';
+import { RemoteContainer } from './RemoteContainer';
+declare type EventTypes = 'loadedRemoteRoute' | 'loadedLocalRoute';
+/** Remote Container string eg `home@https://example.com/_next/static/chunks/remoteEntry.js` */
+export declare type RemoteString = string;
+/**
+ * The main class for Module Federation on the client side in runtime.
+ * Instance of this class is a Singleton and stored in `window.mf_client` variable.
+ */
+export declare class MFClient {
+    /** List of registered remotes */
+    remotes: Record<RemoteString, RemoteContainer>;
+    /** Local & Remote pages sorted in correct order */
+    combinedPages: CombinedPages;
+    /** Remote pages loader */
+    remotePages: RemotePages;
+    /** EventEmitter which allows to subscribe on different events */
+    events: EventEmitter<EventTypes>;
+    /** Original nextjs PageLoader which passed by `patchNextClientPageLoader.js` */
+    private _nextPageLoader;
+    constructor(nextPageLoader: PageLoader);
+    /**
+     * This method returns sorted list of local and federated pages.
+     *
+     * `patchNextClientPageLoader` change vanilla PageLoader.getPageList() method:
+     *   - exposes vanilla implementation as _getPageListOriginal()
+     *   - and PageLoader.getPageList() starting call this method under the hood
+     */
+    getPageList(): Promise<string[]>;
+    /**
+     * Check that current browser pathname is served by federated remotes.
+     *
+     * Eg. if cleanPathname `/shop/nodkz/product123` and pageListFederated is ['/shop/nodkz/[...mee]']
+     *     then this method will match federated dynamic route and return true.
+     *
+     * PS. This method is used by DevHmrFixInvalidPongPlugin (fix HMR page reloads in dev mode)
+     */
+    isFederatedPathname(cleanPathname: string): boolean;
+    /**
+     * Add remote entry to remotes registry of MFClient.
+     * This RemoteContainer will be used for loading remote pages.
+     *
+     * @remoteStr string -  eg. `home@https://example.com/_next/static/chunks/remoteEntry.js`
+     */
+    registerRemote(remoteStr: RemoteString): RemoteContainer;
+    /**
+     * Convert browser pathname to NextJS route.
+     *
+     *   /shop/products/123 -> /shop/products/[...id]
+     *
+     * For regular pages logic is simple (just match exact name).
+     * But for dynamic routes it's quite complicated - page list must be in specific order.
+     */
+    pathnameToRoute(cleanPathname: string): Promise<string | undefined>;
+    /**
+     * This method patch routeLoader.loadRoute() in runtime (on bootstrap).
+     * During the build it's quite complicated to do.
+     */
+    private _wrapLoadRoute;
+    /**
+     * This method patch routeLoader.whenEntrypoint() in runtime (on bootstrap).
+     * During the build it's quite complicated to do.
+     */
+    private _wrapWhenEntrypoint;
+}
+export {};
+//# sourceMappingURL=MFClient.d.ts.map

package/lib/client/MFClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MFClient.d.ts","sourceRoot":"","sources":["../../src/client/MFClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,8BAA8B,CAAC;AAC3D,OAAO,YAAY,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,aAAK,UAAU,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAE3D,+FAA+F;AAC/F,oBAAY,YAAY,GAAG,MAAM,CAAC;AAElC;;;GAGG;AACH,qBAAa,QAAQ;IACnB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,CAAM;IACpD,mDAAmD;IACnD,aAAa,EAAE,aAAa,CAAC;IAC7B,0BAA0B;IAC1B,WAAW,EAAE,WAAW,CAAC;IACzB,iEAAiE;IACjE,MAAM,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACjC,gFAAgF;IAChF,OAAO,CAAC,eAAe,CAAa;gBAExB,cAAc,EAAE,UAAU;IAuBtC;;;;;;OAMG;IACG,WAAW;IAIjB;;;;;;;OAOG;IACH,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;IAInD;;;;;OAKG;IACH,cAAc,CAAC,SAAS,EAAE,YAAY;IAMtC;;;;;;;OAOG;IACG,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKzE;;;OAGG;IACH,OAAO,CAAC,cAAc;IAoCtB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CAwD5B"}

package/lib/client/MFClient.js

@@ -0,0 +1,197 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../_virtual/_tslib.js');
+var EventEmitter = require('eventemitter3');
+var helpers = require('./helpers.js');
+var CombinedPages = require('./CombinedPages.js');
+var RemotePages = require('./RemotePages.js');
+var RemoteContainer = require('./RemoteContainer.js');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var EventEmitter__default = /*#__PURE__*/_interopDefaultLegacy(EventEmitter);
+
+/**
+ * The main class for Module Federation on the client side in runtime.
+ * Instance of this class is a Singleton and stored in `window.mf_client` variable.
+ */
+var MFClient = /** @class */ (function () {
+    function MFClient(nextPageLoader) {
+        var _this = this;
+        var _a, _b;
+        /** List of registered remotes */
+        this.remotes = {};
+        this._nextPageLoader = nextPageLoader;
+        this.events = new EventEmitter__default["default"]();
+        var cfg = ((_b = (_a = global === null || global === void 0 ? void 0 : global.__NEXT_DATA__) === null || _a === void 0 ? void 0 : _a.props) === null || _b === void 0 ? void 0 : _b.mfRoutes) || {};
+        this.remotePages = new RemotePages.RemotePages();
+        Object.keys(cfg).forEach(function (remoteStr) {
+            var remote = _this.registerRemote(remoteStr);
+            _this.remotePages.addRoutes(cfg[remoteStr], remote);
+        });
+        this.combinedPages = new CombinedPages.CombinedPages(this._nextPageLoader._getPageListOriginal.bind(this._nextPageLoader), this.remotePages);
+        this._wrapLoadRoute(nextPageLoader);
+        this._wrapWhenEntrypoint(nextPageLoader);
+    }
+    /**
+     * This method returns sorted list of local and federated pages.
+     *
+     * `patchNextClientPageLoader` change vanilla PageLoader.getPageList() method:
+     *   - exposes vanilla implementation as _getPageListOriginal()
+     *   - and PageLoader.getPageList() starting call this method under the hood
+     */
+    MFClient.prototype.getPageList = function () {
+        return _tslib.__awaiter(this, void 0, void 0, function () {
+            return _tslib.__generator(this, function (_a) {
+                return [2 /*return*/, this.combinedPages.getPageList()];
+            });
+        });
+    };
+    /**
+     * Check that current browser pathname is served by federated remotes.
+     *
+     * Eg. if cleanPathname `/shop/nodkz/product123` and pageListFederated is ['/shop/nodkz/[...mee]']
+     *     then this method will match federated dynamic route and return true.
+     *
+     * PS. This method is used by DevHmrFixInvalidPongPlugin (fix HMR page reloads in dev mode)
+     */
+    MFClient.prototype.isFederatedPathname = function (cleanPathname) {
+        return !!this.remotePages.routeToRemote(cleanPathname);
+    };
+    /**
+     * Add remote entry to remotes registry of MFClient.
+     * This RemoteContainer will be used for loading remote pages.
+     *
+     * @remoteStr string -  eg. `home@https://example.com/_next/static/chunks/remoteEntry.js`
+     */
+    MFClient.prototype.registerRemote = function (remoteStr) {
+        var remote = RemoteContainer.RemoteContainer.createSingleton(remoteStr);
+        this.remotes[remote.global] = remote;
+        return remote;
+    };
+    /**
+     * Convert browser pathname to NextJS route.
+     *
+     *   /shop/products/123 -> /shop/products/[...id]
+     *
+     * For regular pages logic is simple (just match exact name).
+     * But for dynamic routes it's quite complicated - page list must be in specific order.
+     */
+    MFClient.prototype.pathnameToRoute = function (cleanPathname) {
+        return _tslib.__awaiter(this, void 0, void 0, function () {
+            var routes;
+            return _tslib.__generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.getPageList()];
+                    case 1:
+                        routes = _a.sent();
+                        return [2 /*return*/, helpers.pathnameToRoute(cleanPathname, routes)];
+                }
+            });
+        });
+    };
+    /**
+     * This method patch routeLoader.loadRoute() in runtime (on bootstrap).
+     * During the build it's quite complicated to do.
+     */
+    MFClient.prototype._wrapLoadRoute = function (nextPageLoader) {
+        var _this = this;
+        var _a;
+        if (!((_a = nextPageLoader === null || nextPageLoader === void 0 ? void 0 : nextPageLoader.routeLoader) === null || _a === void 0 ? void 0 : _a.loadRoute)) {
+            throw new Error('[nextjs-mf] Cannot wrap `pageLoader.routeLoader.loadRoute()` with custom logic.');
+        }
+        var routeLoader = nextPageLoader.routeLoader;
+        // if _loadRouteOriginal does not initialized then take original loadRoute method
+        if (!routeLoader._loadRouteOriginal) {
+            routeLoader._loadRouteOriginal = routeLoader.loadRoute.bind(routeLoader);
+        }
+        // replace loadRoute logic
+        routeLoader.loadRoute = function (route, prefetch) { return _tslib.__awaiter(_this, void 0, void 0, function () {
+            var routeInfo;
+            return _tslib.__generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.combinedPages.isLocalRoute(route)];
+                    case 1:
+                        if (!_a.sent()) return [3 /*break*/, 3];
+                        return [4 /*yield*/, routeLoader._loadRouteOriginal(route)];
+                    case 2:
+                        routeInfo = _a.sent();
+                        this.events.emit('loadedLocalRoute', routeInfo, prefetch);
+                        return [3 /*break*/, 5];
+                    case 3: return [4 /*yield*/, this.remotePages.getRouteInfo(route)];
+                    case 4:
+                        routeInfo = _a.sent();
+                        this.events.emit('loadedRemoteRoute', routeInfo, prefetch, this.remotePages.routeToRemote(route));
+                        _a.label = 5;
+                    case 5: return [2 /*return*/, routeInfo];
+                }
+            });
+        }); };
+    };
+    /**
+     * This method patch routeLoader.whenEntrypoint() in runtime (on bootstrap).
+     * During the build it's quite complicated to do.
+     */
+    MFClient.prototype._wrapWhenEntrypoint = function (nextPageLoader) {
+        var _this = this;
+        var _a;
+        if (!((_a = nextPageLoader.routeLoader) === null || _a === void 0 ? void 0 : _a.whenEntrypoint)) {
+            throw new Error('[nextjs-mf] Cannot wrap `pageLoader.routeLoader.whenEntrypoint()` with custom logic.');
+        }
+        var routeLoader = nextPageLoader.routeLoader;
+        // if _whenEntrypointOriginal does not initialized then take original loadRoute method
+        if (!routeLoader._whenEntrypointOriginal) {
+            routeLoader._whenEntrypointOriginal =
+                routeLoader.whenEntrypoint.bind(routeLoader);
+        }
+        // replace routeLoader.whenEntrypoint logic
+        routeLoader.whenEntrypoint = function (route) { return _tslib.__awaiter(_this, void 0, void 0, function () {
+            var route_1, awaitRemotes_1, routeInfo_1, routeInfo;
+            var _this = this;
+            return _tslib.__generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!(route === '/_error')) return [3 /*break*/, 6];
+                        return [4 /*yield*/, this.pathnameToRoute(window.location.pathname)];
+                    case 1:
+                        route_1 = _a.sent();
+                        if (!!route_1) return [3 /*break*/, 4];
+                        awaitRemotes_1 = [];
+                        Object.values(this.remotes).forEach(function (remote) {
+                            if (!remote.isLoaded()) {
+                                awaitRemotes_1.push(remote
+                                    .getContainer()
+                                    .then(function () { return _this.remotePages.loadRemotePageMap(remote); })
+                                    .catch(function () { return null; }));
+                            }
+                        });
+                        return [4 /*yield*/, Promise.all(awaitRemotes_1)];
+                    case 2:
+                        _a.sent();
+                        return [4 /*yield*/, this.pathnameToRoute(window.location.pathname)];
+                    case 3:
+                        route_1 = _a.sent();
+                        _a.label = 4;
+                    case 4:
+                        if (!route_1) return [3 /*break*/, 6];
+                        // TODO: fix router properties for the first page load of federated page http://localhost:3000/shop/products/B
+                        console.warn('replace entrypoint /_error by', route_1);
+                        return [4 /*yield*/, this.remotePages.getRouteInfo(route_1)];
+                    case 5:
+                        routeInfo_1 = _a.sent();
+                        this.events.emit('loadedRemoteRoute', routeInfo_1, false, this.remotePages.routeToRemote(route_1));
+                        return [2 /*return*/, routeInfo_1];
+                    case 6: return [4 /*yield*/, routeLoader._whenEntrypointOriginal(route)];
+                    case 7:
+                        routeInfo = _a.sent();
+                        return [2 /*return*/, routeInfo];
+                }
+            });
+        }); };
+    };
+    return MFClient;
+}());
+
+exports.MFClient = MFClient;

package/lib/client/RemoteContainer.d.ts

@@ -0,0 +1,58 @@
+import EventEmitter from 'eventemitter3';
+declare type EventTypes = 'loadStart' | 'loadComplete' | 'loadError';
+export declare type WebpackRemoteContainer = {
+    get(modulePath: ModulePath): () => any;
+};
+export declare type NextRoute = string;
+export declare type ModulePath = string;
+export declare type RemoteData = {
+    global: string;
+    url: string;
+};
+export declare type PageMap = Record<NextRoute, ModulePath>;
+/**
+ * This is a Lazy loader of webpack remote container with some NextJS-specific helper methods.
+ *
+ * It provides the ability to register remote, and load & init it on the first use.
+ */
+export declare class RemoteContainer {
+    global: string;
+    url: string;
+    container: WebpackRemoteContainer | undefined;
+    pageMap: PageMap | undefined;
+    error?: Error;
+    events: EventEmitter<EventTypes>;
+    static instances: Record<string, RemoteContainer>;
+    /**
+     * Create or reuse existed remote entry.
+     *
+     * Be careful, Singleton pattern does not work well in webpack builds,
+     * because one module may be copied between different chunks. In such a way
+     * you obtain several lists of instances.
+     */
+    static createSingleton(remote: string | RemoteData): RemoteContainer;
+    constructor(opts: RemoteData);
+    /**
+     * Check is the current remoteEntry.js loaded or not
+     */
+    isLoaded(): boolean;
+    /**
+     * Returns initialized webpack RemoteContainer.
+     * If its' script does not loaded - then load & init it firstly.
+     */
+    getContainer(): Promise<WebpackRemoteContainer>;
+    /**
+     * Return remote module from container.
+     * If you provide `exportName` it automatically return exact property value from module.
+     *
+     * @example
+     *   remote.getModule('./pages/index', 'default')
+     */
+    getModule(modulePath: string, exportName?: string): Promise<any>;
+    /**
+     * Retrieve registered nextjs' routes from remote app
+     */
+    getPageMap(): Promise<PageMap | undefined>;
+}
+export {};
+//# sourceMappingURL=RemoteContainer.d.ts.map

package/lib/client/RemoteContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteContainer.d.ts","sourceRoot":"","sources":["../../src/client/RemoteContainer.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,eAAe,CAAC;AAGzC,aAAK,UAAU,GAAG,WAAW,GAAG,cAAc,GAAG,WAAW,CAAC;AAE7D,oBAAY,sBAAsB,GAAG;IACnC,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,CAAC;CACxC,CAAC;AACF,oBAAY,SAAS,GAAG,MAAM,CAAC;AAC/B,oBAAY,UAAU,GAAG,MAAM,CAAC;AAChC,oBAAY,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AACF,oBAAY,OAAO,GAAG,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAEpD;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC9C,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IAEjC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAM;IAEvD;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;gBA8BtC,IAAI,EAAE,UAAU;IAM5B;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,sBAAsB,CAAC;IA2BrD;;;;;;OAMG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAYvD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;CAiBjD"}