@adobe/uix-host-react 0.10.5 → 1.0.1

package/dist/components/ExtensibleWrapper/ExtensibleWrapper.d.ts

@@ -0,0 +1,33 @@
+import type { PropsWithChildren, ReactElement } from "react";
+import { type HostConfig, type PortOptions, type SharedContextValues } from "@adobe/uix-host";
+/** @public */
+export interface ExtensibleDefaultProps extends Omit<HostConfig, "hostName"> {
+    /**
+     * Unique name for identifying this extensible app. May be used as metadata in
+     * extension registry in the future.
+     */
+    appName?: string;
+    /**
+     * {@inheritDoc HostConfig.guestOptions}
+     */
+    guestOptions?: PortOptions;
+    /**
+     * {@inheritDoc HostConfig.sharedContext}
+     */
+    sharedContext?: SharedContextValues;
+    queryString?: string;
+    service: string;
+    extensionPoint: string;
+    version: string;
+    disableExtensionManager?: boolean;
+    authConfig: {
+        imsToken: string;
+        imsOrg: string;
+        apiKey: string;
+    };
+    scope?: Record<string, any>;
+    experienceShellEnvironment?: "prod" | "stage";
+}
+export declare const ExtensibleWrapper: ({ appName, children, guestOptions, runtimeContainer, debug, sharedContext, experienceShellEnvironment, queryString, service, extensionPoint, version, disableExtensionManager, authConfig, scope, }: PropsWithChildren<ExtensibleDefaultProps>) => ReactElement;
+export default ExtensibleWrapper;
+//# sourceMappingURL=ExtensibleWrapper.d.ts.map

package/dist/components/ExtensibleWrapper/ExtensibleWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensibleWrapper.d.ts","sourceRoot":"","sources":["../../../src/components/ExtensibleWrapper/ExtensibleWrapper.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG7D,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AAQzB,cAAc;AACd,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC;IAC1E;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B;;OAEG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,0BAA0B,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/C;AAED,eAAO,MAAM,iBAAiB,wMAe3B,kBAAkB,sBAAsB,CAAC,KAAG,YAyD9C,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/components/ExtensibleWrapper/ExtensionManagerProvider.d.ts

