@module-federation/electron 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.2.0](https://github.com/module-federation/electron/compare/0.1.1...0.2.0) (2026-11-09)
+
+
+### Features
+
+* load remotes from a URL with an offline cache ([#12](https://github.com/module-federation/electron/issues/12)) ([fbd816a](https://github.com/module-federation/electron/commit/fbd816ad54b6751b25a6835d2da9e6833d1b2872))
+
 ## [0.1.1](https://github.com/module-federation/electron/compare/0.1.0...0.1.1) (2026-11-04)
 
 

package/README.md

@@ -1,8 +1,20 @@
-# @module-federation/electron
+<h1 align="center">@module-federation/electron</h1>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@module-federation/electron">
+    <img src="https://img.shields.io/npm/v/@module-federation/electron?style=flat-square&colorA=564341&colorB=EDED91" alt="npm version" />
+  </a>
+  <a href="https://npmcharts.com/compare/@module-federation/electron?minimal=true">
+    <img src="https://img.shields.io/npm/dm/@module-federation/electron.svg?style=flat-square&colorA=564341&colorB=EDED91" alt="downloads" />
+  </a>
+  <a href="https://github.com/module-federation/electron/blob/main/LICENSE">
+    <img src="https://img.shields.io/npm/l/@module-federation/electron?style=flat-square&colorA=564341&colorB=EDED91" alt="license" />
+  </a>
+</p>
 
 Module Federation for Electron renderers built with Rsbuild or Vite. Hosts and remotes can use either bundler.
 
-In production every federated app is served from one privileged custom protocol, `mf://local/<app-id>/`. All apps share one origin, so remote entries, manifests and chunks load without CORS setup.
+In production every federated app is served from one privileged custom protocol, `mf://local/<app-id>/`. All apps share one origin, so remote entries, manifests and chunks load without CORS setup, whether an app's files sit on disk or come from a CDN. Remotes fetched from a URL are cached on disk, so the app keeps working offline.
 
 ## Install
 
@@ -37,6 +49,51 @@ app.whenReady().then(() => {
 
 `serveFederatedApps` maps each federation `name` to its build directory and returns a function that unregisters the handler. Requests outside an app's directory get a 404.
 
+## Remotes deployed to a URL
+
+An app can also be an `http(s)` URL. Requests for `mf://local/<app-id>/<path>` are fetched from `<url>/<path>` in the main process, so the renderer still sees one origin and needs no CORS setup:
+
+```ts
+serveFederatedApps({
+  apps: {
+    host: '/path/to/host/dist',
+    remote: 'https://cdn.example.com/remote/',
+  },
+});
+```
+
+Build the remote with the Rsbuild or Vite plugin from this package, so its chunks load from `mf://local/<app-id>/` too. A remote whose `publicPath` is an absolute `https://` URL loads its chunks directly, without the offline cache.
+
+### Offline cache
+
+Responses from remote apps are cached on disk, so the app keeps working when a remote is down:
+
+| Situation                                                                       | Response                                                                                   |
+| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
+| Remote answers 2xx                                                              | The fresh response. It replaces the cached copy.                                           |
+| Offline, DNS failure, connection refused                                        | The cached copy.                                                                           |
+| Remote answers an error status (a broken deploy returning 500 or 404)           | The cached copy. Error responses are never cached.                                         |
+| No response within the connect timeout, or the body stalls for the read timeout | The cached copy. For the next 30 s, other cached requests to that origin skip the network. |
+| Not reachable and never cached (first launch offline)                           | `502`, or `504` on a timeout. Module Federation reports a failed remote.                   |
+
+- **Network first.** The cache is used only when the network fails, so a remote that is up serves its latest release. After any failed request, other cached requests to that origin skip the network for 30 s, so a remote that has just recovered is picked up after that window.
+- **Only `GET` responses are cached**, together with their headers, so ES module remotes still pass MIME checks offline. Query strings are ignored, so cache-busting parameters still hit the cache.
+- Responses served from the cache carry an `x-mf-cache: stale` header (exported as `CACHE_HEADER`). Fallbacks are logged with `console.warn`.
+- Writes go through a temporary file and a rename, so a crash never leaves a partial entry. To reset the cache, quit the app and delete its directory.
+
+```ts
+serveFederatedApps({
+  apps: { remote: 'https://cdn.example.com/remote/' },
+  cache: {
+    dir: path.join(app.getPath('userData'), 'remotes'), // default: <sessionData>/module-federation
+    connectTimeout: 10_000, // ms to wait for response headers
+    readTimeout: 10_000, // ms the body may stall, not a limit on the whole download
+  },
+});
+```
+
+Pass `cache: false` to proxy remote apps without caching.
+
 ## Rsbuild
 
 `./rsbuild` and `./vite` re-export the URL helpers, so build configs don't load `electron`.
@@ -79,3 +136,43 @@ Both plugins take a second argument, `{ electron: { protocol, scheme, host } }`:
 - `scheme` / `host` (default `mf` / `local`): change the URL. Pass the same values to `registerFederationScheme` and `serveFederatedApps`.
 
 The Rsbuild plugin also takes `{ rsbuild }`, which is passed through to `@module-federation/rsbuild-plugin`.
+
+## API
+
+From `@module-federation/electron` (main process only, it imports `electron`):
+
+| Export                                                 | Description                                                                                                |
+| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
+| `registerFederationScheme({ scheme? })`                | Registers the scheme as privileged (standard, secure, fetch, CORS, streaming). Call before `app` is ready. |
+| `serveFederatedApps({ apps, cache?, scheme?, host? })` | Serves each app from its directory or URL. Call after `app.whenReady()`. Returns an unregister function.   |
+| `resolveAppFile(pathname, dirs)`                       | Resolves an `mf://` path to a file inside an app's directory, or `undefined` if it falls outside.          |
+| `CACHE_HEADER`                                         | `'x-mf-cache'`, set to `stale` on responses served from the offline cache.                                 |
+
+From every entry point, including `./rsbuild` and `./vite`:
+
+| Export                                | Description                                                                               |
+| ------------------------------------- | ----------------------------------------------------------------------------------------- |
+| `federationUrl(name, file, options?)` | URL of a file inside an app, e.g. `mf://local/remote-vite/mf-manifest.json`.              |
+| `federationBaseUrl(name, options?)`   | Base URL an app is served from, e.g. `mf://local/remote-vite/`.                           |
+| `toAppId(name)`                       | Normalizes a federation `name` into the URL path segment (`remote_vite` → `remote-vite`). |
+| `DEFAULT_SCHEME`, `DEFAULT_HOST`      | `'mf'` and `'local'`.                                                                     |
+
+From `./rsbuild`: `pluginModuleFederationElectron(federation, { electron?, rsbuild? })`, and `pluginElectron(name, options?)` if you register `@module-federation/rsbuild-plugin` yourself.
+
+From `./vite`: `federationElectron(federation, { electron? })`, and `electron(name, options?)` if you register `@module-federation/vite` yourself.
+
+## Troubleshooting
+
+- **A Vite remote's React bindings are `undefined` in an Rsbuild host**: use `@module-federation/vite` 1.23.9 or later ([module-federation/vite#1535](https://github.com/module-federation/vite/issues/1535)).
+- **`does not provide an export named 'net'`**: `ELECTRON_RUN_AS_NODE=1` is set, usually by a terminal inside VS Code or another Electron app. Unset it before starting Electron.
+
+## Links
+
+- [Repository and examples](https://github.com/module-federation/electron)
+- [Module Federation documentation](https://module-federation.io/)
+- [Discord](https://discord.gg/n69NnT3ACV)
+- [Issues](https://github.com/module-federation/electron/issues)
+
+## License
+
+[MIT](https://github.com/module-federation/electron/blob/main/LICENSE)

package/dist/index.cjs

@@ -1,5 +1,14 @@
 "use strict";
 var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
 (()=>{
     __webpack_require__.d = (exports1, getters, values)=>{
         var define = (defs, kind)=>{
@@ -28,6 +37,7 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
+    CACHE_HEADER: ()=>external_remote_cjs_namespaceObject.CACHE_HEADER,
     DEFAULT_HOST: ()=>external_url_cjs_namespaceObject.DEFAULT_HOST,
     DEFAULT_SCHEME: ()=>external_url_cjs_namespaceObject.DEFAULT_SCHEME,
     federationBaseUrl: ()=>external_url_cjs_namespaceObject.federationBaseUrl,
@@ -37,8 +47,11 @@ __webpack_require__.d(__webpack_exports__, {
     serveFederatedApps: ()=>serveFederatedApps,
     toAppId: ()=>external_url_cjs_namespaceObject.toAppId
 });
+const external_node_path_namespaceObject = require("node:path");
+var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
 const external_node_url_namespaceObject = require("node:url");
 const external_electron_namespaceObject = require("electron");
+const external_remote_cjs_namespaceObject = require("./remote.cjs");
 const external_resolve_cjs_namespaceObject = require("./resolve.cjs");
 const external_url_cjs_namespaceObject = require("./url.cjs");
 function registerFederationScheme(options = {}) {
@@ -59,20 +72,31 @@ function registerFederationScheme(options = {}) {
 function serveFederatedApps(options) {
     const scheme = options.scheme ?? external_url_cjs_namespaceObject.DEFAULT_SCHEME;
     const host = options.host ?? external_url_cjs_namespaceObject.DEFAULT_HOST;
-    const apps = Object.fromEntries(Object.entries(options.apps).map(([name, dir])=>[
-            (0, external_url_cjs_namespaceObject.toAppId)(name),
-            dir
-        ]));
+    const dirs = {};
+    const urls = {};
+    for (const [name, location] of Object.entries(options.apps))((0, external_remote_cjs_namespaceObject.isRemoteLocation)(location) ? urls : dirs)[(0, external_url_cjs_namespaceObject.toAppId)(name)] = location;
+    const fetchRemote = (0, external_remote_cjs_namespaceObject.createRemoteHandler)({
+        fetch: (url, init)=>external_electron_namespaceObject.net.fetch(url, init),
+        cache: false === options.cache ? false : {
+            ...options.cache,
+            dir: options.cache?.dir ?? external_node_path_default().join(external_electron_namespaceObject.app.getPath('sessionData'), 'module-federation')
+        }
+    });
     external_electron_namespaceObject.protocol.handle(scheme, async (request)=>{
         const url = new URL(request.url);
-        const file = url.host === host ? (0, external_resolve_cjs_namespaceObject.resolveAppFile)(url.pathname, apps) : void 0;
-        if (!file) return new Response('Not found', {
+        if (url.host === host) {
+            const upstream = (0, external_remote_cjs_namespaceObject.resolveAppUrl)(url, urls);
+            if (upstream) return fetchRemote(request, upstream);
+            const file = (0, external_resolve_cjs_namespaceObject.resolveAppFile)(url.pathname, dirs);
+            if (file) return external_electron_namespaceObject.net.fetch((0, external_node_url_namespaceObject.pathToFileURL)(file).href);
+        }
+        return new Response('Not found', {
             status: 404
         });
-        return external_electron_namespaceObject.net.fetch((0, external_node_url_namespaceObject.pathToFileURL)(file).href);
     });
     return ()=>external_electron_namespaceObject.protocol.unhandle(scheme);
 }
+exports.CACHE_HEADER = __webpack_exports__.CACHE_HEADER;
 exports.DEFAULT_HOST = __webpack_exports__.DEFAULT_HOST;
 exports.DEFAULT_SCHEME = __webpack_exports__.DEFAULT_SCHEME;
 exports.federationBaseUrl = __webpack_exports__.federationBaseUrl;
@@ -82,6 +106,7 @@ exports.resolveAppFile = __webpack_exports__.resolveAppFile;
 exports.serveFederatedApps = __webpack_exports__.serveFederatedApps;
 exports.toAppId = __webpack_exports__.toAppId;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "CACHE_HEADER",
     "DEFAULT_HOST",
     "DEFAULT_SCHEME",
     "federationBaseUrl",

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["webpack://webpack/runtime/define_property_getters","webpack://webpack/runtime/has_own_property","webpack://webpack/runtime/make_namespace_object","../src/index.ts"],"sourcesContent":["__webpack_require__.d = (exports, getters, values) => {\n\tvar define = (defs, kind) => {\n\t\tfor(var key in defs) {\n\t\t\tif(__webpack_require__.o(defs, key) && !__webpack_require__.o(exports, key)) {\n\t\t\t\tObject.defineProperty(exports, key, { enumerable: true, [kind]: defs[key] });\n\t\t\t}\n\t\t}\n\t};\n\tdefine(getters, \"get\");\n\tdefine(values, \"value\");\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","/**\n * Electron main-process integration. Build configs should import the URL helpers\n * from `@module-federation/electron/rsbuild` or `/vite` instead: this entry imports `electron`.\n */\nimport { pathToFileURL } from 'node:url';\nimport { net, protocol } from 'electron';\nimport { resolveAppFile } from './resolve.ts';\nimport { DEFAULT_HOST, DEFAULT_SCHEME, toAppId } from './url.ts';\n\nexport { resolveAppFile } from './resolve.ts';\nexport {\n  DEFAULT_HOST,\n  DEFAULT_SCHEME,\n  federationBaseUrl,\n  federationUrl,\n  toAppId,\n  type FederationUrlOptions,\n} from './url.ts';\n\nexport interface RegisterSchemeOptions {\n  scheme?: string;\n}\n\n/**\n * Registers the federation scheme as privileged (fetch, CORS, ESM, service workers).\n * Must be called before the `ready` event of `app`.\n */\nexport function registerFederationScheme(options: RegisterSchemeOptions = {}): void {\n  protocol.registerSchemesAsPrivileged([\n    {\n      scheme: options.scheme ?? DEFAULT_SCHEME,\n      privileges: {\n        standard: true,\n        secure: true,\n        supportFetchAPI: true,\n        corsEnabled: true,\n        stream: true,\n        codeCache: true,\n      },\n    },\n  ]);\n}\n\nexport interface ServeFederatedAppsOptions {\n  scheme?: string;\n  host?: string;\n  /** Map of federation `name` (or app id) to the directory holding its build output. */\n  apps: Record<string, string>;\n}\n\n/**\n * Serves each app's build output on `<scheme>://<host>/<appId>/`.\n * Call after `app.whenReady()`. Returns a function that unregisters the handler.\n */\nexport function serveFederatedApps(options: ServeFederatedAppsOptions): () => void {\n  const scheme = options.scheme ?? DEFAULT_SCHEME;\n  const host = options.host ?? DEFAULT_HOST;\n  const apps = Object.fromEntries(\n    Object.entries(options.apps).map(([name, dir]) => [toAppId(name), dir]),\n  );\n\n  protocol.handle(scheme, async (request) => {\n    const url = new URL(request.url);\n    const file = url.host === host ? resolveAppFile(url.pathname, apps) : undefined;\n    if (!file) return new Response('Not found', { status: 404 });\n    return net.fetch(pathToFileURL(file).href);\n  });\n\n  return () => protocol.unhandle(scheme);\n}\n"],"names":["__webpack_require__","getters","values","define","defs","kind","key","Object","obj","prop","Symbol","registerFederationScheme","options","protocol","DEFAULT_SCHEME","serveFederatedApps","scheme","host","DEFAULT_HOST","apps","name","dir","toAppId","request","url","URL","file","resolveAppFile","undefined","Response","net","pathToFileURL"],"mappings":";;;IAAAA,oBAAoB,CAAC,GAAG,CAAC,UAASC,SAASC;QAC1C,IAAIC,SAAS,CAACC,MAAMC;YACnB,IAAI,IAAIC,OAAOF,KACd,IAAGJ,oBAAoB,CAAC,CAACI,MAAME,QAAQ,CAACN,oBAAoB,CAAC,CAAC,UAASM,MACtEC,OAAO,cAAc,CAAC,UAASD,KAAK;gBAAE,YAAY;gBAAM,CAACD,KAAK,EAAED,IAAI,CAACE,IAAI;YAAC;QAG7E;QACAH,OAAOF,SAAS;QAChBE,OAAOD,QAAQ;IAChB;;;ICVAF,oBAAoB,CAAC,GAAG,CAACQ,KAAKC,OAAUF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACC,KAAKC;;;ICClFT,oBAAoB,CAAC,GAAG,CAAC;QACxB,IAAG,AAAkB,MAAlB,OAAOU,UAA0BA,OAAO,WAAW,EACrDH,OAAO,cAAc,CAAC,UAASG,OAAO,WAAW,EAAE;YAAE,OAAO;QAAS;QAEtEH,OAAO,cAAc,CAAC,UAAS,cAAc;YAAE,OAAO;QAAK;IAC5D;;;;;;;;;;;;;;;;;;ACqBO,SAASI,yBAAyBC,UAAiC,CAAC,CAAC;IAC1EC,kCAAAA,QAAAA,CAAAA,2BAAoC,CAAC;QACnC;YACE,QAAQD,QAAQ,MAAM,IAAIE,iCAAAA,cAAcA;YACxC,YAAY;gBACV,UAAU;gBACV,QAAQ;gBACR,iBAAiB;gBACjB,aAAa;gBACb,QAAQ;gBACR,WAAW;YACb;QACF;KACD;AACH;AAaO,SAASC,mBAAmBH,OAAkC;IACnE,MAAMI,SAASJ,QAAQ,MAAM,IAAIE,iCAAAA,cAAcA;IAC/C,MAAMG,OAAOL,QAAQ,IAAI,IAAIM,iCAAAA,YAAYA;IACzC,MAAMC,OAAOZ,OAAO,WAAW,CAC7BA,OAAO,OAAO,CAACK,QAAQ,IAAI,EAAE,GAAG,CAAC,CAAC,CAACQ,MAAMC,IAAI,GAAK;YAACC,IAAAA,iCAAAA,OAAAA,AAAAA,EAAQF;YAAOC;SAAI;IAGxER,kCAAAA,QAAAA,CAAAA,MAAe,CAACG,QAAQ,OAAOO;QAC7B,MAAMC,MAAM,IAAIC,IAAIF,QAAQ,GAAG;QAC/B,MAAMG,OAAOF,IAAI,IAAI,KAAKP,OAAOU,AAAAA,IAAAA,qCAAAA,cAAAA,AAAAA,EAAeH,IAAI,QAAQ,EAAEL,QAAQS;QACtE,IAAI,CAACF,MAAM,OAAO,IAAIG,SAAS,aAAa;YAAE,QAAQ;QAAI;QAC1D,OAAOC,kCAAAA,GAAAA,CAAAA,KAAS,CAACC,AAAAA,IAAAA,kCAAAA,aAAAA,AAAAA,EAAcL,MAAM,IAAI;IAC3C;IAEA,OAAO,IAAMb,kCAAAA,QAAAA,CAAAA,QAAiB,CAACG;AACjC"}
+{"version":3,"file":"index.cjs","sources":["webpack://webpack/runtime/compat_get_default_export","webpack://webpack/runtime/define_property_getters","webpack://webpack/runtime/has_own_property","webpack://webpack/runtime/make_namespace_object","../src/index.ts"],"sourcesContent":["// getDefaultExport function for compatibility with non-ESM modules\n__webpack_require__.n = (module) => {\n\tvar getter = module && module.__esModule ?\n\t\t() => (module['default']) :\n\t\t() => (module);\n\t__webpack_require__.d(getter, { a: getter });\n\treturn getter;\n};\n","__webpack_require__.d = (exports, getters, values) => {\n\tvar define = (defs, kind) => {\n\t\tfor(var key in defs) {\n\t\t\tif(__webpack_require__.o(defs, key) && !__webpack_require__.o(exports, key)) {\n\t\t\t\tObject.defineProperty(exports, key, { enumerable: true, [kind]: defs[key] });\n\t\t\t}\n\t\t}\n\t};\n\tdefine(getters, \"get\");\n\tdefine(values, \"value\");\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","/**\n * Electron main-process integration. Build configs should import the URL helpers\n * from `@module-federation/electron/rsbuild` or `/vite` instead: this entry imports `electron`.\n */\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport { app, net, protocol } from 'electron';\nimport {\n  createRemoteHandler,\n  isRemoteLocation,\n  resolveAppUrl,\n  type RemoteCacheOptions,\n} from './remote.ts';\nimport { resolveAppFile } from './resolve.ts';\nimport { DEFAULT_HOST, DEFAULT_SCHEME, toAppId } from './url.ts';\n\nexport { CACHE_HEADER, type RemoteCacheOptions } from './remote.ts';\nexport { resolveAppFile } from './resolve.ts';\nexport {\n  DEFAULT_HOST,\n  DEFAULT_SCHEME,\n  federationBaseUrl,\n  federationUrl,\n  toAppId,\n  type FederationUrlOptions,\n} from './url.ts';\n\nexport interface RegisterSchemeOptions {\n  scheme?: string;\n}\n\n/**\n * Registers the federation scheme as privileged (fetch, CORS, ESM, service workers).\n * Must be called before the `ready` event of `app`.\n */\nexport function registerFederationScheme(options: RegisterSchemeOptions = {}): void {\n  protocol.registerSchemesAsPrivileged([\n    {\n      scheme: options.scheme ?? DEFAULT_SCHEME,\n      privileges: {\n        standard: true,\n        secure: true,\n        supportFetchAPI: true,\n        corsEnabled: true,\n        stream: true,\n        codeCache: true,\n      },\n    },\n  ]);\n}\n\nexport interface ServeFederatedAppsOptions {\n  scheme?: string;\n  host?: string;\n  /**\n   * Map of federation `name` (or app id) to the directory holding its build output,\n   * or the http(s) URL it is deployed to.\n   */\n  apps: Record<string, string>;\n  /**\n   * Offline cache for apps served from a URL. Pass `false` to proxy them without caching.\n   * By default responses are cached in `<sessionData>/module-federation`.\n   */\n  cache?: false | Partial<RemoteCacheOptions>;\n}\n\n/**\n * Serves each app on `<scheme>://<host>/<appId>/`, from its build directory or from the\n * URL it is deployed to. Call after `app.whenReady()`. Returns a function that unregisters\n * the handler.\n */\nexport function serveFederatedApps(options: ServeFederatedAppsOptions): () => void {\n  const scheme = options.scheme ?? DEFAULT_SCHEME;\n  const host = options.host ?? DEFAULT_HOST;\n  const dirs: Record<string, string> = {};\n  const urls: Record<string, string> = {};\n  for (const [name, location] of Object.entries(options.apps)) {\n    (isRemoteLocation(location) ? urls : dirs)[toAppId(name)] = location;\n  }\n  const fetchRemote = createRemoteHandler({\n    fetch: (url, init) => net.fetch(url, init),\n    cache:\n      options.cache === false\n        ? false\n        : {\n            ...options.cache,\n            dir: options.cache?.dir ?? path.join(app.getPath('sessionData'), 'module-federation'),\n          },\n  });\n\n  protocol.handle(scheme, async (request) => {\n    const url = new URL(request.url);\n    if (url.host === host) {\n      const upstream = resolveAppUrl(url, urls);\n      if (upstream) return fetchRemote(request, upstream);\n      const file = resolveAppFile(url.pathname, dirs);\n      if (file) return net.fetch(pathToFileURL(file).href);\n    }\n    return new Response('Not found', { status: 404 });\n  });\n\n  return () => protocol.unhandle(scheme);\n}\n"],"names":["__webpack_require__","module","getter","getters","values","define","defs","kind","key","Object","obj","prop","Symbol","registerFederationScheme","options","protocol","DEFAULT_SCHEME","serveFederatedApps","scheme","host","DEFAULT_HOST","dirs","urls","name","location","isRemoteLocation","toAppId","fetchRemote","createRemoteHandler","url","init","net","path","app","request","URL","upstream","resolveAppUrl","file","resolveAppFile","pathToFileURL","Response"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,3 +1,5 @@
+import { type RemoteCacheOptions } from './remote.cjs';
+export { CACHE_HEADER, type RemoteCacheOptions } from './remote.cjs';
 export { resolveAppFile } from './resolve.cjs';
 export { DEFAULT_HOST, DEFAULT_SCHEME, federationBaseUrl, federationUrl, toAppId, type FederationUrlOptions, } from './url.cjs';
 export interface RegisterSchemeOptions {
@@ -11,12 +13,21 @@ export declare function registerFederationScheme(options?: RegisterSchemeOptions
 export interface ServeFederatedAppsOptions {
     scheme?: string;
     host?: string;
-    /** Map of federation `name` (or app id) to the directory holding its build output. */
+    /**
+     * Map of federation `name` (or app id) to the directory holding its build output,
+     * or the http(s) URL it is deployed to.
+     */
     apps: Record<string, string>;
+    /**
+     * Offline cache for apps served from a URL. Pass `false` to proxy them without caching.
+     * By default responses are cached in `<sessionData>/module-federation`.
+     */
+    cache?: false | Partial<RemoteCacheOptions>;
 }
 /**
- * Serves each app's build output on `<scheme>://<host>/<appId>/`.
- * Call after `app.whenReady()`. Returns a function that unregisters the handler.
+ * Serves each app on `<scheme>://<host>/<appId>/`, from its build directory or from the
+ * URL it is deployed to. Call after `app.whenReady()`. Returns a function that unregisters
+ * the handler.
  */
 export declare function serveFederatedApps(options: ServeFederatedAppsOptions): () => void;
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,OAAO,EACP,KAAK,oBAAoB,GAC1B,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,qBAA0B,GAAG,IAAI,CAclF;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM,IAAI,CAejF"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,OAAO,EACP,KAAK,oBAAoB,GAC1B,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,qBAA0B,GAAG,IAAI,CAclF;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM,IAAI,CA+BjF"}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { type RemoteCacheOptions } from './remote.js';
+export { CACHE_HEADER, type RemoteCacheOptions } from './remote.js';
 export { resolveAppFile } from './resolve.js';
 export { DEFAULT_HOST, DEFAULT_SCHEME, federationBaseUrl, federationUrl, toAppId, type FederationUrlOptions, } from './url.js';
 export interface RegisterSchemeOptions {
@@ -11,12 +13,21 @@ export declare function registerFederationScheme(options?: RegisterSchemeOptions
 export interface ServeFederatedAppsOptions {
     scheme?: string;
     host?: string;
-    /** Map of federation `name` (or app id) to the directory holding its build output. */
+    /**
+     * Map of federation `name` (or app id) to the directory holding its build output,
+     * or the http(s) URL it is deployed to.
+     */
     apps: Record<string, string>;
+    /**
+     * Offline cache for apps served from a URL. Pass `false` to proxy them without caching.
+     * By default responses are cached in `<sessionData>/module-federation`.
+     */
+    cache?: false | Partial<RemoteCacheOptions>;
 }
 /**
- * Serves each app's build output on `<scheme>://<host>/<appId>/`.
- * Call after `app.whenReady()`. Returns a function that unregisters the handler.
+ * Serves each app on `<scheme>://<host>/<appId>/`, from its build directory or from the
+ * URL it is deployed to. Call after `app.whenReady()`. Returns a function that unregisters
+ * the handler.
  */
 export declare function serveFederatedApps(options: ServeFederatedAppsOptions): () => void;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,OAAO,EACP,KAAK,oBAAoB,GAC1B,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,qBAA0B,GAAG,IAAI,CAclF;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM,IAAI,CAejF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,OAAO,EACP,KAAK,oBAAoB,GAC1B,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,qBAA0B,GAAG,IAAI,CAclF;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM,IAAI,CA+BjF"}

package/dist/index.js

@@ -1,5 +1,7 @@
+import node_path from "node:path";
 import { pathToFileURL } from "node:url";
-import { net, protocol } from "electron";
+import { app, net, protocol } from "electron";
+import { CACHE_HEADER, createRemoteHandler, isRemoteLocation, resolveAppUrl } from "./remote.js";
 import { resolveAppFile } from "./resolve.js";
 import { DEFAULT_HOST, DEFAULT_SCHEME, federationBaseUrl, federationUrl, toAppId } from "./url.js";
 function registerFederationScheme(options = {}) {
@@ -20,20 +22,30 @@ function registerFederationScheme(options = {}) {
 function serveFederatedApps(options) {
     const scheme = options.scheme ?? DEFAULT_SCHEME;
     const host = options.host ?? DEFAULT_HOST;
-    const apps = Object.fromEntries(Object.entries(options.apps).map(([name, dir])=>[
-            toAppId(name),
-            dir
-        ]));
+    const dirs = {};
+    const urls = {};
+    for (const [name, location] of Object.entries(options.apps))(isRemoteLocation(location) ? urls : dirs)[toAppId(name)] = location;
+    const fetchRemote = createRemoteHandler({
+        fetch: (url, init)=>net.fetch(url, init),
+        cache: false === options.cache ? false : {
+            ...options.cache,
+            dir: options.cache?.dir ?? node_path.join(app.getPath('sessionData'), 'module-federation')
+        }
+    });
     protocol.handle(scheme, async (request)=>{
         const url = new URL(request.url);
-        const file = url.host === host ? resolveAppFile(url.pathname, apps) : void 0;
-        if (!file) return new Response('Not found', {
+        if (url.host === host) {
+            const upstream = resolveAppUrl(url, urls);
+            if (upstream) return fetchRemote(request, upstream);
+            const file = resolveAppFile(url.pathname, dirs);
+            if (file) return net.fetch(pathToFileURL(file).href);
+        }
+        return new Response('Not found', {
             status: 404
         });
-        return net.fetch(pathToFileURL(file).href);
     });
     return ()=>protocol.unhandle(scheme);
 }
-export { DEFAULT_HOST, DEFAULT_SCHEME, federationBaseUrl, federationUrl, registerFederationScheme, resolveAppFile, serveFederatedApps, toAppId };
+export { CACHE_HEADER, DEFAULT_HOST, DEFAULT_SCHEME, federationBaseUrl, federationUrl, registerFederationScheme, resolveAppFile, serveFederatedApps, toAppId };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * Electron main-process integration. Build configs should import the URL helpers\n * from `@module-federation/electron/rsbuild` or `/vite` instead: this entry imports `electron`.\n */\nimport { pathToFileURL } from 'node:url';\nimport { net, protocol } from 'electron';\nimport { resolveAppFile } from './resolve.ts';\nimport { DEFAULT_HOST, DEFAULT_SCHEME, toAppId } from './url.ts';\n\nexport { resolveAppFile } from './resolve.ts';\nexport {\n  DEFAULT_HOST,\n  DEFAULT_SCHEME,\n  federationBaseUrl,\n  federationUrl,\n  toAppId,\n  type FederationUrlOptions,\n} from './url.ts';\n\nexport interface RegisterSchemeOptions {\n  scheme?: string;\n}\n\n/**\n * Registers the federation scheme as privileged (fetch, CORS, ESM, service workers).\n * Must be called before the `ready` event of `app`.\n */\nexport function registerFederationScheme(options: RegisterSchemeOptions = {}): void {\n  protocol.registerSchemesAsPrivileged([\n    {\n      scheme: options.scheme ?? DEFAULT_SCHEME,\n      privileges: {\n        standard: true,\n        secure: true,\n        supportFetchAPI: true,\n        corsEnabled: true,\n        stream: true,\n        codeCache: true,\n      },\n    },\n  ]);\n}\n\nexport interface ServeFederatedAppsOptions {\n  scheme?: string;\n  host?: string;\n  /** Map of federation `name` (or app id) to the directory holding its build output. */\n  apps: Record<string, string>;\n}\n\n/**\n * Serves each app's build output on `<scheme>://<host>/<appId>/`.\n * Call after `app.whenReady()`. Returns a function that unregisters the handler.\n */\nexport function serveFederatedApps(options: ServeFederatedAppsOptions): () => void {\n  const scheme = options.scheme ?? DEFAULT_SCHEME;\n  const host = options.host ?? DEFAULT_HOST;\n  const apps = Object.fromEntries(\n    Object.entries(options.apps).map(([name, dir]) => [toAppId(name), dir]),\n  );\n\n  protocol.handle(scheme, async (request) => {\n    const url = new URL(request.url);\n    const file = url.host === host ? resolveAppFile(url.pathname, apps) : undefined;\n    if (!file) return new Response('Not found', { status: 404 });\n    return net.fetch(pathToFileURL(file).href);\n  });\n\n  return () => protocol.unhandle(scheme);\n}\n"],"names":["registerFederationScheme","options","protocol","DEFAULT_SCHEME","serveFederatedApps","scheme","host","DEFAULT_HOST","apps","Object","name","dir","toAppId","request","url","URL","file","resolveAppFile","undefined","Response","net","pathToFileURL"],"mappings":";;;;AA2BO,SAASA,yBAAyBC,UAAiC,CAAC,CAAC;IAC1EC,SAAS,2BAA2B,CAAC;QACnC;YACE,QAAQD,QAAQ,MAAM,IAAIE;YAC1B,YAAY;gBACV,UAAU;gBACV,QAAQ;gBACR,iBAAiB;gBACjB,aAAa;gBACb,QAAQ;gBACR,WAAW;YACb;QACF;KACD;AACH;AAaO,SAASC,mBAAmBH,OAAkC;IACnE,MAAMI,SAASJ,QAAQ,MAAM,IAAIE;IACjC,MAAMG,OAAOL,QAAQ,IAAI,IAAIM;IAC7B,MAAMC,OAAOC,OAAO,WAAW,CAC7BA,OAAO,OAAO,CAACR,QAAQ,IAAI,EAAE,GAAG,CAAC,CAAC,CAACS,MAAMC,IAAI,GAAK;YAACC,QAAQF;YAAOC;SAAI;IAGxET,SAAS,MAAM,CAACG,QAAQ,OAAOQ;QAC7B,MAAMC,MAAM,IAAIC,IAAIF,QAAQ,GAAG;QAC/B,MAAMG,OAAOF,IAAI,IAAI,KAAKR,OAAOW,eAAeH,IAAI,QAAQ,EAAEN,QAAQU;QACtE,IAAI,CAACF,MAAM,OAAO,IAAIG,SAAS,aAAa;YAAE,QAAQ;QAAI;QAC1D,OAAOC,IAAI,KAAK,CAACC,cAAcL,MAAM,IAAI;IAC3C;IAEA,OAAO,IAAMd,SAAS,QAAQ,CAACG;AACjC"}
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * Electron main-process integration. Build configs should import the URL helpers\n * from `@module-federation/electron/rsbuild` or `/vite` instead: this entry imports `electron`.\n */\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport { app, net, protocol } from 'electron';\nimport {\n  createRemoteHandler,\n  isRemoteLocation,\n  resolveAppUrl,\n  type RemoteCacheOptions,\n} from './remote.ts';\nimport { resolveAppFile } from './resolve.ts';\nimport { DEFAULT_HOST, DEFAULT_SCHEME, toAppId } from './url.ts';\n\nexport { CACHE_HEADER, type RemoteCacheOptions } from './remote.ts';\nexport { resolveAppFile } from './resolve.ts';\nexport {\n  DEFAULT_HOST,\n  DEFAULT_SCHEME,\n  federationBaseUrl,\n  federationUrl,\n  toAppId,\n  type FederationUrlOptions,\n} from './url.ts';\n\nexport interface RegisterSchemeOptions {\n  scheme?: string;\n}\n\n/**\n * Registers the federation scheme as privileged (fetch, CORS, ESM, service workers).\n * Must be called before the `ready` event of `app`.\n */\nexport function registerFederationScheme(options: RegisterSchemeOptions = {}): void {\n  protocol.registerSchemesAsPrivileged([\n    {\n      scheme: options.scheme ?? DEFAULT_SCHEME,\n      privileges: {\n        standard: true,\n        secure: true,\n        supportFetchAPI: true,\n        corsEnabled: true,\n        stream: true,\n        codeCache: true,\n      },\n    },\n  ]);\n}\n\nexport interface ServeFederatedAppsOptions {\n  scheme?: string;\n  host?: string;\n  /**\n   * Map of federation `name` (or app id) to the directory holding its build output,\n   * or the http(s) URL it is deployed to.\n   */\n  apps: Record<string, string>;\n  /**\n   * Offline cache for apps served from a URL. Pass `false` to proxy them without caching.\n   * By default responses are cached in `<sessionData>/module-federation`.\n   */\n  cache?: false | Partial<RemoteCacheOptions>;\n}\n\n/**\n * Serves each app on `<scheme>://<host>/<appId>/`, from its build directory or from the\n * URL it is deployed to. Call after `app.whenReady()`. Returns a function that unregisters\n * the handler.\n */\nexport function serveFederatedApps(options: ServeFederatedAppsOptions): () => void {\n  const scheme = options.scheme ?? DEFAULT_SCHEME;\n  const host = options.host ?? DEFAULT_HOST;\n  const dirs: Record<string, string> = {};\n  const urls: Record<string, string> = {};\n  for (const [name, location] of Object.entries(options.apps)) {\n    (isRemoteLocation(location) ? urls : dirs)[toAppId(name)] = location;\n  }\n  const fetchRemote = createRemoteHandler({\n    fetch: (url, init) => net.fetch(url, init),\n    cache:\n      options.cache === false\n        ? false\n        : {\n            ...options.cache,\n            dir: options.cache?.dir ?? path.join(app.getPath('sessionData'), 'module-federation'),\n          },\n  });\n\n  protocol.handle(scheme, async (request) => {\n    const url = new URL(request.url);\n    if (url.host === host) {\n      const upstream = resolveAppUrl(url, urls);\n      if (upstream) return fetchRemote(request, upstream);\n      const file = resolveAppFile(url.pathname, dirs);\n      if (file) return net.fetch(pathToFileURL(file).href);\n    }\n    return new Response('Not found', { status: 404 });\n  });\n\n  return () => protocol.unhandle(scheme);\n}\n"],"names":["registerFederationScheme","options","protocol","DEFAULT_SCHEME","serveFederatedApps","scheme","host","DEFAULT_HOST","dirs","urls","name","location","Object","isRemoteLocation","toAppId","fetchRemote","createRemoteHandler","url","init","net","path","app","request","URL","upstream","resolveAppUrl","file","resolveAppFile","pathToFileURL","Response"],"mappings":";;;;;;AAmCO,SAASA,yBAAyBC,UAAiC,CAAC,CAAC;IAC1EC,SAAS,2BAA2B,CAAC;QACnC;YACE,QAAQD,QAAQ,MAAM,IAAIE;YAC1B,YAAY;gBACV,UAAU;gBACV,QAAQ;gBACR,iBAAiB;gBACjB,aAAa;gBACb,QAAQ;gBACR,WAAW;YACb;QACF;KACD;AACH;AAsBO,SAASC,mBAAmBH,OAAkC;IACnE,MAAMI,SAASJ,QAAQ,MAAM,IAAIE;IACjC,MAAMG,OAAOL,QAAQ,IAAI,IAAIM;IAC7B,MAAMC,OAA+B,CAAC;IACtC,MAAMC,OAA+B,CAAC;IACtC,KAAK,MAAM,CAACC,MAAMC,SAAS,IAAIC,OAAO,OAAO,CAACX,QAAQ,IAAI,EACvDY,AAAAA,CAAAA,iBAAiBF,YAAYF,OAAOD,IAAG,CAAE,CAACM,QAAQJ,MAAM,GAAGC;IAE9D,MAAMI,cAAcC,oBAAoB;QACtC,OAAO,CAACC,KAAKC,OAASC,IAAI,KAAK,CAACF,KAAKC;QACrC,OACEjB,AAAkB,UAAlBA,QAAQ,KAAK,GACT,QACA;YACE,GAAGA,QAAQ,KAAK;YAChB,KAAKA,QAAQ,KAAK,EAAE,OAAOmB,UAAAA,IAAS,CAACC,IAAI,OAAO,CAAC,gBAAgB;QACnE;IACR;IAEAnB,SAAS,MAAM,CAACG,QAAQ,OAAOiB;QAC7B,MAAML,MAAM,IAAIM,IAAID,QAAQ,GAAG;QAC/B,IAAIL,IAAI,IAAI,KAAKX,MAAM;YACrB,MAAMkB,WAAWC,cAAcR,KAAKR;YACpC,IAAIe,UAAU,OAAOT,YAAYO,SAASE;YAC1C,MAAME,OAAOC,eAAeV,IAAI,QAAQ,EAAET;YAC1C,IAAIkB,MAAM,OAAOP,IAAI,KAAK,CAACS,cAAcF,MAAM,IAAI;QACrD;QACA,OAAO,IAAIG,SAAS,aAAa;YAAE,QAAQ;QAAI;IACjD;IAEA,OAAO,IAAM3B,SAAS,QAAQ,CAACG;AACjC"}

package/dist/remote.cjs

@@ -0,0 +1,287 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    CACHE_HEADER: ()=>CACHE_HEADER,
+    UNREACHABLE_FOR_MS: ()=>UNREACHABLE_FOR_MS,
+    createRemoteHandler: ()=>createRemoteHandler,
+    isRemoteLocation: ()=>isRemoteLocation,
+    resolveAppUrl: ()=>resolveAppUrl
+});
+const external_node_crypto_namespaceObject = require("node:crypto");
+const promises_namespaceObject = require("node:fs/promises");
+const external_node_path_namespaceObject = require("node:path");
+var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
+const CACHE_HEADER = 'x-mf-cache';
+const UNREACHABLE_FOR_MS = 30000;
+const DEFAULT_TIMEOUT_MS = 10000;
+const DROPPED_HEADERS = new Set([
+    'connection',
+    'keep-alive',
+    'transfer-encoding',
+    'content-encoding',
+    'content-length',
+    'set-cookie'
+]);
+const FORWARDED_HEADERS = [
+    'accept',
+    'accept-language',
+    'content-type'
+];
+const NULL_BODY_STATUSES = new Set([
+    101,
+    103,
+    204,
+    205,
+    304
+]);
+function isRemoteLocation(location) {
+    return /^https?:\/\//i.test(location);
+}
+function resolveAppUrl(requestUrl, bases) {
+    const [, appId, ...rest] = requestUrl.pathname.split('/');
+    if (!appId || !Object.hasOwn(bases, appId)) return;
+    const base = new URL(bases[appId]);
+    base.search = '';
+    base.hash = '';
+    if (!base.pathname.endsWith('/')) base.pathname += '/';
+    const target = new URL(rest.join('/') + requestUrl.search, base);
+    if (target.origin !== base.origin || !target.pathname.startsWith(base.pathname)) return;
+    return target;
+}
+class FetchFailure extends Error {
+    timedOut;
+    constructor(message, timedOut){
+        super(message), this.timedOut = timedOut;
+    }
+}
+function createRemoteHandler(options) {
+    const { fetch, cache } = options;
+    const log = options.log ?? ((message)=>console.warn(`[module-federation] ${message}`));
+    const now = options.now ?? Date.now;
+    if (!cache) return (request, upstream)=>fetch(upstream.href, upstreamInit(request));
+    const connectTimeout = cache.connectTimeout ?? DEFAULT_TIMEOUT_MS;
+    const readTimeout = cache.readTimeout ?? DEFAULT_TIMEOUT_MS;
+    const unreachableSince = new Map();
+    const isUnreachable = (origin)=>{
+        const since = unreachableSince.get(origin);
+        return void 0 !== since && now() - since < UNREACHABLE_FOR_MS;
+    };
+    return async (request, upstream)=>{
+        const cacheable = 'GET' === request.method;
+        const file = cacheFile(cache.dir, upstream);
+        const stale = async (reason)=>{
+            if (!cacheable) return;
+            const cached = await readCached(file);
+            if (cached) log(`${upstream.href} ${reason}, serving the cached copy`);
+            return cached && toResponse(cached, 'stale');
+        };
+        if (cacheable && isUnreachable(upstream.origin)) {
+            const cached = await readCached(file);
+            if (cached) return toResponse(cached, 'stale');
+        }
+        let fetched;
+        try {
+            fetched = await fetchFully(fetch, upstream, request, connectTimeout, readTimeout);
+        } catch (error) {
+            unreachableSince.set(upstream.origin, now());
+            const failure = error instanceof FetchFailure ? error : new FetchFailure(String(error), false);
+            return await stale(`failed (${failure.message})`) ?? remote_text(failure.timedOut ? 504 : 502, `${upstream.href} failed (${failure.message}) and is not cached`);
+        }
+        unreachableSince.delete(upstream.origin);
+        if (fetched.status >= 200 && fetched.status < 300) {
+            if (cacheable) await writeCached(file, fetched).catch((error)=>log(`failed to cache ${upstream.href}: ${String(error)}`));
+            return toResponse(fetched);
+        }
+        return await stale(`answered ${fetched.status}`) ?? toResponse(fetched);
+    };
+}
+function upstreamInit(request) {
+    const headers = new Headers();
+    for (const name of FORWARDED_HEADERS){
+        const value = request.headers.get(name);
+        if (null !== value) headers.set(name, value);
+    }
+    const init = {
+        method: request.method,
+        headers
+    };
+    if (request.body && 'GET' !== request.method && 'HEAD' !== request.method) {
+        init.body = request.body;
+        init.duplex = 'half';
+    }
+    return init;
+}
+async function fetchFully(fetch, upstream, request, connectTimeout, readTimeout) {
+    const controller = new AbortController();
+    const response = await withTimeout(fetch(upstream.href, {
+        ...upstreamInit(request),
+        signal: controller.signal
+    }), connectTimeout, controller, 'no response');
+    const chunks = [];
+    const reader = response.body?.getReader();
+    if (reader) try {
+        for(;;){
+            const { done, value } = await withTimeout(reader.read(), readTimeout, controller, 'body stalled');
+            if (done) break;
+            chunks.push(value);
+        }
+    } catch (error) {
+        reader.cancel().catch(()=>{});
+        throw error;
+    }
+    return {
+        status: response.status,
+        headers: [
+            ...response.headers
+        ].filter(([name])=>!DROPPED_HEADERS.has(name.toLowerCase())),
+        body: concat(chunks)
+    };
+}
+function withTimeout(promise, ms, controller, what) {
+    let timer;
+    const timeout = new Promise((_, reject)=>{
+        timer = setTimeout(()=>{
+            reject(new FetchFailure(`${what} after ${ms} ms`, true));
+            controller.abort();
+        }, ms);
+    });
+    return Promise.race([
+        promise,
+        timeout
+    ]).catch((error)=>{
+        throw error instanceof FetchFailure ? error : new FetchFailure(errorMessage(error), false);
+    }).finally(()=>clearTimeout(timer));
+}
+function errorMessage(error) {
+    if (!(error instanceof Error)) return String(error);
+    return error.cause instanceof Error ? `${error.message}: ${error.cause.message}` : error.message;
+}
+function concat(chunks) {
+    const body = new Uint8Array(chunks.reduce((size, chunk)=>size + chunk.byteLength, 0));
+    let offset = 0;
+    for (const chunk of chunks){
+        body.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return body;
+}
+function sha1(value) {
+    return (0, external_node_crypto_namespaceObject.createHash)('sha1').update(value).digest('hex');
+}
+function cacheFile(dir, url) {
+    return external_node_path_default().join(dir, sha1(url.origin), sha1(url.pathname));
+}
+async function readCached(file) {
+    let data;
+    try {
+        data = await (0, promises_namespaceObject.readFile)(file);
+    } catch  {
+        return;
+    }
+    const newline = data.indexOf(0x0a);
+    if (newline < 0) return;
+    try {
+        const meta = JSON.parse(data.subarray(0, newline).toString('utf8'));
+        return {
+            status: meta.status,
+            headers: meta.headers,
+            body: data.subarray(newline + 1)
+        };
+    } catch  {
+        return;
+    }
+}
+let tmpCounter = 0;
+async function writeCached(file, fetched) {
+    await (0, promises_namespaceObject.mkdir)(external_node_path_default().dirname(file), {
+        recursive: true
+    });
+    const meta = JSON.stringify({
+        status: fetched.status,
+        headers: fetched.headers
+    });
+    const tmp = `${file}.tmp-${process.pid}-${tmpCounter++}`;
+    try {
+        await (0, promises_namespaceObject.writeFile)(tmp, Buffer.concat([
+            Buffer.from(`${meta}\n`),
+            fetched.body
+        ]));
+        await (0, promises_namespaceObject.rename)(tmp, file);
+    } catch (error) {
+        await (0, promises_namespaceObject.rm)(tmp, {
+            force: true
+        });
+        throw error;
+    }
+}
+function toResponse(fetched, fromCache) {
+    const headers = new Headers(fetched.headers);
+    if (fromCache) headers.set(CACHE_HEADER, fromCache);
+    const body = NULL_BODY_STATUSES.has(fetched.status) ? null : fetched.body;
+    return new Response(body, {
+        status: fetched.status,
+        headers
+    });
+}
+function remote_text(status, message) {
+    return new Response(message, {
+        status,
+        headers: {
+            'content-type': 'text/plain; charset=utf-8',
+            'cache-control': 'no-store'
+        }
+    });
+}
+exports.CACHE_HEADER = __webpack_exports__.CACHE_HEADER;
+exports.UNREACHABLE_FOR_MS = __webpack_exports__.UNREACHABLE_FOR_MS;
+exports.createRemoteHandler = __webpack_exports__.createRemoteHandler;
+exports.isRemoteLocation = __webpack_exports__.isRemoteLocation;
+exports.resolveAppUrl = __webpack_exports__.resolveAppUrl;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "CACHE_HEADER",
+    "UNREACHABLE_FOR_MS",
+    "createRemoteHandler",
+    "isRemoteLocation",
+    "resolveAppUrl"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});
+
+//# sourceMappingURL=remote.cjs.map

package/dist/remote.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.cjs","sources":["webpack://webpack/runtime/compat_get_default_export","webpack://webpack/runtime/define_property_getters","webpack://webpack/runtime/has_own_property","webpack://webpack/runtime/make_namespace_object","../src/remote.ts"],"sourcesContent":["// getDefaultExport function for compatibility with non-ESM modules\n__webpack_require__.n = (module) => {\n\tvar getter = module && module.__esModule ?\n\t\t() => (module['default']) :\n\t\t() => (module);\n\t__webpack_require__.d(getter, { a: getter });\n\treturn getter;\n};\n","__webpack_require__.d = (exports, getters, values) => {\n\tvar define = (defs, kind) => {\n\t\tfor(var key in defs) {\n\t\t\tif(__webpack_require__.o(defs, key) && !__webpack_require__.o(exports, key)) {\n\t\t\t\tObject.defineProperty(exports, key, { enumerable: true, [kind]: defs[key] });\n\t\t\t}\n\t\t}\n\t};\n\tdefine(getters, \"get\");\n\tdefine(values, \"value\");\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","/**\n * Serves apps deployed to an http(s) URL, with an on-disk cache that stands in for\n * the network when it fails. Must not import `electron`: the fetch function is\n * passed in, so this runs (and is tested) in plain Node.\n *\n * Cache layout, relative to the cache directory:\n *\n * ```text\n * <sha1(origin)>/<sha1(pathname)>   one JSON line with status and headers, then the body\n * ```\n */\nimport { createHash } from 'node:crypto';\nimport { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';\nimport path from 'node:path';\n\n/** Header added to responses served from the cache. */\nexport const CACHE_HEADER = 'x-mf-cache';\n\n/** How long an origin is skipped after a network failure, for requests that have a cached copy. */\nexport const UNREACHABLE_FOR_MS = 30_000;\n\nconst DEFAULT_TIMEOUT_MS = 10_000;\n\n/**\n * Headers not replayed from the upstream response: they describe the original connection,\n * an encoding the fetch already undid, or cookies that do not belong to the `mf://` origin.\n */\nconst DROPPED_HEADERS = new Set([\n  'connection',\n  'keep-alive',\n  'transfer-encoding',\n  'content-encoding',\n  'content-length',\n  'set-cookie',\n]);\n\n/** Request headers sent upstream. Conditional headers are left out: a 304 has no body to cache. */\nconst FORWARDED_HEADERS = ['accept', 'accept-language', 'content-type'];\n\nconst NULL_BODY_STATUSES = new Set([101, 103, 204, 205, 304]);\n\nexport type FetchFunction = (url: string, init: RequestInit) => Promise<Response>;\n\nexport interface RemoteCacheOptions {\n  /** Directory for cached responses. */\n  dir: string;\n  /** Milliseconds to wait for response headers. Default 10 000. */\n  connectTimeout?: number;\n  /** Milliseconds the body may stall between chunks. Not a limit on the total download. Default 10 000. */\n  readTimeout?: number;\n}\n\nexport interface RemoteHandlerOptions {\n  /** Performs the network request. In Electron, `net.fetch`. */\n  fetch: FetchFunction;\n  /** Offline cache settings, or `false` to proxy without caching or timeouts. */\n  cache: RemoteCacheOptions | false;\n  /** Receives fallbacks and cache write failures. Default `console.warn`. */\n  log?: (message: string) => void;\n  /** Clock, for tests. */\n  now?: () => number;\n}\n\n/** Fetches `upstream` on behalf of `request`, which is the `mf://` request it stands for. */\nexport type RemoteHandler = (request: Request, upstream: URL) => Promise<Response>;\n\n/** Whether an `apps` entry is a deployment URL rather than a directory. */\nexport function isRemoteLocation(location: string): boolean {\n  return /^https?:\\/\\//i.test(location);\n}\n\n/**\n * Maps a request URL (`<scheme>://<host>/<appId>/<path>?<query>`) to the matching URL\n * under the app's base URL. Returns `undefined` for unknown apps or for paths that would\n * leave the base URL.\n */\nexport function resolveAppUrl(\n  requestUrl: URL,\n  bases: Readonly<Record<string, string>>,\n): URL | undefined {\n  const [, appId, ...rest] = requestUrl.pathname.split('/');\n  if (!appId || !Object.hasOwn(bases, appId)) return undefined;\n\n  const base = new URL(bases[appId] as string);\n  base.search = '';\n  base.hash = '';\n  if (!base.pathname.endsWith('/')) base.pathname += '/';\n\n  const target = new URL(rest.join('/') + requestUrl.search, base);\n  if (target.origin !== base.origin || !target.pathname.startsWith(base.pathname)) return undefined;\n  return target;\n}\n\ninterface Fetched {\n  status: number;\n  headers: [string, string][];\n  body: Uint8Array;\n}\n\nclass FetchFailure extends Error {\n  constructor(\n    message: string,\n    readonly timedOut: boolean,\n  ) {\n    super(message);\n  }\n}\n\nexport function createRemoteHandler(options: RemoteHandlerOptions): RemoteHandler {\n  const { fetch, cache } = options;\n  const log = options.log ?? ((message: string) => console.warn(`[module-federation] ${message}`));\n  const now = options.now ?? Date.now;\n\n  if (!cache) {\n    return (request, upstream) => fetch(upstream.href, upstreamInit(request));\n  }\n\n  const connectTimeout = cache.connectTimeout ?? DEFAULT_TIMEOUT_MS;\n  const readTimeout = cache.readTimeout ?? DEFAULT_TIMEOUT_MS;\n  const unreachableSince = new Map<string, number>();\n  const isUnreachable = (origin: string) => {\n    const since = unreachableSince.get(origin);\n    return since !== undefined && now() - since < UNREACHABLE_FOR_MS;\n  };\n\n  return async (request, upstream) => {\n    const cacheable = request.method === 'GET';\n    const file = cacheFile(cache.dir, upstream);\n    const stale = async (reason: string) => {\n      if (!cacheable) return undefined;\n      const cached = await readCached(file);\n      if (cached) log(`${upstream.href} ${reason}, serving the cached copy`);\n      return cached && toResponse(cached, 'stale');\n    };\n\n    if (cacheable && isUnreachable(upstream.origin)) {\n      const cached = await readCached(file);\n      if (cached) return toResponse(cached, 'stale');\n    }\n\n    let fetched: Fetched;\n    try {\n      fetched = await fetchFully(fetch, upstream, request, connectTimeout, readTimeout);\n    } catch (error) {\n      unreachableSince.set(upstream.origin, now());\n      const failure =\n        error instanceof FetchFailure ? error : new FetchFailure(String(error), false);\n      return (\n        (await stale(`failed (${failure.message})`)) ??\n        text(\n          failure.timedOut ? 504 : 502,\n          `${upstream.href} failed (${failure.message}) and is not cached`,\n        )\n      );\n    }\n\n    unreachableSince.delete(upstream.origin);\n    if (fetched.status >= 200 && fetched.status < 300) {\n      if (cacheable) {\n        await writeCached(file, fetched).catch((error: unknown) =>\n          log(`failed to cache ${upstream.href}: ${String(error)}`),\n        );\n      }\n      return toResponse(fetched);\n    }\n    return (await stale(`answered ${fetched.status}`)) ?? toResponse(fetched);\n  };\n}\n\nfunction upstreamInit(request: Request): RequestInit {\n  const headers = new Headers();\n  for (const name of FORWARDED_HEADERS) {\n    const value = request.headers.get(name);\n    if (value !== null) headers.set(name, value);\n  }\n  const init: RequestInit & { duplex?: 'half' } = { method: request.method, headers };\n  if (request.body && request.method !== 'GET' && request.method !== 'HEAD') {\n    init.body = request.body;\n    init.duplex = 'half';\n  }\n  return init;\n}\n\n/**\n * Fetches the whole response. Throws a {@link FetchFailure} when the request fails, the\n * headers take longer than `connectTimeout`, the body stalls for `readTimeout`, or the\n * body fails halfway: a truncated response must not be cached as a success.\n */\nasync function fetchFully(\n  fetch: FetchFunction,\n  upstream: URL,\n  request: Request,\n  connectTimeout: number,\n  readTimeout: number,\n): Promise<Fetched> {\n  const controller = new AbortController();\n  const response = await withTimeout(\n    fetch(upstream.href, { ...upstreamInit(request), signal: controller.signal }),\n    connectTimeout,\n    controller,\n    'no response',\n  );\n\n  const chunks: Uint8Array[] = [];\n  const reader = response.body?.getReader();\n  if (reader) {\n    try {\n      for (;;) {\n        const { done, value } = await withTimeout(\n          reader.read(),\n          readTimeout,\n          controller,\n          'body stalled',\n        );\n        if (done) break;\n        chunks.push(value);\n      }\n    } catch (error) {\n      reader.cancel().catch(() => {});\n      throw error;\n    }\n  }\n\n  return {\n    status: response.status,\n    headers: [...response.headers].filter(([name]) => !DROPPED_HEADERS.has(name.toLowerCase())),\n    body: concat(chunks),\n  };\n}\n\nfunction withTimeout<T>(\n  promise: Promise<T>,\n  ms: number,\n  controller: AbortController,\n  what: string,\n): Promise<T> {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const timeout = new Promise<never>((_, reject) => {\n    timer = setTimeout(() => {\n      // Reject before aborting: the abort also rejects `promise`, and the race must\n      // settle with the timeout.\n      reject(new FetchFailure(`${what} after ${ms} ms`, true));\n      controller.abort();\n    }, ms);\n  });\n  return Promise.race([promise, timeout])\n    .catch((error: unknown) => {\n      throw error instanceof FetchFailure ? error : new FetchFailure(errorMessage(error), false);\n    })\n    .finally(() => clearTimeout(timer));\n}\n\nfunction errorMessage(error: unknown): string {\n  if (!(error instanceof Error)) return String(error);\n  // Node's fetch reports \"fetch failed\" and puts the reason in `cause`.\n  return error.cause instanceof Error ? `${error.message}: ${error.cause.message}` : error.message;\n}\n\nfunction concat(chunks: Uint8Array[]): Uint8Array {\n  const body = new Uint8Array(chunks.reduce((size, chunk) => size + chunk.byteLength, 0));\n  let offset = 0;\n  for (const chunk of chunks) {\n    body.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  return body;\n}\n\nfunction sha1(value: string): string {\n  return createHash('sha1').update(value).digest('hex');\n}\n\n/** The query string is not part of the key, so cache-busting parameters still hit the cache. */\nfunction cacheFile(dir: string, url: URL): string {\n  return path.join(dir, sha1(url.origin), sha1(url.pathname));\n}\n\nasync function readCached(file: string): Promise<Fetched | undefined> {\n  let data: Buffer;\n  try {\n    data = await readFile(file);\n  } catch {\n    return undefined;\n  }\n  const newline = data.indexOf(0x0a);\n  if (newline < 0) return undefined;\n  try {\n    const meta = JSON.parse(data.subarray(0, newline).toString('utf8')) as Omit<Fetched, 'body'>;\n    return { status: meta.status, headers: meta.headers, body: data.subarray(newline + 1) };\n  } catch {\n    return undefined;\n  }\n}\n\nlet tmpCounter = 0;\n\n/** Writes headers and body as one file through a rename, so a crash never leaves a mismatched pair. */\nasync function writeCached(file: string, fetched: Fetched): Promise<void> {\n  await mkdir(path.dirname(file), { recursive: true });\n  const meta = JSON.stringify({ status: fetched.status, headers: fetched.headers });\n  const tmp = `${file}.tmp-${process.pid}-${tmpCounter++}`;\n  try {\n    await writeFile(tmp, Buffer.concat([Buffer.from(`${meta}\\n`), fetched.body]));\n    await rename(tmp, file);\n  } catch (error) {\n    await rm(tmp, { force: true });\n    throw error;\n  }\n}\n\nfunction toResponse(fetched: Fetched, fromCache?: 'stale'): Response {\n  const headers = new Headers(fetched.headers);\n  if (fromCache) headers.set(CACHE_HEADER, fromCache);\n  const body = NULL_BODY_STATUSES.has(fetched.status) ? null : fetched.body;\n  return new Response(body, { status: fetched.status, headers });\n}\n\nfunction text(status: number, message: string): Response {\n  return new Response(message, {\n    status,\n    headers: { 'content-type': 'text/plain; charset=utf-8', 'cache-control': 'no-store' },\n  });\n}\n"],"names":["__webpack_require__","module","getter","getters","values","define","defs","kind","key","Object","obj","prop","Symbol","CACHE_HEADER","UNREACHABLE_FOR_MS","DEFAULT_TIMEOUT_MS","DROPPED_HEADERS","Set","FORWARDED_HEADERS","NULL_BODY_STATUSES","isRemoteLocation","location","resolveAppUrl","requestUrl","bases","appId","rest","base","URL","target","FetchFailure","Error","message","timedOut","createRemoteHandler","options","fetch","cache","log","console","now","Date","request","upstream","upstreamInit","connectTimeout","readTimeout","unreachableSince","Map","isUnreachable","origin","since","undefined","cacheable","file","cacheFile","stale","reason","cached","readCached","toResponse","fetched","fetchFully","error","failure","String","text","writeCached","headers","Headers","name","value","init","controller","AbortController","response","withTimeout","chunks","reader","done","concat","promise","ms","what","timer","timeout","Promise","_","reject","setTimeout","errorMessage","clearTimeout","body","Uint8Array","size","chunk","offset","sha1","createHash","dir","url","path","data","readFile","newline","meta","JSON","tmpCounter","mkdir","tmp","process","writeFile","Buffer","rename","rm","fromCache","Response","status"],"mappings":"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"}

package/dist/remote.d.cts

@@ -0,0 +1,35 @@
+/** Header added to responses served from the cache. */
+export declare const CACHE_HEADER = "x-mf-cache";
+/** How long an origin is skipped after a network failure, for requests that have a cached copy. */
+export declare const UNREACHABLE_FOR_MS = 30000;
+export type FetchFunction = (url: string, init: RequestInit) => Promise<Response>;
+export interface RemoteCacheOptions {
+    /** Directory for cached responses. */
+    dir: string;
+    /** Milliseconds to wait for response headers. Default 10 000. */
+    connectTimeout?: number;
+    /** Milliseconds the body may stall between chunks. Not a limit on the total download. Default 10 000. */
+    readTimeout?: number;
+}
+export interface RemoteHandlerOptions {
+    /** Performs the network request. In Electron, `net.fetch`. */
+    fetch: FetchFunction;
+    /** Offline cache settings, or `false` to proxy without caching or timeouts. */
+    cache: RemoteCacheOptions | false;
+    /** Receives fallbacks and cache write failures. Default `console.warn`. */
+    log?: (message: string) => void;
+    /** Clock, for tests. */
+    now?: () => number;
+}
+/** Fetches `upstream` on behalf of `request`, which is the `mf://` request it stands for. */
+export type RemoteHandler = (request: Request, upstream: URL) => Promise<Response>;
+/** Whether an `apps` entry is a deployment URL rather than a directory. */
+export declare function isRemoteLocation(location: string): boolean;
+/**
+ * Maps a request URL (`<scheme>://<host>/<appId>/<path>?<query>`) to the matching URL
+ * under the app's base URL. Returns `undefined` for unknown apps or for paths that would
+ * leave the base URL.
+ */
+export declare function resolveAppUrl(requestUrl: URL, bases: Readonly<Record<string, string>>): URL | undefined;
+export declare function createRemoteHandler(options: RemoteHandlerOptions): RemoteHandler;
+//# sourceMappingURL=remote.d.cts.map

package/dist/remote.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.cts","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"AAeA,uDAAuD;AACvD,eAAO,MAAM,YAAY,eAAe,CAAC;AAEzC,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAsBzC,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAElF,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yGAAyG;IACzG,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,KAAK,EAAE,aAAa,CAAC;IACrB,+EAA+E;IAC/E,KAAK,EAAE,kBAAkB,GAAG,KAAK,CAAC;IAClC,2EAA2E;IAC3E,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,6FAA6F;AAC7F,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEnF,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,GAAG,EACf,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACtC,GAAG,GAAG,SAAS,CAYjB;AAiBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA2DhF"}

package/dist/remote.d.ts

@@ -0,0 +1,35 @@
+/** Header added to responses served from the cache. */
+export declare const CACHE_HEADER = "x-mf-cache";
+/** How long an origin is skipped after a network failure, for requests that have a cached copy. */
+export declare const UNREACHABLE_FOR_MS = 30000;
+export type FetchFunction = (url: string, init: RequestInit) => Promise<Response>;
+export interface RemoteCacheOptions {
+    /** Directory for cached responses. */
+    dir: string;
+    /** Milliseconds to wait for response headers. Default 10 000. */
+    connectTimeout?: number;
+    /** Milliseconds the body may stall between chunks. Not a limit on the total download. Default 10 000. */
+    readTimeout?: number;
+}
+export interface RemoteHandlerOptions {
+    /** Performs the network request. In Electron, `net.fetch`. */
+    fetch: FetchFunction;
+    /** Offline cache settings, or `false` to proxy without caching or timeouts. */
+    cache: RemoteCacheOptions | false;
+    /** Receives fallbacks and cache write failures. Default `console.warn`. */
+    log?: (message: string) => void;
+    /** Clock, for tests. */
+    now?: () => number;
+}
+/** Fetches `upstream` on behalf of `request`, which is the `mf://` request it stands for. */
+export type RemoteHandler = (request: Request, upstream: URL) => Promise<Response>;
+/** Whether an `apps` entry is a deployment URL rather than a directory. */
+export declare function isRemoteLocation(location: string): boolean;
+/**
+ * Maps a request URL (`<scheme>://<host>/<appId>/<path>?<query>`) to the matching URL
+ * under the app's base URL. Returns `undefined` for unknown apps or for paths that would
+ * leave the base URL.
+ */
+export declare function resolveAppUrl(requestUrl: URL, bases: Readonly<Record<string, string>>): URL | undefined;
+export declare function createRemoteHandler(options: RemoteHandlerOptions): RemoteHandler;
+//# sourceMappingURL=remote.d.ts.map

package/dist/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"AAeA,uDAAuD;AACvD,eAAO,MAAM,YAAY,eAAe,CAAC;AAEzC,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAsBzC,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAElF,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yGAAyG;IACzG,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,KAAK,EAAE,aAAa,CAAC;IACrB,+EAA+E;IAC/E,KAAK,EAAE,kBAAkB,GAAG,KAAK,CAAC;IAClC,2EAA2E;IAC3E,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,6FAA6F;AAC7F,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEnF,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,GAAG,EACf,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACtC,GAAG,GAAG,SAAS,CAYjB;AAiBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA2DhF"}

package/dist/remote.js

@@ -0,0 +1,227 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import node_path from "node:path";
+const CACHE_HEADER = 'x-mf-cache';
+const UNREACHABLE_FOR_MS = 30000;
+const DEFAULT_TIMEOUT_MS = 10000;
+const DROPPED_HEADERS = new Set([
+    'connection',
+    'keep-alive',
+    'transfer-encoding',
+    'content-encoding',
+    'content-length',
+    'set-cookie'
+]);
+const FORWARDED_HEADERS = [
+    'accept',
+    'accept-language',
+    'content-type'
+];
+const NULL_BODY_STATUSES = new Set([
+    101,
+    103,
+    204,
+    205,
+    304
+]);
+function isRemoteLocation(location) {
+    return /^https?:\/\//i.test(location);
+}
+function resolveAppUrl(requestUrl, bases) {
+    const [, appId, ...rest] = requestUrl.pathname.split('/');
+    if (!appId || !Object.hasOwn(bases, appId)) return;
+    const base = new URL(bases[appId]);
+    base.search = '';
+    base.hash = '';
+    if (!base.pathname.endsWith('/')) base.pathname += '/';
+    const target = new URL(rest.join('/') + requestUrl.search, base);
+    if (target.origin !== base.origin || !target.pathname.startsWith(base.pathname)) return;
+    return target;
+}
+class FetchFailure extends Error {
+    timedOut;
+    constructor(message, timedOut){
+        super(message), this.timedOut = timedOut;
+    }
+}
+function createRemoteHandler(options) {
+    const { fetch, cache } = options;
+    const log = options.log ?? ((message)=>console.warn(`[module-federation] ${message}`));
+    const now = options.now ?? Date.now;
+    if (!cache) return (request, upstream)=>fetch(upstream.href, upstreamInit(request));
+    const connectTimeout = cache.connectTimeout ?? DEFAULT_TIMEOUT_MS;
+    const readTimeout = cache.readTimeout ?? DEFAULT_TIMEOUT_MS;
+    const unreachableSince = new Map();
+    const isUnreachable = (origin)=>{
+        const since = unreachableSince.get(origin);
+        return void 0 !== since && now() - since < UNREACHABLE_FOR_MS;
+    };
+    return async (request, upstream)=>{
+        const cacheable = 'GET' === request.method;
+        const file = cacheFile(cache.dir, upstream);
+        const stale = async (reason)=>{
+            if (!cacheable) return;
+            const cached = await readCached(file);
+            if (cached) log(`${upstream.href} ${reason}, serving the cached copy`);
+            return cached && toResponse(cached, 'stale');
+        };
+        if (cacheable && isUnreachable(upstream.origin)) {
+            const cached = await readCached(file);
+            if (cached) return toResponse(cached, 'stale');
+        }
+        let fetched;
+        try {
+            fetched = await fetchFully(fetch, upstream, request, connectTimeout, readTimeout);
+        } catch (error) {
+            unreachableSince.set(upstream.origin, now());
+            const failure = error instanceof FetchFailure ? error : new FetchFailure(String(error), false);
+            return await stale(`failed (${failure.message})`) ?? remote_text(failure.timedOut ? 504 : 502, `${upstream.href} failed (${failure.message}) and is not cached`);
+        }
+        unreachableSince.delete(upstream.origin);
+        if (fetched.status >= 200 && fetched.status < 300) {
+            if (cacheable) await writeCached(file, fetched).catch((error)=>log(`failed to cache ${upstream.href}: ${String(error)}`));
+            return toResponse(fetched);
+        }
+        return await stale(`answered ${fetched.status}`) ?? toResponse(fetched);
+    };
+}
+function upstreamInit(request) {
+    const headers = new Headers();
+    for (const name of FORWARDED_HEADERS){
+        const value = request.headers.get(name);
+        if (null !== value) headers.set(name, value);
+    }
+    const init = {
+        method: request.method,
+        headers
+    };
+    if (request.body && 'GET' !== request.method && 'HEAD' !== request.method) {
+        init.body = request.body;
+        init.duplex = 'half';
+    }
+    return init;
+}
+async function fetchFully(fetch, upstream, request, connectTimeout, readTimeout) {
+    const controller = new AbortController();
+    const response = await withTimeout(fetch(upstream.href, {
+        ...upstreamInit(request),
+        signal: controller.signal
+    }), connectTimeout, controller, 'no response');
+    const chunks = [];
+    const reader = response.body?.getReader();
+    if (reader) try {
+        for(;;){
+            const { done, value } = await withTimeout(reader.read(), readTimeout, controller, 'body stalled');
+            if (done) break;
+            chunks.push(value);
+        }
+    } catch (error) {
+        reader.cancel().catch(()=>{});
+        throw error;
+    }
+    return {
+        status: response.status,
+        headers: [
+            ...response.headers
+        ].filter(([name])=>!DROPPED_HEADERS.has(name.toLowerCase())),
+        body: concat(chunks)
+    };
+}
+function withTimeout(promise, ms, controller, what) {
+    let timer;
+    const timeout = new Promise((_, reject)=>{
+        timer = setTimeout(()=>{
+            reject(new FetchFailure(`${what} after ${ms} ms`, true));
+            controller.abort();
+        }, ms);
+    });
+    return Promise.race([
+        promise,
+        timeout
+    ]).catch((error)=>{
+        throw error instanceof FetchFailure ? error : new FetchFailure(errorMessage(error), false);
+    }).finally(()=>clearTimeout(timer));
+}
+function errorMessage(error) {
+    if (!(error instanceof Error)) return String(error);
+    return error.cause instanceof Error ? `${error.message}: ${error.cause.message}` : error.message;
+}
+function concat(chunks) {
+    const body = new Uint8Array(chunks.reduce((size, chunk)=>size + chunk.byteLength, 0));
+    let offset = 0;
+    for (const chunk of chunks){
+        body.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return body;
+}
+function sha1(value) {
+    return createHash('sha1').update(value).digest('hex');
+}
+function cacheFile(dir, url) {
+    return node_path.join(dir, sha1(url.origin), sha1(url.pathname));
+}
+async function readCached(file) {
+    let data;
+    try {
+        data = await readFile(file);
+    } catch  {
+        return;
+    }
+    const newline = data.indexOf(0x0a);
+    if (newline < 0) return;
+    try {
+        const meta = JSON.parse(data.subarray(0, newline).toString('utf8'));
+        return {
+            status: meta.status,
+            headers: meta.headers,
+            body: data.subarray(newline + 1)
+        };
+    } catch  {
+        return;
+    }
+}
+let tmpCounter = 0;
+async function writeCached(file, fetched) {
+    await mkdir(node_path.dirname(file), {
+        recursive: true
+    });
+    const meta = JSON.stringify({
+        status: fetched.status,
+        headers: fetched.headers
+    });
+    const tmp = `${file}.tmp-${process.pid}-${tmpCounter++}`;
+    try {
+        await writeFile(tmp, Buffer.concat([
+            Buffer.from(`${meta}\n`),
+            fetched.body
+        ]));
+        await rename(tmp, file);
+    } catch (error) {
+        await rm(tmp, {
+            force: true
+        });
+        throw error;
+    }
+}
+function toResponse(fetched, fromCache) {
+    const headers = new Headers(fetched.headers);
+    if (fromCache) headers.set(CACHE_HEADER, fromCache);
+    const body = NULL_BODY_STATUSES.has(fetched.status) ? null : fetched.body;
+    return new Response(body, {
+        status: fetched.status,
+        headers
+    });
+}
+function remote_text(status, message) {
+    return new Response(message, {
+        status,
+        headers: {
+            'content-type': 'text/plain; charset=utf-8',
+            'cache-control': 'no-store'
+        }
+    });
+}
+export { CACHE_HEADER, UNREACHABLE_FOR_MS, createRemoteHandler, isRemoteLocation, resolveAppUrl };
+
+//# sourceMappingURL=remote.js.map

package/dist/remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.js","sources":["../src/remote.ts"],"sourcesContent":["/**\n * Serves apps deployed to an http(s) URL, with an on-disk cache that stands in for\n * the network when it fails. Must not import `electron`: the fetch function is\n * passed in, so this runs (and is tested) in plain Node.\n *\n * Cache layout, relative to the cache directory:\n *\n * ```text\n * <sha1(origin)>/<sha1(pathname)>   one JSON line with status and headers, then the body\n * ```\n */\nimport { createHash } from 'node:crypto';\nimport { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';\nimport path from 'node:path';\n\n/** Header added to responses served from the cache. */\nexport const CACHE_HEADER = 'x-mf-cache';\n\n/** How long an origin is skipped after a network failure, for requests that have a cached copy. */\nexport const UNREACHABLE_FOR_MS = 30_000;\n\nconst DEFAULT_TIMEOUT_MS = 10_000;\n\n/**\n * Headers not replayed from the upstream response: they describe the original connection,\n * an encoding the fetch already undid, or cookies that do not belong to the `mf://` origin.\n */\nconst DROPPED_HEADERS = new Set([\n  'connection',\n  'keep-alive',\n  'transfer-encoding',\n  'content-encoding',\n  'content-length',\n  'set-cookie',\n]);\n\n/** Request headers sent upstream. Conditional headers are left out: a 304 has no body to cache. */\nconst FORWARDED_HEADERS = ['accept', 'accept-language', 'content-type'];\n\nconst NULL_BODY_STATUSES = new Set([101, 103, 204, 205, 304]);\n\nexport type FetchFunction = (url: string, init: RequestInit) => Promise<Response>;\n\nexport interface RemoteCacheOptions {\n  /** Directory for cached responses. */\n  dir: string;\n  /** Milliseconds to wait for response headers. Default 10 000. */\n  connectTimeout?: number;\n  /** Milliseconds the body may stall between chunks. Not a limit on the total download. Default 10 000. */\n  readTimeout?: number;\n}\n\nexport interface RemoteHandlerOptions {\n  /** Performs the network request. In Electron, `net.fetch`. */\n  fetch: FetchFunction;\n  /** Offline cache settings, or `false` to proxy without caching or timeouts. */\n  cache: RemoteCacheOptions | false;\n  /** Receives fallbacks and cache write failures. Default `console.warn`. */\n  log?: (message: string) => void;\n  /** Clock, for tests. */\n  now?: () => number;\n}\n\n/** Fetches `upstream` on behalf of `request`, which is the `mf://` request it stands for. */\nexport type RemoteHandler = (request: Request, upstream: URL) => Promise<Response>;\n\n/** Whether an `apps` entry is a deployment URL rather than a directory. */\nexport function isRemoteLocation(location: string): boolean {\n  return /^https?:\\/\\//i.test(location);\n}\n\n/**\n * Maps a request URL (`<scheme>://<host>/<appId>/<path>?<query>`) to the matching URL\n * under the app's base URL. Returns `undefined` for unknown apps or for paths that would\n * leave the base URL.\n */\nexport function resolveAppUrl(\n  requestUrl: URL,\n  bases: Readonly<Record<string, string>>,\n): URL | undefined {\n  const [, appId, ...rest] = requestUrl.pathname.split('/');\n  if (!appId || !Object.hasOwn(bases, appId)) return undefined;\n\n  const base = new URL(bases[appId] as string);\n  base.search = '';\n  base.hash = '';\n  if (!base.pathname.endsWith('/')) base.pathname += '/';\n\n  const target = new URL(rest.join('/') + requestUrl.search, base);\n  if (target.origin !== base.origin || !target.pathname.startsWith(base.pathname)) return undefined;\n  return target;\n}\n\ninterface Fetched {\n  status: number;\n  headers: [string, string][];\n  body: Uint8Array;\n}\n\nclass FetchFailure extends Error {\n  constructor(\n    message: string,\n    readonly timedOut: boolean,\n  ) {\n    super(message);\n  }\n}\n\nexport function createRemoteHandler(options: RemoteHandlerOptions): RemoteHandler {\n  const { fetch, cache } = options;\n  const log = options.log ?? ((message: string) => console.warn(`[module-federation] ${message}`));\n  const now = options.now ?? Date.now;\n\n  if (!cache) {\n    return (request, upstream) => fetch(upstream.href, upstreamInit(request));\n  }\n\n  const connectTimeout = cache.connectTimeout ?? DEFAULT_TIMEOUT_MS;\n  const readTimeout = cache.readTimeout ?? DEFAULT_TIMEOUT_MS;\n  const unreachableSince = new Map<string, number>();\n  const isUnreachable = (origin: string) => {\n    const since = unreachableSince.get(origin);\n    return since !== undefined && now() - since < UNREACHABLE_FOR_MS;\n  };\n\n  return async (request, upstream) => {\n    const cacheable = request.method === 'GET';\n    const file = cacheFile(cache.dir, upstream);\n    const stale = async (reason: string) => {\n      if (!cacheable) return undefined;\n      const cached = await readCached(file);\n      if (cached) log(`${upstream.href} ${reason}, serving the cached copy`);\n      return cached && toResponse(cached, 'stale');\n    };\n\n    if (cacheable && isUnreachable(upstream.origin)) {\n      const cached = await readCached(file);\n      if (cached) return toResponse(cached, 'stale');\n    }\n\n    let fetched: Fetched;\n    try {\n      fetched = await fetchFully(fetch, upstream, request, connectTimeout, readTimeout);\n    } catch (error) {\n      unreachableSince.set(upstream.origin, now());\n      const failure =\n        error instanceof FetchFailure ? error : new FetchFailure(String(error), false);\n      return (\n        (await stale(`failed (${failure.message})`)) ??\n        text(\n          failure.timedOut ? 504 : 502,\n          `${upstream.href} failed (${failure.message}) and is not cached`,\n        )\n      );\n    }\n\n    unreachableSince.delete(upstream.origin);\n    if (fetched.status >= 200 && fetched.status < 300) {\n      if (cacheable) {\n        await writeCached(file, fetched).catch((error: unknown) =>\n          log(`failed to cache ${upstream.href}: ${String(error)}`),\n        );\n      }\n      return toResponse(fetched);\n    }\n    return (await stale(`answered ${fetched.status}`)) ?? toResponse(fetched);\n  };\n}\n\nfunction upstreamInit(request: Request): RequestInit {\n  const headers = new Headers();\n  for (const name of FORWARDED_HEADERS) {\n    const value = request.headers.get(name);\n    if (value !== null) headers.set(name, value);\n  }\n  const init: RequestInit & { duplex?: 'half' } = { method: request.method, headers };\n  if (request.body && request.method !== 'GET' && request.method !== 'HEAD') {\n    init.body = request.body;\n    init.duplex = 'half';\n  }\n  return init;\n}\n\n/**\n * Fetches the whole response. Throws a {@link FetchFailure} when the request fails, the\n * headers take longer than `connectTimeout`, the body stalls for `readTimeout`, or the\n * body fails halfway: a truncated response must not be cached as a success.\n */\nasync function fetchFully(\n  fetch: FetchFunction,\n  upstream: URL,\n  request: Request,\n  connectTimeout: number,\n  readTimeout: number,\n): Promise<Fetched> {\n  const controller = new AbortController();\n  const response = await withTimeout(\n    fetch(upstream.href, { ...upstreamInit(request), signal: controller.signal }),\n    connectTimeout,\n    controller,\n    'no response',\n  );\n\n  const chunks: Uint8Array[] = [];\n  const reader = response.body?.getReader();\n  if (reader) {\n    try {\n      for (;;) {\n        const { done, value } = await withTimeout(\n          reader.read(),\n          readTimeout,\n          controller,\n          'body stalled',\n        );\n        if (done) break;\n        chunks.push(value);\n      }\n    } catch (error) {\n      reader.cancel().catch(() => {});\n      throw error;\n    }\n  }\n\n  return {\n    status: response.status,\n    headers: [...response.headers].filter(([name]) => !DROPPED_HEADERS.has(name.toLowerCase())),\n    body: concat(chunks),\n  };\n}\n\nfunction withTimeout<T>(\n  promise: Promise<T>,\n  ms: number,\n  controller: AbortController,\n  what: string,\n): Promise<T> {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const timeout = new Promise<never>((_, reject) => {\n    timer = setTimeout(() => {\n      // Reject before aborting: the abort also rejects `promise`, and the race must\n      // settle with the timeout.\n      reject(new FetchFailure(`${what} after ${ms} ms`, true));\n      controller.abort();\n    }, ms);\n  });\n  return Promise.race([promise, timeout])\n    .catch((error: unknown) => {\n      throw error instanceof FetchFailure ? error : new FetchFailure(errorMessage(error), false);\n    })\n    .finally(() => clearTimeout(timer));\n}\n\nfunction errorMessage(error: unknown): string {\n  if (!(error instanceof Error)) return String(error);\n  // Node's fetch reports \"fetch failed\" and puts the reason in `cause`.\n  return error.cause instanceof Error ? `${error.message}: ${error.cause.message}` : error.message;\n}\n\nfunction concat(chunks: Uint8Array[]): Uint8Array {\n  const body = new Uint8Array(chunks.reduce((size, chunk) => size + chunk.byteLength, 0));\n  let offset = 0;\n  for (const chunk of chunks) {\n    body.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  return body;\n}\n\nfunction sha1(value: string): string {\n  return createHash('sha1').update(value).digest('hex');\n}\n\n/** The query string is not part of the key, so cache-busting parameters still hit the cache. */\nfunction cacheFile(dir: string, url: URL): string {\n  return path.join(dir, sha1(url.origin), sha1(url.pathname));\n}\n\nasync function readCached(file: string): Promise<Fetched | undefined> {\n  let data: Buffer;\n  try {\n    data = await readFile(file);\n  } catch {\n    return undefined;\n  }\n  const newline = data.indexOf(0x0a);\n  if (newline < 0) return undefined;\n  try {\n    const meta = JSON.parse(data.subarray(0, newline).toString('utf8')) as Omit<Fetched, 'body'>;\n    return { status: meta.status, headers: meta.headers, body: data.subarray(newline + 1) };\n  } catch {\n    return undefined;\n  }\n}\n\nlet tmpCounter = 0;\n\n/** Writes headers and body as one file through a rename, so a crash never leaves a mismatched pair. */\nasync function writeCached(file: string, fetched: Fetched): Promise<void> {\n  await mkdir(path.dirname(file), { recursive: true });\n  const meta = JSON.stringify({ status: fetched.status, headers: fetched.headers });\n  const tmp = `${file}.tmp-${process.pid}-${tmpCounter++}`;\n  try {\n    await writeFile(tmp, Buffer.concat([Buffer.from(`${meta}\\n`), fetched.body]));\n    await rename(tmp, file);\n  } catch (error) {\n    await rm(tmp, { force: true });\n    throw error;\n  }\n}\n\nfunction toResponse(fetched: Fetched, fromCache?: 'stale'): Response {\n  const headers = new Headers(fetched.headers);\n  if (fromCache) headers.set(CACHE_HEADER, fromCache);\n  const body = NULL_BODY_STATUSES.has(fetched.status) ? null : fetched.body;\n  return new Response(body, { status: fetched.status, headers });\n}\n\nfunction text(status: number, message: string): Response {\n  return new Response(message, {\n    status,\n    headers: { 'content-type': 'text/plain; charset=utf-8', 'cache-control': 'no-store' },\n  });\n}\n"],"names":["CACHE_HEADER","UNREACHABLE_FOR_MS","DEFAULT_TIMEOUT_MS","DROPPED_HEADERS","Set","FORWARDED_HEADERS","NULL_BODY_STATUSES","isRemoteLocation","location","resolveAppUrl","requestUrl","bases","appId","rest","Object","base","URL","target","FetchFailure","Error","message","timedOut","createRemoteHandler","options","fetch","cache","log","console","now","Date","request","upstream","upstreamInit","connectTimeout","readTimeout","unreachableSince","Map","isUnreachable","origin","since","undefined","cacheable","file","cacheFile","stale","reason","cached","readCached","toResponse","fetched","fetchFully","error","failure","String","text","writeCached","headers","Headers","name","value","init","controller","AbortController","response","withTimeout","chunks","reader","done","concat","promise","ms","what","timer","timeout","Promise","_","reject","setTimeout","errorMessage","clearTimeout","body","Uint8Array","size","chunk","offset","sha1","createHash","dir","url","path","data","readFile","newline","meta","JSON","tmpCounter","mkdir","tmp","process","writeFile","Buffer","rename","rm","fromCache","Response","status"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@module-federation/electron",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Module Federation for Electron renderers built with Rsbuild or Vite",
   "keywords": [
     "electron",