@nx/module-federation/src/utils/remotes.js

The Nx Plugin for Module Federation contains executors and utilities that support building applications using Module Federation.

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.mapRemotes = mapRemotes;
exports.mapRemotesForSSR = mapRemotesForSSR;
const path_1 = require("path");
/**
 * Map remote names to a format that can be understood and used by Module
 * Federation.
 *
 * @param remotes - The remotes to map
 * @param remoteEntryExt - The file extension of the remoteEntry file
 * @param determineRemoteUrl - The function used to lookup the URL of the served remote
 */
function mapRemotes(remotes, remoteEntryExt, determineRemoteUrl, isRemoteGlobal = false) {
    const mappedRemotes = {};
    for (const nxRemoteProjectName of remotes) {
        if (Array.isArray(nxRemoteProjectName)) {
            const mfRemoteName = normalizeRemoteName(nxRemoteProjectName[0]);
            mappedRemotes[mfRemoteName] = handleArrayRemote(nxRemoteProjectName, remoteEntryExt, isRemoteGlobal);
        }
        else if (typeof nxRemoteProjectName === 'string') {
            const mfRemoteName = normalizeRemoteName(nxRemoteProjectName);
            mappedRemotes[mfRemoteName] = handleStringRemote(nxRemoteProjectName, determineRemoteUrl, isRemoteGlobal);
        }
    }
    return mappedRemotes;
}
// Helper function to deal with remotes that are arrays
function handleArrayRemote(remote, remoteEntryExt, isRemoteGlobal) {
    const [nxRemoteProjectName, remoteLocation] = remote;
    const mfRemoteName = normalizeRemoteName(nxRemoteProjectName);
    // Remote string starts like "promise new Promise(...)" – return as-is
    if (remoteLocation.startsWith('promise new Promise')) {
        return remoteLocation;
    }
    const resolvedUrl = new URL(remoteLocation);
    const ext = (0, path_1.extname)(resolvedUrl.pathname);
    const needsRemoteEntry = !['.js', '.mjs', '.json'].includes(ext);
    if (needsRemoteEntry) {
        resolvedUrl.pathname = resolvedUrl.pathname.endsWith('/')
            ? `${resolvedUrl.pathname}remoteEntry.${remoteEntryExt}`
            : `${resolvedUrl.pathname}/remoteEntry.${remoteEntryExt}`;
    }
    const finalRemoteUrl = resolvedUrl.href;
    return isRemoteGlobal ? `${mfRemoteName}@${finalRemoteUrl}` : finalRemoteUrl;
}
// Helper function to deal with remotes that are strings
function handleStringRemote(nxRemoteProjectName, determineRemoteUrl, isRemoteGlobal) {
    const globalPrefix = isRemoteGlobal
        ? `${normalizeRemoteName(nxRemoteProjectName)}@`
        : '';
    return `${globalPrefix}${determineRemoteUrl(nxRemoteProjectName)}`;
}
/**
 * Map remote names to a format that can be understood and used by Module
 * Federation.
 *
 * @param remotes - The remotes to map
 * @param remoteEntryExt - The file extension of the remoteEntry file
 * @param determineRemoteUrl - The function used to lookup the URL of the served remote
 */
function mapRemotesForSSR(remotes, remoteEntryExt, determineRemoteUrl) {
    const mappedRemotes = {};
    for (const remote of remotes) {
        if (Array.isArray(remote)) {
            let [nxRemoteProjectName, remoteLocation] = remote;
            const mfRemoteName = normalizeRemoteName(nxRemoteProjectName);
            const resolvedUrl = new URL(remoteLocation);
            const remoteLocationExt = (0, path_1.extname)(resolvedUrl.pathname);
            const needsRemoteEntry = !['.js', '.mjs', '.json'].includes(remoteLocationExt);
            if (needsRemoteEntry) {
                resolvedUrl.pathname = resolvedUrl.pathname.endsWith('/')
                    ? `${resolvedUrl.pathname}remoteEntry.${remoteEntryExt}`
                    : `${resolvedUrl.pathname}/remoteEntry.${remoteEntryExt}`;
            }
            const finalRemoteUrl = resolvedUrl.href;
            mappedRemotes[mfRemoteName] = `${mfRemoteName}@${finalRemoteUrl}`;
        }
        else if (typeof remote === 'string') {
            const mfRemoteName = normalizeRemoteName(remote);
            mappedRemotes[mfRemoteName] = `${mfRemoteName}@${determineRemoteUrl(remote)}`;
        }
    }
    return mappedRemotes;
}
function normalizeRemoteName(remote) {
    return remote.replace(/-/g, '_');
}