@@ -0,0 +1,129 @@
+/*************************************************************************
+ * ADOBE CONFIDENTIAL
+ * ___________________
+ *
+ * Copyright 2024 Adobe
+ * All Rights Reserved.
+ *
+ * NOTICE: All information contained herein is, and remains
+ * the property of Adobe and its suppliers, if any. The intellectual
+ * and technical concepts contained herein are proprietary to Adobe
+ * and its suppliers and are protected by all applicable intellectual
+ * property laws, including trade secret and copyright laws.
+ * Dissemination of this information or reproduction of this material
+ * is strictly forbidden unless prior written permission is obtained
+ * from Adobe.
+ **************************************************************************/
+import { ExtensionsProvider, InstalledExtensions } from "@adobe/uix-host";
+declare type ExtensionPoint = {
+    extensionPoint: string;
+    url: string;
+};
+export declare type ExtensionManagerExtension = {
+    id: string;
+    name: string;
+    title: string;
+    description: string;
+    status: string;
+    supportEmail: string;
+    extId: string;
+    disabled: boolean;
+    extensionPoints: ExtensionPoint[];
+    scope: Record<string, unknown>;
+    configuration?: Record<string, unknown>;
+};
+declare type AuthEMConfig = {
+    schema: "Bearer" | "Basic";
+    imsToken: string;
+};
+export interface ExtensionManagerConfig {
+    apiKey: string;
+    auth: AuthEMConfig;
+    service: string;
+    extensionPoint: string;
+    version: string;
+    imsOrg: string;
+    baseUrl: string;
+    scope?: Record<string, string>;
+}
+/** Authentication configuration, including IMS Org ID, access token, and API key */
+export interface AuthConfig {
+    /** IMS Org ID */
+    imsOrg: string;
+    /** Access token for the user */
+    imsToken: string;
+    /** API key */
+    apiKey: string;
+}
+/** Discovery configuration, including environment and repo Id */
+export interface DiscoveryConfig {
+    /** Environment level for backend Extension resolution services */
+    experienceShellEnvironment?: "prod" | "stage";
+    scope?: Record<string, string>;
+}
+/** Extension point ID */
+export interface ExtensionPointId {
+    /** Service name */
+    service: string;
+    /** Extension point name */
+    name: string;
+    /** Extension point version */
+    version: string;
+}
+/**
+ * Sets up new ExtensionsProvider with authentication and discovery information needed to fetch the list of
+ * Extensions from AppRegistry and Extension Manager service, along with the query string portion of URL
+ * to extract the information about development Extensions
+ */
+export interface ExtensionsProviderConfig {
+    /** Discovery configuration */
+    discoveryConfig: DiscoveryConfig;
+    /** Authentication configuration */
+    authConfig: AuthConfig;
+    /** Extension point ID */
+    extensionPointId: ExtensionPointId;
+    providerConfig: ExtensionProviderConfig;
+}
+export interface ExtensionProviderConfig {
+    extensionManagerUrl?: string;
+    appRegistryUrl?: string;
+    disableExtensionManager?: boolean;
+}
+export declare const getExtensionRegistryBaseUrl: (environment: "prod" | "stage" | undefined, registry: string | null) => string;
+export declare const getExtensionManagerBaseUrl: (environment: "prod" | "stage" | undefined, extensionManager: string | null) => string;
+/**
+ * Extracts programId and envId from the repo value
+ * @param repo - the repo value
+ * @returns object with programId and envId
+ * @ignore
+ */
+export declare function extractProgramIdEnvId(repo: string): {
+    programId: string;
+    envId: string;
+};
+/**
+ * Builds the URL for fetching extensions from the Extension Manager service
+ * @param config - the Extension Manager configuration
+ * @returns the URL for fetching extensions
+ * @ignore
+ */
+export declare function buildExtensionManagerUrl(config: ExtensionManagerConfig): string;
+/**
+ * @ignore
+ */
+export declare function fetchExtensionsFromExtensionManager(config: ExtensionManagerConfig): Promise<ExtensionManagerExtension[]>;
+/**
+ * Takes an array of extensions from the App Registry, an array of extensions from the Extension Manager, and
+ * merges them into a list of Extensions. If an extension is disabled in the Extension Manager, it is removed from
+ * the list.
+ * Extension list from the App Registry is used as a base.
+ * @ignore
+ */
+export declare function mergeExtensions(appRegistryExtensions: InstalledExtensions, extensionManagerExtensions: ExtensionManagerExtension[], extensionPointId: ExtensionPointId): InstalledExtensions;
+/**
+ * Creates an extension manager extension provider
+ * @ignore
+ */
+export declare function createExtensionManagerExtensionsProvider(discoveryConfig: DiscoveryConfig, authConfig: AuthConfig, providerConfig: ExtensionProviderConfig, extensionPointId: ExtensionPointId): ExtensionsProvider;
+export {};
+//# sourceMappingURL=ExtensionManagerProvider.d.ts.map

package/dist/components/ExtensibleWrapper/ExtensionManagerProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionManagerProvider.d.ts","sourceRoot":"","sources":["../../../src/components/ExtensibleWrapper/ExtensionManagerProvider.ts"],"names":[],"mappings":"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"}

package/dist/components/ExtensibleWrapper/ExtensionManagerProvider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ExtensionManagerProvider.test.d.ts.map

package/dist/components/ExtensibleWrapper/ExtensionManagerProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionManagerProvider.test.d.ts","sourceRoot":"","sources":["../../../src/components/ExtensibleWrapper/ExtensionManagerProvider.test.ts"],"names":[],"mappings":""}

package/dist/components/ExtensibleWrapper/UrlExtensionProvider.d.ts

@@ -0,0 +1,37 @@
+/*************************************************************************
+ * ADOBE CONFIDENTIAL
+ * ___________________
+ *
+ * Copyright 2024 Adobe
+ * All Rights Reserved.
+ *
+ * NOTICE: All information contained herein is, and remains
+ * the property of Adobe and its suppliers, if any. The intellectual
+ * and technical concepts contained herein are proprietary to Adobe
+ * and its suppliers and are protected by all applicable intellectual
+ * property laws, including trade secret and copyright laws.
+ * Dissemination of this information or reproduction of this material
+ * is strictly forbidden unless prior written permission is obtained
+ * from Adobe.
+ **************************************************************************/
+import { ExtensionsProvider } from "@adobe/uix-host";
+import { ExtensionPointId } from "./ExtensionManagerProvider";
+export interface ExtUrlParams {
+    [key: string]: string;
+}
+/**
+ * Extracts extension URLs from the query string
+ * @ignore
+ */
+export declare function extractExtUrlParams(queryString: string | undefined): ExtUrlParams;
+/**
+ * Generates an extension ID from the extension URL
+ * @ignore
+ */
+export declare function generateExtensionId(extensionUrl: string): string;
+/**
+ * Creates an ExtensionsProvider that provides extensions from the URL
+ * @ignore
+ */
+export declare function createUrlExtensionsProvider(extensionPointId: ExtensionPointId, queryString: string | undefined): ExtensionsProvider;
+//# sourceMappingURL=UrlExtensionProvider.d.ts.map

