@softarc/native-federation 4.4.0 → 4.4.1

package/dist/lib/core/build/assemble-federation-info.d.ts

@@ -0,0 +1,8 @@
+import type { ArtifactInfo, FederationInfo } from '../../domain/core/federation-info.contract.js';
+import type { NormalizedFederationConfig } from '../../domain/config/federation-config.contract.js';
+import type { NormalizedFederationOptions } from '../../domain/core/federation-options.contract.js';
+/**
+ * Derives the `remoteEntry.json` payload from the populated federation cache. Shared by the initial
+ * build and the watch rebuild.
+ */
+export declare function assembleFederationInfo(config: NormalizedFederationConfig, fedOptions: NormalizedFederationOptions, artifactInfo: ArtifactInfo): FederationInfo;

package/dist/lib/core/build/assemble-federation-info.js

@@ -0,0 +1,34 @@
+import { densifyExternals } from "../output/densify-externals.js";
+function assembleFederationInfo(config, fedOptions, artifactInfo) {
+  const federationCache = fedOptions.federationCache;
+  const sharedExternals = applyShareScope(
+    [...federationCache.externals, ...artifactInfo.mappings],
+    config.shareScope
+  );
+  const federationInfo = {
+    name: config.name,
+    shared: config.features.denseExternals ? densifyExternals(sharedExternals) : sharedExternals,
+    exposes: artifactInfo.exposes,
+    buildNotificationsEndpoint: fedOptions.buildNotifications?.enable && fedOptions.dev ? fedOptions.buildNotifications?.endpoint : void 0
+  };
+  if (federationCache.chunks) {
+    federationInfo.chunks = federationCache.chunks;
+  }
+  if (artifactInfo.chunks) {
+    federationInfo.chunks = { ...federationInfo.chunks ?? {}, ...artifactInfo.chunks };
+  }
+  if (config.features.integrityHashes) {
+    federationInfo.integrity = {
+      ...federationCache.integrity ?? {},
+      ...artifactInfo.integrity ?? {}
+    };
+  }
+  return federationInfo;
+}
+function applyShareScope(externals, shareScope) {
+  if (!shareScope) return externals;
+  return externals.map((external) => external.shareScope ? external : { ...external, shareScope });
+}
+export {
+  assembleFederationInfo
+};

package/dist/lib/core/build/build-for-federation.js

@@ -1,22 +1,12 @@
-import {
-  bundleExposedAndMappings,
-  describeExposed,
-  describeSharedMappings
-} from "./bundle-exposed-and-mappings.js";
+import { bundleExposedAndMappings } from "./bundle-exposed-and-mappings.js";
 import { bundleShared } from "./bundle-shared.js";
-import { densifyExternals } from "../output/densify-externals.js";
-import { writeFederationInfo } from "../output/write-federation-info.js";
-import { writeImportMap } from "../output/write-import-map.js";
+import { assembleFederationInfo } from "./assemble-federation-info.js";
+import { writeFederationOutputs } from "../output/write-federation-outputs.js";
 import { logger } from "../../utils/logger.js";
 import { AbortedError } from "../../utils/errors.js";
 import { addExternalsToCache } from "../cache/federation-cache.js";
 import { planSharedBundles } from "./shared-bundle-plan.js";
