@backstage/frontend-dynamic-feature-loader 0.0.0-nightly-20250425023938

package/CHANGELOG.md

@@ -0,0 +1,24 @@
+# @backstage/frontend-dynamic-feature-loader
+
+## 0.0.0-nightly-20250425023938
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/frontend-plugin-api@0.0.0-nightly-20250425023938
+  - @backstage/config@1.3.2
+
+## 0.1.0
+
+### Minor Changes
+
+- 3bee3c3: The new package `frontend-dynamic-features-loader` provides a frontend feature loader that dynamically
+  loads frontend features based on the new frontend system and exposed as module federation remotes.
+  This new frontend feature loader works hand-in-hand with a new server of frontend plugin module federation
+  remotes, which is added as part of backend dynamic feature service in package `@backstage/backend-dynamic-feature-service`.
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/frontend-plugin-api@0.10.1
+  - @backstage/config@1.3.2

package/README.md

@@ -0,0 +1,32 @@
+# @backstage/frontend-dynamic-feature-loader
+
+Backstage frontend feature loader to load new frontend system plugins exposed as module federation remotes.
+The frontend feature loader provided in this package works hand-in-hand with the server of frontend plugin module federation remotes server which is part of backend dynamic feature service in package `@backstage/backend-dynamic-feature-service`.
+
+**NOTE: The [new frontend system](https://backstage.io/docs/frontend-system/) that this package is relaying upon is in alpha, and we do not yet recommend using it for production deployments**
+
+## Usage
+
+- To enable this loader, you should:
+
+  - Enable the backend dynamic features in your backend application, as explained in the [`backend-dynamic-feature-service` README.md file](../backend-dynamic-feature-service/README.md#how-it-works)
+  - Add the frontend feature loader to the list of features when creating the frontend application:
+
+    ```typescript
+    const app = createApp({
+      features: [...someOtherFeatures, dynamicFrontendFeaturesLoader()],
+    });
+    ```
+
+## How to add a frontend plugin for dynamic loading
+
+Adding a frontend plugin (with new frontend system support, possibly in alpha support), is straightforward and consists in:
+
+- building the frontend plugin with the `frontend-dynamic-container` role, which enables the module federation support, and packages the plugin as a module remote
+- copying the frontend package folder, with the `dist` folder generated during the build, to the dynamic plugins root folder of the Backstage installation (defined by the `dynamicPlugins.rootDirectory` configuration value, which is usually set as `dynamic-plugins-root`).
+
+So from a frontend plugin package folder, you would use the following command:
+
+```bash
+yarn build --role frontend-dynamic-container && cp -R $(pwd) <target backstage>/dynamic-plugins-root/
+```

package/config.d.ts

@@ -0,0 +1,22 @@
+/*
+ * Copyright 2024 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export interface Config {
+  /**
+   * @visibility frontend
+   */
+  dynamicPlugins?: {};
+}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { FederationRuntimePlugin } from '@module-federation/enhanced/runtime';
+import { FrontendFeatureLoader } from '@backstage/frontend-plugin-api';
+import { UserOptions, ShareStrategy } from '@module-federation/runtime/types';
+
+/**
+ *
+ * @public
+ */
+type DynamicFrontendFeaturesLoaderOptions = {
+    /**
+     * Additional module federation arguments for the Module Federation runtime initialization.
+     */
+    moduleFederation: {
+        shared?: UserOptions['shared'];
+        shareStrategy?: ShareStrategy;
+        plugins?: Array<FederationRuntimePlugin>;
+    };
+};
+/**
+ * A function providing a loader of frontend features exposed as module federation remotes
+ * from the backend dynamic features service.
+ *
+ * @public
+ */
+declare function dynamicFrontendFeaturesLoader(options?: DynamicFrontendFeaturesLoaderOptions): FrontendFeatureLoader;
+
+export { type DynamicFrontendFeaturesLoaderOptions, dynamicFrontendFeaturesLoader };

package/dist/index.esm.js

@@ -0,0 +1,2 @@
+export { dynamicFrontendFeaturesLoader } from './loader.esm.js';
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/loader.esm.js

@@ -0,0 +1,108 @@
+import { init, loadRemote } from '@module-federation/enhanced/runtime';
+import { DefaultApiClient } from './schema/openapi/generated/apis/Api.client.esm.js';
+import { createFrontendFeatureLoader } from '@backstage/frontend-plugin-api';
+
+function dynamicFrontendFeaturesLoader(options) {
+  return createFrontendFeatureLoader({
+    async loader({ config }) {
+      const dynamicPLuginsConfig = config.getOptionalConfig("dynamicPlugins");
+      if (!dynamicPLuginsConfig) {
+        return [];
+      }
+      function error(message, err) {
+        console.error(
+          `${message}: ${err instanceof Error ? err.toString() : JSON.stringify(err)}`
+        );
+      }
+      const backendBaseUrl = config.getString("backend.baseUrl");
+      const appPackageName = config.getOptionalString("app.packageName") ?? "app";
+      let frontendPluginRemotes;
+      try {
+        const apiClient = new DefaultApiClient({
+          discoveryApi: {
+            getBaseUrl: async (rootPath) => `${backendBaseUrl}/${rootPath}`
+          },
+          fetchApi: {
+            fetch(input) {
+              return global.fetch(input);
+            }
+          }
+        });
+        const response = await apiClient.getRemotes({});
+        if (!response.ok) {
+          throw new Error(`${response.status} - ${response.statusText}`);
+        }
+        frontendPluginRemotes = await response.json();
+      } catch (err) {
+        error(
+          `Failed fetching module federation configuration of dynamic frontend plugins`,
+          err
+        );
+        return [];
+      }
+      try {
+        init({
+          ...options?.moduleFederation,
+          name: appPackageName.replaceAll("@", "").replaceAll("/", "__").replaceAll("-", "_"),
+          remotes: frontendPluginRemotes.map((remote) => ({
+            alias: remote.packageName,
+            ...remote.remoteInfo
+          }))
+        });
+      } catch (err) {
+        error(`Failed initializing module federation`, err);
+        return [];
+      }
+      const features = (await Promise.all(
+        frontendPluginRemotes.map(async (remote) => {
+          console.debug(
+            `Loading dynamic plugin '${remote.packageName}' from '${remote.remoteInfo.entry}'`
+          );
+          const moduleFeatures = await Promise.all(
+            remote.exposedModules.map(async (exposedModuleName) => {
+              const remoteModuleName = exposedModuleName === "." ? remote.remoteInfo.name : `${remote.remoteInfo.name}/${exposedModuleName}`;
+              let module;
+              try {
+                module = await loadRemote(remoteModuleName);
+              } catch (err) {
+                error(
+                  `Failed loading remote module '${remoteModuleName}' of dynamic plugin '${remote.packageName}'`,
+                  err
+                );
+                return void 0;
+              }
+              if (!module) {
+                console.warn(
+                  `Skipping empty dynamic plugin remote module '${remoteModuleName}'.`
+                );
+                return void 0;
+              }
+              console.info(
+                `Remote module '${remoteModuleName}' of dynamic plugin '${remote.packageName}' loaded from ${remote.remoteInfo.entry}`
+              );
+              const defaultEntry = module.default;
+              if (!isLoadable(defaultEntry)) {
+                console.debug(
+                  `Skipping dynamic plugin remote module '${remote}' since it doesn't export a new 'FrontendFeature' as default export.`
+                );
+                return void 0;
+              }
+              return defaultEntry;
+            })
+          );
+          return moduleFeatures;
+        })
+      )).flat().filter((feature) => feature !== void 0);
+      return [...features];
+    }
+  });
+}
+function isLoadable(obj) {
+  if (obj !== null && typeof obj === "object" && "$$type" in obj) {
+    return obj.$$type === "@backstage/FrontendPlugin" || obj.$$type === "@backstage/FrontendModule";
+  }
+  return false;
+}
+
+export { dynamicFrontendFeaturesLoader };
+//# sourceMappingURL=loader.esm.js.map

package/dist/loader.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.esm.js","sources":["../src/loader.ts"],"sourcesContent":["/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  FederationRuntimePlugin,\n  init,\n  loadRemote,\n} from '@module-federation/enhanced/runtime';\nimport { Module } from '@module-federation/sdk';\nimport { DefaultApiClient, Remote } from './schema/openapi';\nimport {\n  FrontendFeature,\n  FrontendFeatureLoader,\n  createFrontendFeatureLoader,\n} from '@backstage/frontend-plugin-api';\nimport { ShareStrategy, UserOptions } from '@module-federation/runtime/types';\n\n/**\n *\n * @public\n */\nexport type DynamicFrontendFeaturesLoaderOptions = {\n  /**\n   * Additional module federation arguments for the Module Federation runtime initialization.\n   */\n  moduleFederation: {\n    shared?: UserOptions['shared'];\n    shareStrategy?: ShareStrategy;\n    plugins?: Array<FederationRuntimePlugin>;\n  };\n};\n\n/**\n * A function providing a loader of frontend features exposed as module federation remotes\n * from the backend dynamic features service.\n *\n * @public\n */\nexport function dynamicFrontendFeaturesLoader(\n  options?: DynamicFrontendFeaturesLoaderOptions,\n): FrontendFeatureLoader {\n  return createFrontendFeatureLoader({\n    async loader({ config }) {\n      const dynamicPLuginsConfig = config.getOptionalConfig('dynamicPlugins');\n      if (!dynamicPLuginsConfig) {\n        return [];\n      }\n\n      function error(message: string, err: unknown) {\n        // eslint-disable-next-line no-console\n        console.error(\n          `${message}: ${\n            err instanceof Error ? err.toString() : JSON.stringify(err)\n          }`,\n        );\n      }\n\n      const backendBaseUrl = config.getString('backend.baseUrl');\n\n      const appPackageName =\n        config.getOptionalString('app.packageName') ?? 'app';\n      let frontendPluginRemotes: Array<Remote>;\n      try {\n        const apiClient = new DefaultApiClient({\n          discoveryApi: {\n            getBaseUrl: async rootPath => `${backendBaseUrl}/${rootPath}`,\n          },\n          fetchApi: {\n            fetch(input) {\n              return global.fetch(input);\n            },\n          },\n        });\n\n        const response = await apiClient.getRemotes({});\n        if (!response.ok) {\n          throw new Error(`${response.status} - ${response.statusText}`);\n        }\n        frontendPluginRemotes = await response.json();\n      } catch (err) {\n        error(\n          `Failed fetching module federation configuration of dynamic frontend plugins`,\n          err,\n        );\n        return [];\n      }\n\n      try {\n        init({\n          ...options?.moduleFederation,\n          name: appPackageName\n            .replaceAll('@', '')\n            .replaceAll('/', '__')\n            .replaceAll('-', '_'),\n          remotes: frontendPluginRemotes.map(remote => ({\n            alias: remote.packageName,\n            ...remote.remoteInfo,\n          })),\n        });\n      } catch (err) {\n        error(`Failed initializing module federation`, err);\n        return [];\n      }\n\n      const features = (\n        await Promise.all(\n          frontendPluginRemotes.map(async remote => {\n            // eslint-disable-next-line no-console\n            console.debug(\n              `Loading dynamic plugin '${remote.packageName}' from '${remote.remoteInfo.entry}'`,\n            );\n\n            const moduleFeatures = await Promise.all(\n              remote.exposedModules.map(async exposedModuleName => {\n                const remoteModuleName =\n                  exposedModuleName === '.'\n                    ? remote.remoteInfo.name\n                    : `${remote.remoteInfo.name}/${exposedModuleName}`;\n                let module: Module;\n                try {\n                  module = await loadRemote<Module>(remoteModuleName);\n                } catch (err) {\n                  error(\n                    `Failed loading remote module '${remoteModuleName}' of dynamic plugin '${remote.packageName}'`,\n                    err,\n                  );\n                  return undefined;\n                }\n                if (!module) {\n                  // eslint-disable-next-line no-console\n                  console.warn(\n                    `Skipping empty dynamic plugin remote module '${remoteModuleName}'.`,\n                  );\n                  return undefined;\n                }\n                // eslint-disable-next-line no-console\n                console.info(\n                  `Remote module '${remoteModuleName}' of dynamic plugin '${remote.packageName}' loaded from ${remote.remoteInfo.entry}`,\n                );\n                const defaultEntry = module.default;\n                if (!isLoadable(defaultEntry)) {\n                  // eslint-disable-next-line no-console\n                  console.debug(\n                    `Skipping dynamic plugin remote module '${remote}' since it doesn't export a new 'FrontendFeature' as default export.`,\n                  );\n                  return undefined;\n                }\n                return defaultEntry;\n              }),\n            );\n            return moduleFeatures;\n          }),\n        )\n      )\n        .flat()\n        .filter((feature): feature is FrontendFeature => feature !== undefined);\n\n      return [...features];\n    },\n  });\n}\n\nfunction isLoadable(obj: unknown): obj is FrontendFeature {\n  if (obj !== null && typeof obj === 'object' && '$$type' in obj) {\n    return (\n      obj.$$type === '@backstage/FrontendPlugin' ||\n      obj.$$type === '@backstage/FrontendModule'\n    );\n  }\n  return false;\n}\n"],"names":[],"mappings":"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"}

package/dist/schema/openapi/generated/apis/Api.client.esm.js

@@ -0,0 +1,30 @@
+import crossFetch from 'cross-fetch';
+import { pluginId } from '../pluginId.esm.js';
+import * as parser from 'uri-template';
+
+class DefaultApiClient {
+  discoveryApi;
+  fetchApi;
+  constructor(options) {
+    this.discoveryApi = options.discoveryApi;
+    this.fetchApi = options.fetchApi || { fetch: crossFetch };
+  }
+  /**
+   * Get the Module Federation remote definitions.
+   */
+  async getRemotes(request, options) {
+    const baseUrl = await this.discoveryApi.getBaseUrl(pluginId);
+    const uriTemplate = `/remotes`;
+    const uri = parser.parse(uriTemplate).expand({});
+    return await this.fetchApi.fetch(`${baseUrl}${uri}`, {
+      headers: {
+        "Content-Type": "application/json",
+        ...options?.token && { Authorization: `Bearer ${options?.token}` }
+      },
+      method: "GET"
+    });
+  }
+}
+
+export { DefaultApiClient };
+//# sourceMappingURL=Api.client.esm.js.map

package/dist/schema/openapi/generated/apis/Api.client.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Api.client.esm.js","sources":["../../../../../src/schema/openapi/generated/apis/Api.client.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// ******************************************************************\n// * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY. *\n// ******************************************************************\nimport { DiscoveryApi } from '../types/discovery';\nimport { FetchApi } from '../types/fetch';\nimport crossFetch from 'cross-fetch';\nimport { pluginId } from '../pluginId';\nimport * as parser from 'uri-template';\nimport { Remote } from '../models/Remote.model';\n\n/**\n * Wraps the Response type to convey a type on the json call.\n *\n * @public\n */\nexport type TypedResponse<T> = Omit<Response, 'json'> & {\n  json: () => Promise<T>;\n};\n\n/**\n * Options you can pass into a request for additional information.\n *\n * @public\n */\nexport interface RequestOptions {\n  token?: string;\n}\n/**\n * @public\n */\nexport type GetRemotes = {};\n\n/**\n * @public\n */\nexport class DefaultApiClient {\n  private readonly discoveryApi: DiscoveryApi;\n  private readonly fetchApi: FetchApi;\n\n  constructor(options: {\n    discoveryApi: { getBaseUrl(pluginId: string): Promise<string> };\n    fetchApi?: { fetch: typeof fetch };\n  }) {\n    this.discoveryApi = options.discoveryApi;\n    this.fetchApi = options.fetchApi || { fetch: crossFetch };\n  }\n\n  /**\n   * Get the Module Federation remote definitions.\n   */\n  public async getRemotes(\n    // @ts-ignore\n    request: GetRemotes,\n    options?: RequestOptions,\n  ): Promise<TypedResponse<Array<Remote>>> {\n    const baseUrl = await this.discoveryApi.getBaseUrl(pluginId);\n\n    const uriTemplate = `/remotes`;\n\n    const uri = parser.parse(uriTemplate).expand({});\n\n    return await this.fetchApi.fetch(`${baseUrl}${uri}`, {\n      headers: {\n        'Content-Type': 'application/json',\n        ...(options?.token && { Authorization: `Bearer ${options?.token}` }),\n      },\n      method: 'GET',\n    });\n  }\n}\n"],"names":[],"mappings":";;;;AAmDO,MAAM,gBAAiB,CAAA;AAAA,EACX,YAAA;AAAA,EACA,QAAA;AAAA,EAEjB,YAAY,OAGT,EAAA;AACD,IAAA,IAAA,CAAK,eAAe,OAAQ,CAAA,YAAA;AAC5B,IAAA,IAAA,CAAK,QAAW,GAAA,OAAA,CAAQ,QAAY,IAAA,EAAE,OAAO,UAAW,EAAA;AAAA;AAC1D;AAAA;AAAA;AAAA,EAKA,MAAa,UAEX,CAAA,OAAA,EACA,OACuC,EAAA;AACvC,IAAA,MAAM,OAAU,GAAA,MAAM,IAAK,CAAA,YAAA,CAAa,WAAW,QAAQ,CAAA;AAE3D,IAAA,MAAM,WAAc,GAAA,CAAA,QAAA,CAAA;AAEpB,IAAA,MAAM,MAAM,MAAO,CAAA,KAAA,CAAM,WAAW,CAAE,CAAA,MAAA,CAAO,EAAE,CAAA;AAE/C,IAAO,OAAA,MAAM,KAAK,QAAS,CAAA,KAAA,CAAM,GAAG,OAAO,CAAA,EAAG,GAAG,CAAI,CAAA,EAAA;AAAA,MACnD,OAAS,EAAA;AAAA,QACP,cAAgB,EAAA,kBAAA;AAAA,QAChB,GAAI,SAAS,KAAS,IAAA,EAAE,eAAe,CAAU,OAAA,EAAA,OAAA,EAAS,KAAK,CAAG,CAAA;AAAA,OACpE;AAAA,MACA,MAAQ,EAAA;AAAA,KACT,CAAA;AAAA;AAEL;;;;"}

package/dist/schema/openapi/generated/pluginId.esm.js

@@ -0,0 +1,4 @@
+const pluginId = ".backstage/dynamic-features";
+
+export { pluginId };
+//# sourceMappingURL=pluginId.esm.js.map

package/dist/schema/openapi/generated/pluginId.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginId.esm.js","sources":["../../../../src/schema/openapi/generated/pluginId.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport const pluginId = '.backstage/dynamic-features';\n"],"names":[],"mappings":"AAgBO,MAAM,QAAW,GAAA;;;;"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@backstage/frontend-dynamic-feature-loader",
+  "version": "0.0.0-nightly-20250425023938",
+  "backstage": {
+    "role": "web-library"
+  },
+  "publishConfig": {
+    "access": "public",
+    "main": "dist/index.esm.js",
+    "types": "dist/index.d.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/backstage/backstage",
+    "directory": "packages/frontend-dynamic-feature-loader"
+  },
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "main": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "config.d.ts",
+    "dist"
+  ],
+  "scripts": {
+    "build": "backstage-cli package build",
+    "clean": "backstage-cli package clean",
+    "lint": "backstage-cli package lint",
+    "prepack": "backstage-cli package prepack",
+    "postpack": "backstage-cli package postpack",
+    "start": "backstage-cli package start",
+    "test": "backstage-cli package test"
+  },
+  "dependencies": {
+    "@backstage/config": "1.3.2",
+    "@backstage/frontend-plugin-api": "0.0.0-nightly-20250425023938",
+    "@module-federation/enhanced": "^0.9.0",
+    "@module-federation/runtime": "^0.9.0",
+    "@module-federation/sdk": "^0.9.0",
+    "cross-fetch": "^4.0.0",
+    "uri-template": "^2.0.0"
+  },
+  "devDependencies": {
+    "@backstage/cli": "0.0.0-nightly-20250425023938",
+    "@backstage/test-utils": "1.7.7",
+    "@testing-library/jest-dom": "^6.0.0",
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "^18.0.0",
+    "msw": "^1.0.0",
+    "react": "^18.0.2",
+    "react-dom": "^18.0.2",
+    "react-router-dom": "^6.3.0"
+  },
+  "peerDependencies": {
+    "@types/react": "^17.0.0 || ^18.0.0",
+    "react": "^17.0.0 || ^18.0.0",
+    "react-dom": "^17.0.0 || ^18.0.0",
+    "react-router-dom": "^6.3.0"
+  },
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    }
+  },
+  "configSchema": "config.d.ts",
+  "typesVersions": {
+    "*": {
+      "package.json": [
+        "package.json"
+      ]
+    }
+  },
+  "module": "./dist/index.esm.js"
+}