package/dist/components/ExtensibleWrapper/UrlExtensionProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrlExtensionProvider.d.ts","sourceRoot":"","sources":["../../../src/components/ExtensibleWrapper/UrlExtensionProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;4EAe4E;AAC5E,OAAO,EAAE,kBAAkB,EAAuB,MAAM,iBAAiB,CAAC;AAE1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAI9D,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,YAAY,CAWd;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,gBAAgB,EAAE,gBAAgB,EAClC,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,kBAAkB,CAgCpB"}

package/dist/components/ExtensibleWrapper/UrlExtensionProvider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=UrlExtensionProvider.test.d.ts.map

package/dist/components/ExtensibleWrapper/UrlExtensionProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrlExtensionProvider.test.d.ts","sourceRoot":"","sources":["../../../src/components/ExtensibleWrapper/UrlExtensionProvider.test.ts"],"names":[],"mappings":""}

package/dist/components/ExtensibleWrapper/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./ExtensibleWrapper";
+export * from "./UrlExtensionProvider";
+export * from "./ExtensionManagerProvider";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/ExtensibleWrapper/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/ExtensibleWrapper/index.ts"],"names":[],"mappings":"AAYA,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC"}

package/dist/components/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./Extensible.js";
 export * from "./GuestUIFrame.js";
 export * from "./ExtensibleComponentBoundary.js";
+export * from "./ExtensibleWrapper/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAYA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAYA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC"}

package/dist/index.js

@@ -192,6 +192,246 @@ var ExtensibleComponentBoundary = ({
 }) => {
   return /* @__PURE__ */ React__default.default.createElement(ExtensibleComponentBoundaryContext.Provider, { value: extensionPoints }, children);
 };