-import path from "path";
 async function buildForFederation(config, fedOptions, externals, signal) {
-  fedOptions.federationCache.cachePath = path.join(
-    fedOptions.federationCache.cachePath,
-    fedOptions.projectName
-  );
   logger.info("Building federation artifacts");
   logger.notice("Skip packages you don't want to share in your federation config");
   await executeSharedBundlePlans(planSharedBundles(config, externals), config, fedOptions, signal);
@@ -31,36 +21,8 @@ async function buildForFederation(config, fedOptions, externals, signal) {
   logger.measure(start, "Step 3) Bundling all internal libraries and exposed modules.");
   if (signal?.aborted)
     throw new AbortedError("[buildForFederation] After exposed-and-mappings bundle");
-  const exposedInfo = !artifactInfo ? describeExposed(config, fedOptions) : artifactInfo.exposes;
-  const sharedMappingInfo = !artifactInfo ? describeSharedMappings(config, fedOptions) : artifactInfo.mappings;
-  const sharedExternals = [...fedOptions.federationCache.externals, ...sharedMappingInfo];
-  if (config?.shareScope) {
-    Object.values(sharedExternals).forEach((external) => {
-      if (!external.shareScope) external.shareScope = config.shareScope;
-    });
-  }
-  const shared = config.features.denseExternals ? densifyExternals(sharedExternals) : sharedExternals;
-  const buildNotificationsEndpoint = fedOptions.buildNotifications?.enable && fedOptions.dev ? fedOptions.buildNotifications?.endpoint : void 0;
-  const federationInfo = {
-    name: config.name,
-    shared,
-    exposes: exposedInfo,
-    buildNotificationsEndpoint
-  };
-  if (fedOptions.federationCache.chunks) {
-    federationInfo.chunks = fedOptions.federationCache.chunks;
-  }
-  if (artifactInfo?.chunks) {
-    federationInfo.chunks = { ...federationInfo.chunks ?? {}, ...artifactInfo?.chunks };
-  }
-  if (config.features.integrityHashes) {
-    federationInfo.integrity = {
-      ...fedOptions.federationCache.integrity ?? {},
-      ...artifactInfo?.integrity ?? {}
-    };
-  }
-  writeFederationInfo(federationInfo, fedOptions);
-  writeImportMap(fedOptions.federationCache, fedOptions, federationInfo.integrity);
+  const federationInfo = assembleFederationInfo(config, fedOptions, artifactInfo);
+  writeFederationOutputs(federationInfo, fedOptions);
   return federationInfo;
 }
 async function executeSharedBundlePlans(plans, config, fedOptions, signal) {
@@ -75,7 +37,7 @@ async function executeSharedBundlePlans(plans, config, fedOptions, signal) {
     logger.measure(start, `Step 2.1) Bundling '${plan.bundleName}' externals`);
     addExternalsToCache(fedOptions.federationCache, info);
     if (signal?.aborted)
-      throw new AbortedError(`[buildForFederation] After ${plan.bundleName} bundle`);
+      throw new AbortedError(`[executeSharedBundlePlans] After ${plan.bundleName} bundle`);
   }
   const separatePlans = plans.filter((p) => p.kind === "separate");
   if (separatePlans.length > 0) {
@@ -91,7 +53,7 @@ async function executeSharedBundlePlans(plans, config, fedOptions, signal) {
     );
     logger.measure(start, "Step 2.2) Bundling all separate external packages");
     for (const info of results) addExternalsToCache(fedOptions.federationCache, info);
-    if (signal?.aborted) throw new AbortedError("[buildForFederation] After separate bundle");
+    if (signal?.aborted) throw new AbortedError("[executeSharedBundlePlans] After separate bundle");
   }
 }
 export {

package/dist/lib/core/build/bundle-exposed-and-mappings.d.ts

@@ -1,4 +1,4 @@
-import type { ArtifactInfo, ExposesInfo, SharedInfo } from '../../domain/core/federation-info.contract.js';
+import type { ArtifactInfo } from '../../domain/core/federation-info.contract.js';
 import type { FileReaderPort } from '../../domain/utils/io-port.contract.js';
 import type { NormalizedFederationConfig } from '../../domain/config/federation-config.contract.js';
 import { type NormalizedFederationOptions } from '../../domain/core/federation-options.contract.js';
@@ -7,7 +7,5 @@ export declare function bundleExposedAndMappings(config: NormalizedFederationCon
 export declare function bundleExposedAndMappingsCore(deps: {
     adapter: NFBuildAdapter;
 }, config: NormalizedFederationConfig, fedOptions: NormalizedFederationOptions, externals: string[], modifiedFiles?: string[], signal?: AbortSignal): Promise<ArtifactInfo>;
-export declare function describeExposed(config: NormalizedFederationConfig, options: NormalizedFederationOptions): Array<ExposesInfo>;
-export declare function describeSharedMappings(config: NormalizedFederationConfig, fedOptions: NormalizedFederationOptions): Array<SharedInfo>;
 export declare function getMappingVersionCore(io: FileReaderPort, fileName: string, workspaceRoot: string): string;
 export declare function getMappingVersion(fileName: string, workspaceRoot: string): string;

package/dist/lib/core/build/bundle-exposed-and-mappings.js

@@ -115,29 +115,6 @@ async function bundleExposedAndMappingsCore(deps, config, fedOptions, externals,
   const integrity = config.features.integrityHashes ? computeIntegrityMap([...entryFiles, ...chunkPaths], "") : void 0;
   return { mappings: sharedResult, exposes: exposedResult, chunks: exportedChunks, integrity };
 }
-function describeExposed(config, options) {
-  const result = [];
-  for (const key in config.exposes) {
-    const expose = config.exposes[key];
-    const localPath = normalize(path.normalize(path.join(options.workspaceRoot, expose.file)));
-    result.push({
-      key,
-      outFileName: "",
-      ...expose.element && { element: expose.element },
-      dev: !options.dev ? void 0 : {
-        entryPoint: localPath
-      }
-    });
-  }
-  return result;
-}
-function describeSharedMappings(config, fedOptions) {
-  const result = [];
-  for (const [mappedPath, mappedImport] of Object.entries(config.sharedMappings)) {
-    result.push(toSharedMappingInfo(mappedPath, mappedImport, "", config, fedOptions));
-  }
-  return result;
-}
 function toSharedMappingInfo(mappedPath, mappedImport, outFileName, config, fedOptions) {
   const mappingVersion = config.features.mappingVersion ? getMappingVersion(mappedPath, fedOptions.workspaceRoot) : "";
   const mappingConfig = resolveMappingConfig(
@@ -184,8 +161,6 @@ function getMappingVersion(fileName, workspaceRoot) {
 export {
   bundleExposedAndMappings,
   bundleExposedAndMappingsCore,
-  describeExposed,
-  describeSharedMappings,
   getMappingVersion,
   getMappingVersionCore
 };

package/dist/lib/core/build/rebuild-for-federation.js

@@ -1,10 +1,6 @@
-import {
-  bundleExposedAndMappings,
-  describeExposed,
-  describeSharedMappings
-} from "./bundle-exposed-and-mappings.js";
-import { writeFederationInfo } from "../output/write-federation-info.js";
-import { writeImportMap } from "../output/write-import-map.js";
+import { bundleExposedAndMappings } from "./bundle-exposed-and-mappings.js";
+import { assembleFederationInfo } from "./assemble-federation-info.js";
+import { writeFederationOutputs } from "../output/write-federation-outputs.js";
 import { logger } from "../../utils/logger.js";
 import { AbortedError } from "../../utils/errors.js";
 import { planSharedBundles } from "./shared-bundle-plan.js";
@@ -14,7 +10,6 @@ import { cacheEntryCore, getFilename } from "../cache/cache-persistence.js";
 import { nodeIo } from "../../utils/io/node-io-adapter.js";
 import { sharedPackageJsonRepository } from "../../utils/package/package-info.js";
 async function rebuildForFederation(config, fedOptions, externals, modifiedFiles, signal) {
-  const federationCache = fedOptions.federationCache;
   await rebuildAffectedExternals(config, fedOptions, externals, modifiedFiles, signal);
   logger.info(`Re-bundling all internal libraries and exposed modules..'`);
   const start = process.hrtime();
@@ -27,31 +22,9 @@ async function rebuildForFederation(config, fedOptions, externals, modifiedFiles
   );
   logger.measure(start, "To re-bundle all internal libraries and exposed modules.");
   if (signal?.aborted)
-    throw new AbortedError("[buildForFederation] After exposed-and-mappings bundle");
-  const exposedInfo = !artifactInfo ? describeExposed(config, fedOptions) : artifactInfo.exposes;
-  const sharedMappingInfo = !artifactInfo ? describeSharedMappings(config, fedOptions) : artifactInfo.mappings;
-  const sharedExternals = [...federationCache.externals, ...sharedMappingInfo];
-  const buildNotificationsEndpoint = fedOptions.buildNotifications?.enable && fedOptions.dev ? fedOptions.buildNotifications?.endpoint : void 0;
-  const federationInfo = {
-    name: config.name,
-    shared: sharedExternals,
-    exposes: exposedInfo,
-    buildNotificationsEndpoint
-  };
-  if (federationCache.chunks) {
-    federationInfo.chunks = federationCache.chunks;
-  }
-  if (artifactInfo?.chunks) {
-    federationInfo.chunks = { ...federationInfo.chunks ?? {}, ...artifactInfo?.chunks };
-  }
-  if (config.features.integrityHashes) {
-    federationInfo.integrity = {
-      ...federationCache.integrity ?? {},
-      ...artifactInfo?.integrity ?? {}
-    };
-  }
-  writeFederationInfo(federationInfo, fedOptions);
-  writeImportMap(federationCache, fedOptions, federationInfo.integrity);
+    throw new AbortedError("[rebuildForFederation] After exposed-and-mappings bundle");
+  const federationInfo = assembleFederationInfo(config, fedOptions, artifactInfo);
+  writeFederationOutputs(federationInfo, fedOptions);
   return federationInfo;
 }
 async function rebuildAffectedExternals(config, fedOptions, externals, modifiedFiles, signal, io = nodeIo, repo = sharedPackageJsonRepository) {

package/dist/lib/core/normalize-options.js

@@ -23,13 +23,19 @@ async function normalizeFederationOptionsCore(deps, options, cache) {
     throw new Error("Expected " + fullConfigPath);
   }
   let config = await deps.loadConfig(fullConfigPath);
-  const federationCache = cache ?? createFederationCache(
+  const projectName = resolveProjectName(options.projectName ?? config.name);
+  const suppliedCache = cache ?? createFederationCache(
     getDefaultCachePath(options.workspaceRoot)
   );
+  const federationCache = {
+    ...suppliedCache,
+    cachePath: path.join(suppliedCache.cachePath, projectName),
+    externals: [...suppliedCache.externals]
+  };
   const normalizedOptions = {
     ...options,
     entryPoints: options.entryPoints ?? Object.values(config.exposes ?? {}).map((e) => e.file),
-    projectName: resolveProjectName(options.projectName ?? config.name),
+    projectName,
     cacheExternalArtifacts: options.cacheExternalArtifacts ?? true,
     federationCache
   };

package/dist/lib/core/output/write-federation-outputs.d.ts

@@ -0,0 +1,7 @@
+import type { FederationInfo } from '../../domain/core/federation-info.contract.js';
+import type { NormalizedFederationOptions } from '../../domain/core/federation-options.contract.js';
+/**
+ * The import map is built from the flat federation cache rather than `federationInfo.shared`: a
+ * dense group has no import-map representation, every specifier needs its own entry.
+ */
+export declare function writeFederationOutputs(federationInfo: FederationInfo, fedOptions: NormalizedFederationOptions): void;

package/dist/lib/core/output/write-federation-outputs.js

@@ -0,0 +1,9 @@
+import { writeFederationInfo } from "./write-federation-info.js";
+import { writeImportMap } from "./write-import-map.js";
+function writeFederationOutputs(federationInfo, fedOptions) {
+  writeFederationInfo(federationInfo, fedOptions);
+  writeImportMap(fedOptions.federationCache, fedOptions, federationInfo.integrity);
+}
+export {
+  writeFederationOutputs
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softarc/native-federation",
-  "version": "4.4.0",
+  "version": "4.4.1",
   "type": "module",
   "license": "MIT",
   "packageManager": "pnpm@11.18.0",