@softarc/native-federation 4.1.1 → 4.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softarc/native-federation",
-  "version": "4.1.1",
+  "version": "4.1.3",
   "type": "module",
   "license": "MIT",
   "dependencies": {

package/src/config.d.ts

@@ -1,4 +1,4 @@
 export * from './lib/domain/config/index.js';
 export { withNativeFederation } from './lib/config/with-native-federation.js';
-export { findRootTsConfigJson, share, shareAll } from './lib/config/share-utils.js';
+export { findRootTsConfigJson, share, shareAll, setInferVersion, } from './lib/config/share-utils.js';
 export { DEFAULT_SKIP_LIST } from './lib/config/default-skip-list.js';

package/src/config.js

@@ -1,4 +1,4 @@
 export * from './lib/domain/config/index.js';
 export { withNativeFederation } from './lib/config/with-native-federation.js';
-export { findRootTsConfigJson, share, shareAll } from './lib/config/share-utils.js';
+export { findRootTsConfigJson, share, shareAll, setInferVersion, } from './lib/config/share-utils.js';
 export { DEFAULT_SKIP_LIST } from './lib/config/default-skip-list.js';

package/src/lib/config/share-utils.js

@@ -264,7 +264,8 @@ export function share(configuredShareObjects, projectPath = '', skipList = DEFAU
         includeSecondaries = false;
         const shareObject = shareObjects[key];
         if (shareObject.requiredVersion === 'auto' ||
-            (inferVersion && typeof shareObject.requiredVersion === 'undefined')) {
+            (inferVersion && typeof shareObject.requiredVersion === 'undefined') ||
+            shareObject.requiredVersion.length < 1) {
             const version = lookupVersion(key, projectPath);
             shareObject.requiredVersion = version;
             shareObject.version = version.replace(/^\D*/, '');

package/src/lib/config/with-native-federation.js

@@ -8,7 +8,7 @@ export function withNativeFederation(config) {
     const normalized = {
         $type: 'classic',
         name: config.name ?? '',
-        exposes: config.exposes ?? {},
+        exposes: normalizeExposes(config.exposes),
         shared: normalizeShared(config, skip, chunks),
         sharedMappings: removeSkippedMappings(config, skip),
         chunks,
@@ -18,11 +18,20 @@ export function withNativeFederation(config) {
             mappingVersion: config.features?.mappingVersion ?? true,
             ignoreUnusedDeps: config.features?.ignoreUnusedDeps ?? true,
             denseChunking: config.features?.denseChunking ?? false,
+            integrityHashes: config.features?.integrityHashes ?? false,
         },
         ...(config.shareScope && { shareScope: config.shareScope }),
     };
     return normalized;
 }
+function normalizeExposes(exposes) {
+    if (!exposes)
+        return {};
+    return Object.fromEntries(Object.entries(exposes).map(([key, value]) => [
+        key,
+        typeof value === 'string' ? { file: value } : value,
+    ]));
+}
 function normalizeShared(config, skip, chunks) {
     let result = {};
     const shared = config.shared ??

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

@@ -87,7 +87,7 @@ export async function buildForFederation(config, fedOptions, externals, signal)
     if (artifactInfo?.chunks) {
         federationInfo.chunks = { ...(federationInfo.chunks ?? {}), ...artifactInfo?.chunks };
     }
-    if (fedOptions.integrity) {
+    if (config.features.integrityHashes) {
         federationInfo.integrity = {
             ...(fedOptions.federationCache.integrity ?? {}),
             ...(artifactInfo?.integrity ?? {}),

package/src/lib/core/bundle-exposed-and-mappings.js

@@ -18,9 +18,9 @@ export async function bundleExposedAndMappings(config, fedOptions, externals, mo
             key: mappedImport,
         };
     });
-    const exposes = Object.entries(config.exposes).map(([key, entry]) => {
+    const exposes = Object.entries(config.exposes).map(([key, expose]) => {
         const outFilePath = key + '.js';
-        return { fileName: entry, outName: outFilePath, key };
+        return { fileName: expose.file, outName: outFilePath, key, element: expose.element };
     });
     const entryPoints = [...shared, ...exposes];
     const hash = !fedOptions.dev;
@@ -75,6 +75,7 @@ export async function bundleExposedAndMappings(config, fedOptions, externals, mo
         exposedResult.push({
             key: item.key,
             outFileName: path.basename(distEntryFile),
+            ...(item.element && { element: item.element }),
             dev: !fedOptions.dev
                 ? undefined
                 : {
@@ -100,7 +101,7 @@ export async function bundleExposedAndMappings(config, fedOptions, externals, mo
     }
     // Must run after rewriteChunkImports so SRI matches the final on-disk bytes.
     let integrity;
-    if (fedOptions.integrity) {
+    if (config.features.integrityHashes) {
         integrity = {};
         for (const filePath of [...entryFiles, ...chunkPaths]) {
             if (!fs.existsSync(filePath))
@@ -113,10 +114,12 @@ export async function bundleExposedAndMappings(config, fedOptions, externals, mo
 export function describeExposed(config, options) {
     const result = [];
     for (const key in config.exposes) {
-        const localPath = normalize(path.normalize(path.join(options.workspaceRoot, config.exposes[key])));
+        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
                 ? undefined
                 : {

package/src/lib/core/bundle-shared.js

@@ -22,7 +22,7 @@ export async function bundleShared(sharedBundles, config, fedOptions, externals,
             logger.debug(`Checksum of ${buildOptions.bundleName} matched, Skipped artifact bundling`);
             bundleCache.copyFiles(path.join(fedOptions.workspaceRoot, fedOptions.outputPath));
             let integrity = cacheMetadata.integrity;
-            if (fedOptions.integrity && !integrity) {
+            if (config.features.integrityHashes && !integrity) {
                 integrity = computeIntegrityForFiles(cacheMetadata.files, fedOptions.federationCache.cachePath);
             }
             return {
@@ -122,7 +122,7 @@ export async function bundleShared(sharedBundles, config, fedOptions, externals,
     }
     const persistedFiles = bundleResult.map(r => r.fileName.split(path.sep).pop() ?? r.fileName);
     // Must run after rewriteImports so SRI matches the bytes copied to dist.
-    const integrity = fedOptions.integrity
+    const integrity = config.features.integrityHashes
         ? computeIntegrityForFiles(persistedFiles, fedOptions.federationCache.cachePath)
         : undefined;
     bundleCache.persist({

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

@@ -25,7 +25,7 @@ export async function normalizeFederationOptions(options, cache) {
         createFederationCache(getDefaultCachePath(options.workspaceRoot));
     const normalizedOptions = {
         ...options,
-        entryPoints: options.entryPoints ?? Object.values(config.exposes ?? {}),
+        entryPoints: options.entryPoints ?? Object.values(config.exposes ?? {}).map(e => e.file),
         projectName: resolveProjectName(options.projectName ?? config.name),
         cacheExternalArtifacts: options.cacheExternalArtifacts ?? true,
         federationCache,

package/src/lib/core/rebuild-for-federation.js

@@ -31,7 +31,7 @@ export async function rebuildForFederation(config, fedOptions, externals, modifi
     if (artifactInfo?.chunks) {
         federationInfo.chunks = { ...(federationInfo.chunks ?? {}), ...artifactInfo?.chunks };
     }
-    if (fedOptions.integrity) {
+    if (config.features.integrityHashes) {
         federationInfo.integrity = {
             ...(federationCache.integrity ?? {}),
             ...(artifactInfo?.integrity ?? {}),

package/src/lib/domain/config/federation-config.contract.d.ts

@@ -1,9 +1,13 @@
 import type { PreparedSkipList, SkipList } from './skip-list.contract.js';
 import type { PathToImport } from '../utils/mapped-path.contract.js';
 import type { NormalizedSharedExternalsConfig, SharedExternalsConfig } from './external-config.contract.js';
+export type ExposeEntry = {
+    file: string;
+    element?: string;
+};
 export interface FederationConfig {
     name?: string;
-    exposes?: Record<string, string>;
+    exposes?: Record<string, string | ExposeEntry>;
     shared?: SharedExternalsConfig;
     platform?: 'browser' | 'node';
     sharedMappings?: Array<string>;
@@ -15,12 +19,13 @@ export interface FederationConfig {
         mappingVersion?: boolean;
         ignoreUnusedDeps?: boolean;
         denseChunking?: boolean;
+        integrityHashes?: boolean;
     };
 }
 export interface NormalizedFederationConfig {
     $type: 'classic';
     name: string;
-    exposes: Record<string, string>;
+    exposes: Record<string, ExposeEntry>;
     shared: NormalizedSharedExternalsConfig;
     sharedMappings: PathToImport;
     skip: PreparedSkipList;
@@ -31,5 +36,6 @@ export interface NormalizedFederationConfig {
         mappingVersion: boolean;
         ignoreUnusedDeps: boolean;
         denseChunking: boolean;
+        integrityHashes: boolean;
     };
 }

package/src/lib/domain/core/federation-info.contract.d.ts

@@ -24,6 +24,7 @@ export type IntegrityMap = Record<string, string>;
 export interface ExposesInfo {
     key: string;
     outFileName: string;
+    element?: string;
     dev?: {
         entryPoint: string;
     };

package/src/lib/domain/core/federation-options.contract.d.ts

@@ -13,7 +13,6 @@ export interface FederationOptions {
     packageJson?: string;
     entryPoints?: string[];
     buildNotifications?: BuildNotificationOptions;
-    integrity?: boolean;
 }
 export interface NormalizedFederationOptions<TBundlerCache = unknown> extends FederationOptions {
     federationCache: FederationCache<TBundlerCache>;

package/src/lib/domain/core/index.d.ts

@@ -4,3 +4,4 @@ export type { FederationOptions, NormalizedFederationOptions, } from './federati
 export type { EntryPoint, NFBuildAdapterOptions, NFBuildAdapter, NFBuildAdapterResult, NFBuildAdapterContext, } from './build-adapter.contract.js';
 export { CHUNK_PREFIX, toChunkImport } from './chunk.js';
 export type { FederationCache } from './federation-cache.contract.js';
+export type { FederationManifest } from './manifest.contract.js';

package/src/lib/domain/core/manifest.contract.d.ts

@@ -0,0 +1,5 @@
+export type FederationManifest = Record<string, string | {
+    url: string;
+    integrity?: string;
+    main?: string;
+}>;

package/src/lib/domain/core/manifest.contract.js

@@ -0,0 +1 @@
+export {};

package/src/lib/utils/get-used-dependencies.d.ts

@@ -1,7 +1,8 @@
 import { type PathToImport } from '../domain/utils/mapped-path.contract.js';
 import { type UsedDependencies } from '../domain/utils/used-dependencies.contract.js';
+import { type ExposeEntry } from '../domain/config/federation-config.contract.js';
 export declare function getUsedDependenciesFactory(workspaceRoot: string, fallbackEntryPoints?: string[]): (config: {
     name?: string;
-    exposes?: Record<string, string>;
+    exposes?: Record<string, ExposeEntry>;
     sharedMappings: PathToImport;
 }) => UsedDependencies;

package/src/lib/utils/get-used-dependencies.js

@@ -5,7 +5,7 @@ import { getExternalImports as extractExternalImports } from './get-external-imp
 import * as path from 'path';
 export function getUsedDependenciesFactory(workspaceRoot, fallbackEntryPoints) {
     return config => {
-        let entryPoints = Object.values(config.exposes ?? {});
+        let entryPoints = Object.values(config.exposes ?? {}).map(e => e.file);
         if (entryPoints.length < 1)
             entryPoints = fallbackEntryPoints;
         if (!entryPoints || entryPoints.length < 1)