+var EXTENSION_MANAGER_URL_PROD = "https://aemx-mngr.adobe.io";
+var EXTENSION_MANAGER_URL_STAGE = "https://aemx-mngr-stage.adobe.io";
+var APP_REGISTRY_URL_PROD = "https://appregistry.adobe.io";
+var APP_REGISTRY_URL_STAGE = "https://appregistry-stage.adobe.io";
+var getExtensionRegistryBaseUrl = (environment, registry) => environment === "prod" ? APP_REGISTRY_URL_PROD : registry != null ? registry : APP_REGISTRY_URL_STAGE;
+var getExtensionManagerBaseUrl = (environment, extensionManager) => environment === "prod" ? EXTENSION_MANAGER_URL_PROD : extensionManager != null ? extensionManager : EXTENSION_MANAGER_URL_STAGE;
+function extractProgramIdEnvId(repo) {
+  const regex = /p(\d+)-e(\d+)/;
+  const match = regex.exec(repo);
+  if (!match) {
+    throw new Error("Error parsing a repo value");
+  }
+  return {
+    programId: match[1],
+    envId: match[2]
+  };
+}
+function buildExtensionManagerUrl(config) {
+  const scope = config.scope ? Object.fromEntries(
+    Object.entries(config.scope).map(([k, v]) => [`scope.${k}`, v])
+  ) : {};
+  const extensionPoints = `${config.service}/${config.extensionPoint}/${config.version}`;
+  const queryParams = new URLSearchParams({
+    ...scope,
+    extensionPoints
+  });
+  return `${config.baseUrl}/v2/extensions?${queryParams.toString()}`;
+}
+async function fetchExtensionsFromExtensionManager(config) {
+  const resp = await fetch(buildExtensionManagerUrl(config), {
+    headers: {
+      Authorization: `Bearer ${config.auth.imsToken}`,
+      "x-api-key": config.apiKey,
+      "x-org-id": config.imsOrg
+    }
+  });
+  if (resp.status !== 200) {
+    throw new Error(
+      `Extension Manager returned non-200 response (${resp.status}): ${await resp.text()}`
+    );
+  }
+  return resp.json();
+}
+function mergeExtensions(appRegistryExtensions, extensionManagerExtensions, extensionPointId) {
+  const mergedExtensions = Object.assign(
+    appRegistryExtensions,
+    {}
+  );
+  extensionManagerExtensions.forEach((extension) => {
+    if (extension.disabled) {
+      delete mergedExtensions[extension.name];
+    } else {
+      const extPoint = extension.extensionPoints.find(
+        (_extensionPoint) => _extensionPoint.extensionPoint === `${extensionPointId.service}/${extensionPointId.name}/${extensionPointId.version}`
+      );
+      if (extPoint) {
+        mergedExtensions[extension.name] = {
+          id: extension.name,
+          url: extPoint.url,
+          configuration: extension.configuration,
+          extensionPoints: extension.extensionPoints.map(
+            (point) => point.extensionPoint
+          )
+        };
+      } else {
+        console.warn(
+          `Extension point ${extensionPointId.service}/${extensionPointId.name}/${extensionPointId.version} not found for extension ${extension.name}`
+        );
+      }
+    }
+  });
+  return mergedExtensions;
+}
+async function getExtensionManagerExtensions(discoveryConfig, authConfig, providerConfig, extensionPointId) {
+  const config = {
+    apiKey: authConfig.apiKey,
+    auth: {
+      schema: "Bearer",
+      imsToken: authConfig.imsToken
+    },
+    service: extensionPointId.service,
+    extensionPoint: extensionPointId.name,
+    version: extensionPointId.version,
+    imsOrg: authConfig.imsOrg,
+    scope: discoveryConfig.scope
+  };
+  const appRegistryConfig = {
+    ...config,
+    baseUrl: getExtensionRegistryBaseUrl(
+      discoveryConfig.experienceShellEnvironment,
+      providerConfig.appRegistryUrl
+    )
+  };
+  const appRegistryExtensionsProvider = uixHost.createExtensionRegistryAsObjectsProvider(appRegistryConfig);
+  const extensionManagerConfiguration = {
+    ...config,
+    baseUrl: getExtensionManagerBaseUrl(
+      discoveryConfig.experienceShellEnvironment,
+      providerConfig.extensionManagerUrl
+    )
+  };
+  const [appRegistryExtensions, extensionManagerExtensions] = await Promise.all(
+    [
+      appRegistryExtensionsProvider(),
+      providerConfig.disableExtensionManager ? [] : fetchExtensionsFromExtensionManager(extensionManagerConfiguration)
+    ]
+  );
+  if (providerConfig.disableExtensionManager) {
+    return appRegistryExtensions;
+  } else {
+    return mergeExtensions(
+      appRegistryExtensions,
+      extensionManagerExtensions,
+      extensionPointId
+    );
+  }
+}
+function createExtensionManagerExtensionsProvider(discoveryConfig, authConfig, providerConfig, extensionPointId) {
+  return () => {
+    return getExtensionManagerExtensions(
+      discoveryConfig,
+      authConfig,
+      providerConfig,
+      extensionPointId
+    );
+  };
+}
+
+// src/components/ExtensibleWrapper/UrlExtensionProvider.ts
+var EXT_PARAM_PREFIX = "ext";
+function extractExtUrlParams(queryString) {
+  if (!queryString) {
+    return {};
+  }
+  const params = new URLSearchParams(queryString);
+  return Array.from(params.entries()).reduce((extParams, [key, value]) => {
+    if (key === EXT_PARAM_PREFIX || key.startsWith(`${EXT_PARAM_PREFIX}.`)) {
+      extParams[key] = value;
+    }
+    return extParams;
+  }, {});
+}
+function generateExtensionId(extensionUrl) {
+  return extensionUrl.replace(/\W/g, "_");
+}
+function createUrlExtensionsProvider(extensionPointId, queryString) {
+  const extUrlParams = extractExtUrlParams(queryString);
+  const extensionUrls = Object.keys(extUrlParams).filter(
+    (extParam) => extParam === EXT_PARAM_PREFIX || extParam === `${EXT_PARAM_PREFIX}.${extensionPointId.service}/${extensionPointId.name}/${extensionPointId.version}`
+  ).flatMap((extParam) => {
+    const paramValue = extUrlParams[extParam];
+    return Array.isArray(paramValue) ? paramValue : [paramValue];
+  });
+  const installedExtensions = extensionUrls.map((extensionUrl) => {
+    return {
+      id: generateExtensionId(extensionUrl),
+      url: extensionUrl,
+      extensionPoints: [
+        `${extensionPointId.service}/${extensionPointId.name}/${extensionPointId.version}`
+      ]
+    };
+  }).reduce((acc, extension) => {
+    acc[extension.id] = extension;
+    return acc;
+  }, {});
+  return async () => installedExtensions;
+}
+
+// src/components/ExtensibleWrapper/ExtensibleWrapper.tsx
+var ExtensibleWrapper = ({
+  appName,
+  children,
+  guestOptions,
+  runtimeContainer,
+  debug,
+  sharedContext,
+  experienceShellEnvironment,
+  queryString,
+  service,
+  extensionPoint,
+  version,
+  disableExtensionManager,
+  authConfig,
+  scope
+}) => {
+  const defaultExtensionsProvider = React.useMemo(() => {
+    const extensionPointId = {
+      service,
+      name: extensionPoint,
+      version
+    };
+    const params = new URLSearchParams(queryString != null ? queryString : "");
+    const extensionManagerUrlOverride = params.get("em");
+    const appRegistryUrlOverride = params.get("er");
+    const urlExtensionsProvider = createUrlExtensionsProvider(extensionPointId, queryString);
+    const providerConfig = {
+      disableExtensionManager
+    };
+    if (extensionManagerUrlOverride) {
+      providerConfig.extensionManagerUrl = extensionManagerUrlOverride;
+    }
+    if (appRegistryUrlOverride) {
+      providerConfig.appRegistryUrl = appRegistryUrlOverride;
+    }
+    const extensionManagerExtensionsProvider = createExtensionManagerExtensionsProvider(
+      {
+        experienceShellEnvironment,
+        scope
+      },
+      authConfig,
+      providerConfig,
+      extensionPointId
+    );
+    return uixHost.combineExtensionsFromProviders(
+      urlExtensionsProvider,
+      uixHost.mutedProvider(extensionManagerExtensionsProvider)
+    );
+  }, [
+    experienceShellEnvironment,
+    queryString,
+    service,
+    extensionPoint,
+    version,
+    disableExtensionManager,
+    authConfig,
+    scope
+  ]);
+  return /* @__PURE__ */ React__default.default.createElement(
+    Extensible,
+    {
+      extensionsProvider: defaultExtensionsProvider,
+      appName,
+      runtimeContainer,
+      debug,
+      guestOptions,
+      sharedContext
+    },
+    children
+  );
+};
 var NO_EXTENSIONS = [];
 function useExtensions(configFactory, deps = []) {
   const { host, error } = useHost();
@@ -292,9 +532,20 @@ function useExtensionListFetched() {
 exports.Extensible = Extensible;
 exports.ExtensibleComponentBoundary = ExtensibleComponentBoundary;
 exports.ExtensibleComponentBoundaryContext = ExtensibleComponentBoundaryContext;
+exports.ExtensibleWrapper = ExtensibleWrapper;
 exports.ExtensionContext = ExtensionContext;
 exports.GuestUIFrame = GuestUIFrame;
 exports.OutsideOfExtensionContextError = OutsideOfExtensionContextError;
+exports.buildExtensionManagerUrl = buildExtensionManagerUrl;
+exports.createExtensionManagerExtensionsProvider = createExtensionManagerExtensionsProvider;
+exports.createUrlExtensionsProvider = createUrlExtensionsProvider;
+exports.extractExtUrlParams = extractExtUrlParams;
+exports.extractProgramIdEnvId = extractProgramIdEnvId;
+exports.fetchExtensionsFromExtensionManager = fetchExtensionsFromExtensionManager;
+exports.generateExtensionId = generateExtensionId;
+exports.getExtensionManagerBaseUrl = getExtensionManagerBaseUrl;
+exports.getExtensionRegistryBaseUrl = getExtensionRegistryBaseUrl;
+exports.mergeExtensions = mergeExtensions;
 exports.useExtensionListFetched = useExtensionListFetched;
 exports.useExtensions = useExtensions;
 exports.useHost = useHost;