@mashroom/mashroom-portal-open-microfrontends-support 3.0.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) nonblocking.at gmbh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+
+# Mashroom Portal Open Microfrontends Support
+
+Plugin for [Mashroom Server](https://www.mashroom-server.com), a **Microfrontend Integration Platform**.
+
+This plugins loads support for registering and loading [OpenMicrofrontends](https://open-microfrontends.org) compatible Microfrontends
+in the [Mashroom Portal](../mashroom-portal).
+
+## Usage
+
+If *node_modules/@mashroom* is configured as a plugin path, add **mashroom-portal-open-microfrontends-support** as *dependency*.
+
+After that you can register [OpenMicrofrontends](https://open-microfrontends.org) compatible Microfrontends like any other *remote plugin*, e.g.,
+by opening */mashroom/admin/ext/remote-plugin-packages* and pasting the Microfrontend URL into the form.
+
+### Custom Extensions
+
+This plugin supports some custom annotations for features OpenMicrofrontends doesn't support out of the box:
+
+ * MASHROOM_ROLE_PERMISSIONS: Sames as *rolePermissions* in native Mashroom Portal Apps.
+ * MASHROOM_DEFAULT_RESTRICT_VIEW_TO_ROLES: Same as *defaultRestrictViewToRoles* in native Mashroom Portal Apps.
+ * MASHROOM_PROXIES_RESTRICT_TO_ROLES: Define *restrictToRoles* for specific proxies.
+ * MASHROOM_META_INFO: Will be merged into *metaInfo*.
+
+Example:
+
+```yaml
+    annotations:
+        # Mashroom extensions
+        MASHROOM_ROLE_PERMISSIONS:
+            deleteCustomer:
+            - role1
+            - role2
+        MASHROOM_DEFAULT_RESTRICT_VIEW_TO_ROLES:
+        - role3
+        MASHROOM_PROXIES_RESTRICT_TO_ROLES:
+            proxy1:
+            - role4
+            - role5
+        MASHROOM_META_INFO:
+            myCustomProperty: myCustomValue
+```

package/dist/app-enhancement/MashroomOpenMicrofrontendsMashroomPortalAppEnhancementPlugin.js

@@ -0,0 +1,30 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _mapPortalAppSetupToOpenMicrofrontendsContext = _interopRequireDefault(require("./mapPortalAppSetupToOpenMicrofrontendsContext"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+class MashroomOpenMicrofrontendsMashroomPortalAppEnhancementPlugin {
+  #logger;
+  constructor(loggerFactory) {
+    this.#logger = loggerFactory('mashroom.portal.open-microfrontends');
+  }
+  async enhancePortalAppSetup(portalAppSetup, portalApp, request) {
+    if (portalApp.metaInfo?.openMicrofrontends) {
+      this.#logger.debug(`Mapping setup to OpenMicrofrontends context for App ${portalApp.name}`);
+      const context = (0, _mapPortalAppSetupToOpenMicrofrontendsContext.default)(portalAppSetup);
+      return {
+        ...portalAppSetup,
+        ...context,
+        user: {
+          ...portalAppSetup.user,
+          ...context.user
+        }
+      };
+    }
+    return portalAppSetup;
+  }
+}
+exports.default = MashroomOpenMicrofrontendsMashroomPortalAppEnhancementPlugin;

package/dist/app-enhancement/mapPortalAppSetupToOpenMicrofrontendsContext.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _default = portalAppSetup => {
+  const {
+    appId,
+    lang,
+    proxyPaths,
+    user,
+    appConfig,
+    serverSideRendered
+  } = portalAppSetup;
+  return {
+    id: appId,
+    lang,
+    user: !user.guest ? {
+      username: user.username,
+      displayName: user.displayName
+    } : undefined,
+    permissions: user.permissions,
+    apiProxyPaths: proxyPaths,
+    config: appConfig,
+    serverSideRendered,
+    hostContext: {
+      hostApplicationName: 'Mashroom Portal',
+      openMicrofrontends: true
+    }
+  };
+};
+exports.default = _default;

package/dist/app-enhancement/mashroom-bootstrap-portal-app-enhancement.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _MashroomOpenMicrofrontendsMashroomPortalAppEnhancementPlugin = _interopRequireDefault(require("./MashroomOpenMicrofrontendsMashroomPortalAppEnhancementPlugin"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const bootstrap = (pluginName, pluginConfig, pluginContextHolder) => {
+  const {
+    loggerFactory
+  } = pluginContextHolder.getPluginContext();
+  return new _MashroomOpenMicrofrontendsMashroomPortalAppEnhancementPlugin.default(loggerFactory);
+};
+var _default = exports.default = bootstrap;

package/dist/def-builder/MashroomOpenMicrofrontendsPluginPackageDefinitionBuilder.js

@@ -0,0 +1,51 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _url = require("url");
+var _fetchRemoteJSONorYAML = _interopRequireDefault(require("./fetchRemoteJSONorYAML"));
+var _mapOpenMicrofrontendsToPortalApp = _interopRequireDefault(require("./mapOpenMicrofrontendsToPortalApp2"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const KNOWN_OPEN_MICROFRONTENDS_DESCRIPTOR_PATHS = ['/microfrontends.yaml', '/microfrontends.json'];
+class MashroomOpenMicrofrontendsPluginPackageDefinitionBuilder {
+  #logger;
+  constructor(loggerFactory) {
+    this.#logger = loggerFactory('mashroom.portal.open-microfrontends');
+  }
+  get name() {
+    return 'Mashroom Open Microfrontends Plugin Package Definition Builder';
+  }
+  async buildDefinition(packageUrl, scannerHints) {
+    if (packageUrl.protocol === 'file:') {
+      // Ignore local packages
+      return null;
+    }
+    this.#logger.debug(`Checking for an OpenMicrofrontends: ${packageUrl}`);
+
+    // If there is a scanner hint that suggest that this is a native Mashroom remote package, skip it
+    if (Object.keys(scannerHints).find(hint => hint.startsWith('mashroom-server.com/'))) {
+      this.#logger.debug(`Ignoring package because ${scannerHints.pluginDefinitionPath} doesn't look like a OpenMicrofrontends compatible service`);
+      return null;
+    }
+    let descriptor;
+    for (const path of KNOWN_OPEN_MICROFRONTENDS_DESCRIPTOR_PATHS) {
+      const descriptorURL = new _url.URL(path, packageUrl);
+      try {
+        descriptor = await (0, _fetchRemoteJSONorYAML.default)(descriptorURL, this.#logger);
+        if (descriptor) {
+          break;
+        }
+      } catch (e) {
+        this.#logger.error(`Fetching OpenMicrofrontends descriptor from ${descriptorURL} failed!`, e);
+      }
+    }
+    if (!descriptor || !('openMicrofrontends' in descriptor)) {
+      this.#logger.debug(`No OpenMicrofrontends descriptor found for ${packageUrl}`);
+      return null;
+    }
+    return [await (0, _mapOpenMicrofrontendsToPortalApp.default)(packageUrl, scannerHints, descriptor, this.#logger)];
+  }
+}
+exports.default = MashroomOpenMicrofrontendsPluginPackageDefinitionBuilder;

package/dist/def-builder/constants.js

@@ -0,0 +1,11 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.META_INFO_FLAG_OPEN_MICROFRONTENDS = exports.ANNOTATION_ROLE_PERMISSIONS = exports.ANNOTATION_PROXIES_RESTRICT_TO_ROLES = exports.ANNOTATION_META_INFO = exports.ANNOTATION_DEFAULT_RESTRICT_VIEW_TO_ROLES = void 0;
+const META_INFO_FLAG_OPEN_MICROFRONTENDS = exports.META_INFO_FLAG_OPEN_MICROFRONTENDS = 'openMicrofrontends';
+const ANNOTATION_ROLE_PERMISSIONS = exports.ANNOTATION_ROLE_PERMISSIONS = 'MASHROOM_ROLE_PERMISSIONS';
+const ANNOTATION_DEFAULT_RESTRICT_VIEW_TO_ROLES = exports.ANNOTATION_DEFAULT_RESTRICT_VIEW_TO_ROLES = 'MASHROOM_DEFAULT_RESTRICT_VIEW_TO_ROLES';
+const ANNOTATION_PROXIES_RESTRICT_TO_ROLES = exports.ANNOTATION_PROXIES_RESTRICT_TO_ROLES = 'MASHROOM_PROXIES_RESTRICT_TO_ROLES';
+const ANNOTATION_META_INFO = exports.ANNOTATION_META_INFO = 'MASHROOM_META_INFO'; // Test

package/dist/def-builder/fetchRemoteJSONorYAML.js

@@ -0,0 +1,39 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _mashroomUtils = require("@mashroom/mashroom-utils");
+const REMOTE_DEFAULT_SOCKET_TIMEOUT_MS = 5 * 1000;
+var _default = async (url, logger) => {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), REMOTE_DEFAULT_SOCKET_TIMEOUT_MS);
+  try {
+    const result = await fetch(url.toString(), {
+      signal: controller.signal
+    });
+    if (result.ok) {
+      const text = await result.text();
+      if (url.pathname.endsWith('.json')) {
+        return JSON.parse(text);
+      }
+      return _mashroomUtils.configFileUtils.fromYaml(text);
+    } else if (result.status === 404) {
+      logger.debug(`Not found: ${url}`);
+      return null;
+    } else {
+      throw new Error(`Status code ${result.status}`);
+    }
+  } catch (e) {
+    if (e.message.includes('aborted')) {
+      logger.error(`Fetching from ${url} failed! Timed out after ${REMOTE_DEFAULT_SOCKET_TIMEOUT_MS}sec`);
+    } else {
+      logger.error(`Fetching from ${url} failed!`, e);
+    }
+  } finally {
+    clearTimeout(timeout);
+  }
+  return null;
+};
+exports.default = _default;

package/dist/def-builder/mapOpenMicrofrontendsToPortalApp2.js

@@ -0,0 +1,164 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _url = require("url");
+var _constants = require("./constants");
+var _fetchRemoteJSONorYAML = _interopRequireDefault(require("./fetchRemoteJSONorYAML"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const OPEN_MICROFRONTEND_VERSION_REGEX = /^(1\.\d+\.\d+)$/;
+var _default = async (packageUrl, scannerHints, description, logger) => {
+  const {
+    openMicrofrontends,
+    info,
+    microfrontends
+  } = description;
+  if (!openMicrofrontends || !OPEN_MICROFRONTEND_VERSION_REGEX.test(openMicrofrontends)) {
+    throw new Error(`Unsupported OpenMicrofrontends version: ${openMicrofrontends}`);
+  }
+  const unsupportedFeatureMessages = [];
+  let buildManifestPath;
+  microfrontends.forEach(omf => {
+    if (omf.assets.buildManifestPath) {
+      if (!buildManifestPath) {
+        buildManifestPath = omf.assets.buildManifestPath;
+      } else if (omf.assets.buildManifestPath !== buildManifestPath) {
+        logger.warn(`The build manifests found in OpenMicrofrontends descriptor ${packageUrl} . Choosing: ${buildManifestPath}`);
+      }
+    }
+  });
+
+  // Check the build manifest for version info (only if no scannerHints.packageVersion is set, which probably the docker image version and has precedence)
+  let buildManifestVersion;
+  if (!scannerHints.packageVersion && buildManifestPath) {
+    try {
+      const buildManifest = await (0, _fetchRemoteJSONorYAML.default)(new _url.URL(buildManifestPath, packageUrl), logger);
+      if (buildManifest) {
+        buildManifestVersion = buildManifest.version || buildManifest.timestamp;
+        if (!buildManifestVersion) {
+          logger.warn(`The build manifest at ${buildManifestPath} in ${packageUrl} does not contain a version or timestamp!`);
+        }
+      } else {
+        logger.warn(`Couldn't load build manifest ${buildManifestPath} from ${packageUrl}.`);
+      }
+    } catch (e) {
+      logger.warn(`Couldn't load build manifest ${buildManifestPath} from ${packageUrl}: ${e}`);
+    }
+  }
+  const meta = {
+    name: scannerHints.packageName ?? packageUrl.hostname,
+    version: scannerHints.packageVersion ?? buildManifestVersion ?? String(Date.now()),
+    description: info?.description ?? null,
+    homepage: null,
+    author: info?.contact?.author ?? null,
+    license: null
+  };
+  const definition = {
+    buildManifestPath,
+    plugins: []
+  };
+  microfrontends.forEach(omf => {
+    const {
+      name,
+      rendererFunctionName,
+      assets,
+      ssr,
+      userPermissions,
+      apiProxies,
+      config,
+      annotations
+    } = omf;
+    let rolePermissions = annotations?.[_constants.ANNOTATION_ROLE_PERMISSIONS];
+    let defaultRestrictViewToRoles = annotations?.[_constants.ANNOTATION_DEFAULT_RESTRICT_VIEW_TO_ROLES];
+    let proxiesRestrictToRoles = annotations?.[_constants.ANNOTATION_PROXIES_RESTRICT_TO_ROLES];
+    let extraMetaInfo = annotations?.[_constants.ANNOTATION_META_INFO];
+    if (rolePermissions && typeof rolePermissions !== 'object') {
+      logger.warn(`Invalid rolePermissions annotation for OpenMicrofrontend ${name}: ${rolePermissions}`);
+      rolePermissions = undefined;
+    }
+    if (defaultRestrictViewToRoles && !Array.isArray(defaultRestrictViewToRoles)) {
+      logger.warn(`Invalid defaultRestrictViewToRoles annotation for OpenMicrofrontend ${name}: ${defaultRestrictViewToRoles}`);
+      defaultRestrictViewToRoles = undefined;
+    }
+    if (proxiesRestrictToRoles && typeof proxiesRestrictToRoles !== 'object') {
+      logger.warn(`Invalid proxiesRestrictToRoles annotation for OpenMicrofrontend ${name}: ${proxiesRestrictToRoles}`);
+      proxiesRestrictToRoles = undefined;
+    }
+    if (extraMetaInfo && typeof extraMetaInfo !== 'object') {
+      logger.warn(`Invalid extraMetaInfo annotation for OpenMicrofrontend ${name}: ${extraMetaInfo}`);
+      extraMetaInfo = undefined;
+    }
+    let proxies;
+    if (typeof apiProxies === 'object') {
+      proxies = {};
+      Object.keys(apiProxies).forEach(proxyName => {
+        const apiProxy = apiProxies[proxyName];
+        if (apiProxy.security) {
+          unsupportedFeatureMessages.push(`Microfrontend "${name}": apiProxy "${proxyName}" requires security: You have to define an additional "portal-app-config" plugin.`);
+        }
+        if ('path' in apiProxy) {
+          proxies[proxyName] = {
+            targetPath: apiProxy.path,
+            restrictToRoles: proxiesRestrictToRoles?.[proxyName]
+          };
+        } else {
+          const targets = apiProxy.targets;
+          if (targets && Array.isArray(targets)) {
+            unsupportedFeatureMessages.push(`Microfrontend "${name}": apiProxy "${proxyName}" has multiple possible targets, choosing: ${targets[0].url}. Define an additional "portal-app-config" plugin to select the correct one.`);
+            proxies[proxyName] = {
+              targetUri: targets[0].url,
+              restrictToRoles: proxiesRestrictToRoles?.[proxyName]
+            };
+          } else {
+            logger.warn(`No targets defined for apiProxy ${proxyName} of OpenMicrofrontend ${name}. Ignoring it.`);
+          }
+        }
+      });
+    }
+    if (ssr?.security) {
+      unsupportedFeatureMessages.push(`Microfrontend "${name}": Requires security for the SSR route. This requires an additional "portal-app-config" plugin.`);
+    }
+    if (userPermissions?.provided) {
+      unsupportedFeatureMessages.push(`Microfrontend "${name}": Found a userPermissions provider. This requires an additional "portal-app-config" plugin.`);
+    }
+    const portalApp2 = {
+      name,
+      type: 'portal-app2',
+      clientBootstrap: rendererFunctionName,
+      resources: {
+        moduleSystem: assets.js.moduleSystem,
+        importMap: assets.js.importMap,
+        js: assets.js.initial,
+        css: assets.css
+      },
+      remote: {
+        resourcesRoot: assets.basePath ?? '/',
+        ssrInitialHtmlPath: ssr?.path
+      },
+      defaultConfig: {
+        title: omf.title,
+        description: omf.description,
+        proxies,
+        rolePermissions,
+        defaultRestrictViewToRoles,
+        metaInfo: {
+          [_constants.META_INFO_FLAG_OPEN_MICROFRONTENDS]: true,
+          ...(extraMetaInfo || {})
+        },
+        appConfig: config?.default
+      }
+    };
+    definition.plugins.push(portalApp2);
+  });
+  if (unsupportedFeatureMessages.length > 0) {
+    logger.warn(`Unsupported features in OpenMicrofrontend descriptor ${packageUrl}:\n\t${unsupportedFeatureMessages.join('\n\t')}`);
+  }
+  return {
+    packageUrl,
+    meta,
+    definition
+  };
+};
+exports.default = _default;

package/dist/def-builder/mashroom-bootstrap-package-definition-builder.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _MashroomOpenMicrofrontendsPluginPackageDefinitionBuilder = _interopRequireDefault(require("./MashroomOpenMicrofrontendsPluginPackageDefinitionBuilder"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const bootstrap = async (pluginName, pluginConfig, pluginContextHolder) => {
+  const {
+    loggerFactory
+  } = pluginContextHolder.getPluginContext();
+  return new _MashroomOpenMicrofrontendsPluginPackageDefinitionBuilder.default(loggerFactory);
+};
+var _default = exports.default = bootstrap;

package/dist/public/openMicrofrontendsClientBootstrapAdapter.js

@@ -0,0 +1,2 @@
+(()=>{"use strict";const e={get name(){return"OpenMicrofrontends Client Bootstrap Adapter"},shouldAdapt:e=>"hostContext"in e&&e.hostContext.openMicrofrontends,adapt:e=>async(o,t,r)=>{const n=e,s={...t,messageBus:r.messageBus},a=await n(o,s);if(a?.onRemove)return{willBeRemoved:a.onRemove}}},o=window.MashroomPortalServices.portalAppService;o?o.registerClientBootstrapAdapter(e):console.error("Cannot install OpenMicrofrontends Client Bootstrap Adapter: No Mashroom Portal Services found!")})();
+//# sourceMappingURL=openMicrofrontendsClientBootstrapAdapter.js.map

package/dist/public/openMicrofrontendsClientBootstrapAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openMicrofrontendsClientBootstrapAdapter.js","mappings":"mBAQA,MAAMA,EAAmD,CACrD,QAAIC,GACA,MAAM,6CACV,EACAC,YAAYC,GACD,gBAAiBA,GAAmBA,EAAuBC,YAAYC,mBAElFC,MAAMC,GACKC,MAAOC,EAAsBN,EAAgBO,KAChD,MAAMC,EAAWJ,EACXK,EAAe,IACdT,EACHU,WAAYH,EAAeG,YAGzBC,QAAeH,EAASF,EAAsBG,GACpD,GAAIE,GAAQC,SACR,MAAO,CACHC,cAAeF,EAAOC,YAQpCE,EAA8CC,OAAeC,uBAAuBF,iBACtFA,EACAA,EAAiBG,+BAA+BpB,GAEhDqB,QAAQC,MAAM","sources":["webpack://@mashroom/mashroom-portal-open-microfrontends-support/./src/page-enhancement/openMicrofrontendsClientBootstrapAdapter.ts"],"sourcesContent":["import type {\n    MashroomPortalAppClientBootstrapAdapter,\n    MashroomPortalAppPluginBootstrapFunction,\n    MashroomPortalAppService,\n    MashroomPortalAppSetup\n} from '@mashroom/mashroom-portal/type-definitions';\nimport type {OpenMicrofrontendsRenderer} from '@open-microfrontends/types/OpenMicrofrontendsRenderer';\n\nconst adapter: MashroomPortalAppClientBootstrapAdapter = {\n    get name() {\n        return'OpenMicrofrontends Client Bootstrap Adapter';\n    },\n    shouldAdapt(portalAppSetup: MashroomPortalAppSetup) {\n        return 'hostContext' in portalAppSetup && (portalAppSetup as any).hostContext.openMicrofrontends;\n    },\n    adapt(orginalBootstrap): MashroomPortalAppPluginBootstrapFunction {\n        return async (portalAppHostElement, portalAppSetup, clientServices) => {\n            const renderer = orginalBootstrap as unknown as OpenMicrofrontendsRenderer<any>;\n            const context: any = {\n                ...portalAppSetup,\n                messageBus: clientServices.messageBus,\n            };\n\n            const result = await renderer(portalAppHostElement, context);\n            if (result?.onRemove) {\n                return {\n                    willBeRemoved: result.onRemove,\n                };\n            }\n            return undefined;\n        };\n    },\n};\n\nconst portalAppService: MashroomPortalAppService = (window as any).MashroomPortalServices.portalAppService;\nif (portalAppService) {\n    portalAppService.registerClientBootstrapAdapter(adapter);\n} else {\n    console.error('Cannot install OpenMicrofrontends Client Bootstrap Adapter: No Mashroom Portal Services found!');\n}\n\n"],"names":["adapter","name","shouldAdapt","portalAppSetup","hostContext","openMicrofrontends","adapt","orginalBootstrap","async","portalAppHostElement","clientServices","renderer","context","messageBus","result","onRemove","willBeRemoved","portalAppService","window","MashroomPortalServices","registerClientBootstrapAdapter","console","error"],"sourceRoot":""}

package/mashroom.json

@@ -0,0 +1,32 @@
+{
+    "$schema": "../../../node_modules/@mashroom/mashroom-json-schemas/schemas/mashroom-plugins.json",
+    "devModeBuildScript": "build",
+    "plugins": [
+        {
+            "name": "Mashroom OpenMicrofrontends Support Definition Builder Plugin",
+            "type": "plugin-package-definition-builder",
+            "bootstrap": "./dist/def-builder/mashroom-bootstrap-package-definition-builder.js",
+            "defaultConfig": {
+                "order": 10
+            }
+        },
+        {
+            "name": "Mashroom OpenMicrofrontends Support App Enhancement Plugin",
+            "type": "portal-app-enhancement",
+            "bootstrap": "./dist/app-enhancement/mashroom-bootstrap-portal-app-enhancement.js"
+        },
+        {
+            "name": "Mashroom OpenMicrofrontends Support Page Enhancement Plugin",
+            "type": "portal-page-enhancement",
+            "resourcesRoot": "./dist/public",
+            "pageResources": {
+                "js": [{
+                    "path": "openMicrofrontendsClientBootstrapAdapter.js",
+                    "location": "footer"
+                }]
+            },
+            "defaultConfig": {
+            }
+        }
+    ]
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+    "name": "@mashroom/mashroom-portal-open-microfrontends-support",
+    "description": "Mashroom Portal Open Microfrontends Support",
+    "homepage": "https://www.mashroom-server.com",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/nonblocking/mashroom.git"
+    },
+    "license": "MIT",
+    "version": "3.0.0-alpha.0",
+    "files": [
+        "dist/**",
+        "mashroom.json"
+    ],
+    "devDependencies": {
+        "@mashroom/mashroom": "3.0.0-alpha.0",
+        "@mashroom/mashroom-utils": "3.0.0-alpha.0",
+        "@open-microfrontends/types": "^1.0.0"
+    },
+    "jest": {
+        "testEnvironment": "node",
+        "roots": [
+            "<rootDir>/test"
+        ],
+        "testRegex": "(\\.(test|spec))\\.ts",
+        "transform": {
+            "^.+\\.ts$": "ts-jest"
+        },
+        "reporters": [
+            "default",
+            "jest-junit"
+        ]
+    },
+    "jest-junit": {
+        "outputDirectory": "./test-reports"
+    },
+    "scripts": {
+        "lint": "eslint --fix",
+        "type-check": "tsc --noEmit",
+        "test": "jest",
+        "build": "babel src/def-builder -d dist/def-builder --extensions \".ts\" && babel src/app-enhancement -d dist/app-enhancement --extensions \".ts\" && webpack --mode production"
+    }
+}