@bleedingdev/modern-js-app-tools-extensions 3.9.0-ultramodern.8 → 3.9.3-ultramodern.1

package/dist/esm/workspace-topology.mjs

@@ -0,0 +1,21 @@
+import { existsSync } from "node:fs";
+import node_path from "node:path";
+const REFERENCE_TOPOLOGY_PATH = 'topology/reference-topology.json';
+const DEVELOPMENT_OVERLAY_PATH = 'topology/local-overlays/development.json';
+const normalizeRelativePath = (value)=>value.replace(/\\/gu, '/').replace(/^\.\/+/u, '');
+const distributedSsrFragmentSlug = (expose)=>{
+    const slug = expose.replace(/^\.\//u, '').trim().replace(/([a-z0-9])([A-Z])/gu, '$1-$2').replace(/[^a-zA-Z0-9._-]+/gu, '-').replace(/[._]+/gu, '-').toLowerCase().replace(/-+/gu, '-').replace(/^-+|-+$/gu, '');
+    if (!slug) throw new Error(`Invalid distributed SSR expose ${expose}.`);
+    return slug;
+};
+const distributedSsrFragmentRoute = (expose)=>`/{locale}/_mf/fragment/${distributedSsrFragmentSlug(expose)}`;
+const findWorkspaceRoot = (appDirectory)=>{
+    let current = appDirectory;
+    while(true){
+        if (existsSync(node_path.join(current, REFERENCE_TOPOLOGY_PATH))) return current;
+        const parent = node_path.dirname(current);
+        if (parent === current) return;
+        current = parent;
+    }
+};
+export { DEVELOPMENT_OVERLAY_PATH, REFERENCE_TOPOLOGY_PATH, distributedSsrFragmentRoute, distributedSsrFragmentSlug, findWorkspaceRoot, normalizeRelativePath };

package/dist/esm-node/backend-federation-build/codegen.mjs

@@ -46,28 +46,34 @@ const createBackendRemoteEntrySource = async (workspaceRoot, app, effectApiPath,
         } : {}
     };
     const source = `// Generated by Modern.js backend federation build.
-import * as exposedNamespace from ${JSON.stringify(effectApiSpecifier)};
+import { adoptEffectBffShareScope } from '@modern-js/bff-effect/effect-edge';
 
-const exposedModule = {
-  ...exposedNamespace,
-  backendFederationContract: {
-    ...(exposedNamespace.backendFederationContract ?? {}),
-    compatibility: {
-      ...(exposedNamespace.backendFederationContract?.compatibility ?? {}),
-      ...${JSON.stringify(compatibility)},
+// The expose evaluates lazily so defineEffectBff registers its handler
+// factories with the registry the host shares through init().
+let exposedModule;
+const loadExposedModule = () =>
+  (exposedModule ??= import(${JSON.stringify(effectApiSpecifier)}).then(exposedNamespace => ({
+    ...exposedNamespace,
+    backendFederationContract: {
+      ...(exposedNamespace.backendFederationContract ?? {}),
+      compatibility: {
+        ...(exposedNamespace.backendFederationContract?.compatibility ?? {}),
+        ...${JSON.stringify(compatibility)},
+      },
+      name: ${JSON.stringify(app.backendName)},
+      role: 'microvertical-server',
+      runtimeFramework: 'effect',
+      strictEffectApproach: true,
     },
-    name: ${JSON.stringify(app.backendName)},
-    role: 'microvertical-server',
-    runtimeFramework: 'effect',
-    strictEffectApproach: true,
-  },
-};
+  })));
 const exposedModules = {
-  ${JSON.stringify(BACKEND_FEDERATION_EFFECT_EXPOSE)}: () => Promise.resolve(exposedModule),
+  ${JSON.stringify(BACKEND_FEDERATION_EFFECT_EXPOSE)}: loadExposedModule,
 };
 const __modernjsBackendFederation = ${JSON.stringify(containerMetadata)};
 
-function init() {}
+function init(shareScope) {
+  return adoptEffectBffShareScope(shareScope);
+}
 
 function get(id) {
   const load = exposedModules[id];
@@ -171,8 +177,13 @@ const createBackendManifest = (workspaceRoot, distDirectory, app, entryIntegrity
             source: {
                 module: sourceModule
             },
-            readinessPath: `${app.apiPrefix}/${app.apiStem}/readiness`,
-            openapiPath: `${app.apiPrefix}/openapi.json`,
+            ...'rpc' === app.apiProtocol ? {
+                rpcPath: app.rpcPath,
+                rpcSerialization: 'json'
+            } : {
+                readinessPath: `${app.apiPrefix}/${app.apiStem}/readiness`,
+                openapiPath: `${app.apiPrefix}/openapi.json`
+            },
             ...app.deliveryUnit ? {
                 deliveryUnit: app.deliveryUnit
             } : {},

package/dist/esm-node/backend-federation-build/config.mjs

@@ -4,8 +4,7 @@ import promises from "node:fs/promises";
 import node_path from "node:path";
 import { resolveUltramodernSourceRevision } from "@modern-js/app-tools-extensions/release-identity";
 import { BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_REMOTE_ENTRY_FILE, DELIVERY_UNIT_DEPLOY_PROFILE, DELIVERY_UNIT_KIND, DELIVERY_UNIT_SCHEMA_VERSION, ULTRAMODERN_BUILD_ARTIFACT_PATH, deliveryUnitContractBlock, isUltramodernBuildArtifact, validateDeliveryUnitRecord, validateUltramodernBuildArtifact } from "@modern-js/backend-federation-contracts";
-const COMPACT_CONFIG_PATH = '.modernjs/ultramodern.json';
-const normalizeRelativePath = (value)=>value.replace(/\\/gu, '/').replace(/^\.\/+/u, '');
+import { DEVELOPMENT_OVERLAY_PATH, REFERENCE_TOPOLOGY_PATH, findWorkspaceRoot, normalizeRelativePath } from "../workspace-topology.mjs";
 const isRecord = (value)=>'object' == typeof value && null !== value;
 const readJsonFile = async (filePath)=>JSON.parse(await promises.readFile(filePath, 'utf8'));
 const buildArtifactPathFor = (appDirectory)=>node_path.join(appDirectory, ULTRAMODERN_BUILD_ARTIFACT_PATH);
@@ -32,19 +31,20 @@ const readBuildIdentity = async (appDirectory)=>{
 const toPascalCase = (value)=>value.split(/[^a-zA-Z0-9]+/u).filter(Boolean).map((part)=>part.charAt(0).toUpperCase() + part.slice(1)).join('');
 const stringValue = (value)=>'string' == typeof value && value.length > 0 ? value : void 0;
 const createBackendName = (app, id)=>{
-    const configuredName = stringValue(app.backendFederation?.name) ?? stringValue(app.backendFederation?.executionSurfaces?.node?.remoteName) ?? stringValue(app.serverExecution?.node?.remoteName);
+    const configuredName = stringValue(app.backendFederation?.name) ?? stringValue(app.backendFederation?.executionSurfaces?.node?.remoteName);
     if (configuredName) return configuredName;
     const mfName = stringValue(app.moduleFederation?.name);
     return mfName ? `${mfName}Backend` : `vertical${toPascalCase(id)}Backend`;
 };
-const findWorkspaceRoot = (appDirectory)=>{
-    let current = appDirectory;
-    while(true){
-        if (existsSync(node_path.join(current, COMPACT_CONFIG_PATH))) return current;
-        const parent = node_path.dirname(current);
-        if (parent === current) return;
-        current = parent;
+const rebaseDefaultLocalUrl = (value, defaultPort, publicOrigin)=>{
+    let url;
+    try {
+        url = new URL(value);
+    } catch  {
+        return value;
     }
+    if ('http:' !== url.protocol || 'localhost' !== url.hostname || Number(url.port) !== defaultPort || url.username || url.password) return value;
+    return `${publicOrigin}${url.pathname}${url.search}${url.hash}`;
 };
 const resolveWorkspaceSourceRevision = async (workspaceRoot)=>resolveUltramodernSourceRevision(workspaceRoot);
 const createStampedDeliveryUnit = (input)=>{
@@ -64,54 +64,90 @@ const createStampedDeliveryUnit = (input)=>{
     if (!validation.ok) return;
     return deliveryUnitContractBlock(record);
 };
-const createAppFromCompactMetadata = (workspaceRoot, appDirectory, compactApp)=>{
-    const id = stringValue(compactApp.id);
-    const appPath = stringValue(compactApp.path);
-    if (!id || 'vertical' !== compactApp.kind || !isRecord(compactApp.api)) return;
-    const directory = appPath ? normalizeRelativePath(appPath) : `verticals/${id}`;
+const createAppFromTopology = (workspaceRoot, appDirectory, topologyApp, overlay, packageManifest)=>{
+    const id = stringValue(topologyApp.id);
+    const appPath = stringValue(topologyApp.path);
+    if (!id || !appPath || 'vertical' !== topologyApp.kind || !isRecord(topologyApp.api) || !isRecord(topologyApp.backendFederation)) return;
+    const directory = normalizeRelativePath(appPath);
     if (node_path.resolve(workspaceRoot, directory) !== node_path.resolve(appDirectory)) return;
-    const port = 'number' == typeof compactApp.port ? compactApp.port : void 0;
-    if (void 0 === port) return;
-    const apiPrefix = stringValue(compactApp.api.prefix) ?? `/${id}-api`;
-    const apiStem = stringValue(compactApp.api.stem) ?? id;
-    const backendName = createBackendName(compactApp, id);
-    const manifestUrl = stringValue(compactApp.backendFederation?.executionSurfaces?.node?.manifestUrl) ?? stringValue(compactApp.serverExecution?.node?.manifestUrl) ?? `http://localhost:${port}/${BACKEND_FEDERATION_MANIFEST_FILE}`;
-    const containerEntry = stringValue(compactApp.backendFederation?.executionSurfaces?.node?.containerEntry) ?? stringValue(compactApp.serverExecution?.node?.containerEntry) ?? `http://localhost:${port}/${BACKEND_FEDERATION_REMOTE_ENTRY_FILE}`;
-    const configuredRemoteType = stringValue(compactApp.backendFederation?.executionSurfaces?.node?.remoteType) ?? stringValue(compactApp.serverExecution?.node?.remoteType);
+    const defaultPort = overlay.ports?.[id];
+    if ('number' != typeof defaultPort || !Number.isInteger(defaultPort) || defaultPort < 1 || defaultPort > 65535) throw new Error(`[backend-federation-build] Invalid development port for ${id}.`);
+    const portEnv = stringValue(topologyApp.portEnv) ?? `VERTICAL_${(stringValue(topologyApp.domain) ?? id).replace(/[^a-zA-Z0-9]/gu, '_').toUpperCase()}_PORT`;
+    const port = Number(process.env[portEnv] ?? defaultPort);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error(`[backend-federation-build] Invalid ${portEnv} development port for ${id}.`);
+    const publicUrlEnv = stringValue(topologyApp.cloudflare?.publicUrlEnv);
+    const configuredPublicUrl = publicUrlEnv ? process.env[publicUrlEnv]?.trim() : void 0;
+    let publicOrigin = `http://localhost:${port}`;
+    if (configuredPublicUrl) {
+        let url;
+        try {
+            url = new URL(configuredPublicUrl);
+        } catch  {
+            throw new Error(`[backend-federation-build] Invalid ${publicUrlEnv} public URL for ${id}.`);
+        }
+        if (![
+            'http:',
+            'https:'
+        ].includes(url.protocol) || url.username || url.password) throw new Error(`[backend-federation-build] Invalid ${publicUrlEnv} public URL for ${id}.`);
+        publicOrigin = url.origin;
+    }
+    const apiPrefix = stringValue(topologyApp.api.bff?.prefix) ?? `/${id}-api`;
+    const apiProtocol = topologyApp.api.protocol ?? 'rest';
+    if ('rest' !== apiProtocol && 'rpc' !== apiProtocol) throw new Error(`[backend-federation-build] Unsupported API protocol for ${id}.`);
+    const rpcPath = 'rpc' === apiProtocol ? stringValue(topologyApp.api.rpcPath) : void 0;
+    if ('rpc' === apiProtocol && (!rpcPath || 'json' !== topologyApp.api.rpcSerialization)) throw new Error(`[backend-federation-build] Missing JSON RPC route metadata for ${id}.`);
+    const apiStem = stringValue(topologyApp.api.stem) ?? id;
+    const backendName = createBackendName(topologyApp, id);
+    const nodeOverlay = overlay.serverExecution?.[id]?.node;
+    if (!isRecord(nodeOverlay)) throw new Error(`[backend-federation-build] Missing declared Node server execution for ${id}.`);
+    const manifestUrl = rebaseDefaultLocalUrl(stringValue(nodeOverlay?.manifestUrl) ?? `http://localhost:${defaultPort}/${BACKEND_FEDERATION_MANIFEST_FILE}`, defaultPort, publicOrigin);
+    const containerEntry = rebaseDefaultLocalUrl(stringValue(nodeOverlay?.containerEntry) ?? `http://localhost:${defaultPort}/${BACKEND_FEDERATION_REMOTE_ENTRY_FILE}`, defaultPort, publicOrigin);
+    const configuredRemoteType = stringValue(nodeOverlay?.remoteType) ?? stringValue(topologyApp.backendFederation?.executionSurfaces?.node?.remoteType);
     if (void 0 !== configuredRemoteType && 'commonjs-module' !== configuredRemoteType) throw new Error(`[backend-federation-build] Node backend federation remoteType must be "commonjs-module"; received "${configuredRemoteType}" for ${id}.`);
     if (!new URL(containerEntry).pathname.endsWith(`/${BACKEND_FEDERATION_REMOTE_ENTRY_FILE}`)) throw new Error(`[backend-federation-build] Node backend federation containerEntry must end with "/${BACKEND_FEDERATION_REMOTE_ENTRY_FILE}"; received "${containerEntry}" for ${id}.`);
     const remoteType = 'commonjs-module';
-    const packageName = stringValue(compactApp.package);
-    const uiManifestUrl = stringValue(compactApp.backendFederation?.versionBoundary?.ui?.manifestUrl) ?? stringValue(compactApp.moduleFederation?.manifestUrl);
-    const compactDeliveryUnit = isRecord(compactApp.deliveryUnit) ? {
-        unitId: stringValue(compactApp.deliveryUnit.unitId),
-        buildMarker: stringValue(compactApp.deliveryUnit.buildMarker),
-        sourceRevision: stringValue(compactApp.deliveryUnit.sourceRevision),
-        packageName: stringValue(compactApp.deliveryUnit.packageName),
-        version: stringValue(compactApp.deliveryUnit.version)
+    const packageName = stringValue(packageManifest.name);
+    const version = stringValue(packageManifest.version);
+    if (stringValue(topologyApp.package) !== packageName || !version) throw new Error(`[backend-federation-build] Topology package identity must match package.json for ${id}.`);
+    const declaredUiManifestUrl = stringValue(overlay.manifests?.[id]);
+    const uiManifestUrl = declaredUiManifestUrl ? rebaseDefaultLocalUrl(declaredUiManifestUrl, defaultPort, publicOrigin) : void 0;
+    const topologyDeliveryUnit = isRecord(topologyApp.deliveryUnit) ? {
+        unitId: stringValue(topologyApp.deliveryUnit.unitId),
+        buildMarker: stringValue(topologyApp.deliveryUnit.buildMarker),
+        sourceRevision: stringValue(topologyApp.deliveryUnit.sourceRevision),
+        packageName: stringValue(topologyApp.deliveryUnit.packageName),
+        version: stringValue(topologyApp.deliveryUnit.version)
     } : void 0;
     return {
         id,
         directory,
         packageName,
+        version,
         port,
         apiPrefix,
+        apiProtocol,
+        rpcPath,
         apiStem,
         backendName,
         manifestUrl,
         containerEntry,
         remoteType,
         uiManifestUrl,
-        compactDeliveryUnit
+        topologyDeliveryUnit
     };
 };
 const findBackendFederationApp = async (workspaceRoot, appDirectory)=>{
-    const compactConfigPath = node_path.join(workspaceRoot, COMPACT_CONFIG_PATH);
-    const compactConfig = await readJsonFile(compactConfigPath);
-    const apps = Array.isArray(compactConfig.topology?.apps) ? compactConfig.topology.apps : [];
-    for (const app of apps){
-        const resolved = createAppFromCompactMetadata(workspaceRoot, appDirectory, app);
+    const topologyPath = node_path.join(workspaceRoot, REFERENCE_TOPOLOGY_PATH);
+    const topology = await readJsonFile(topologyPath);
+    if (!isRecord(topology) || !Array.isArray(topology.verticals)) throw new Error(`[backend-federation-build] Invalid declared topology at ${topologyPath}.`);
+    const overlayPath = node_path.join(workspaceRoot, DEVELOPMENT_OVERLAY_PATH);
+    const overlay = await readJsonFile(overlayPath);
+    if (!isRecord(overlay) || !isRecord(overlay.ports)) throw new Error(`[backend-federation-build] Invalid development overlay at ${overlayPath}.`);
+    const packageManifest = await readJsonFile(node_path.join(appDirectory, 'package.json'));
+    for (const app of topology.verticals){
+        const resolved = createAppFromTopology(workspaceRoot, appDirectory, app, overlay, packageManifest);
         if (resolved) return resolved;
     }
+    throw new Error(`[backend-federation-build] ${appDirectory} is missing from the declared reference topology.`);
 };
-export { COMPACT_CONFIG_PATH, buildArtifactPathFor, createAppFromCompactMetadata, createStampedDeliveryUnit, findBackendFederationApp, findWorkspaceRoot, normalizeRelativePath, readBuildIdentity, resolveWorkspaceSourceRevision };
+export { DEVELOPMENT_OVERLAY_PATH, REFERENCE_TOPOLOGY_PATH, buildArtifactPathFor, createAppFromTopology, createStampedDeliveryUnit, findBackendFederationApp, findWorkspaceRoot, normalizeRelativePath, readBuildIdentity, resolveWorkspaceSourceRevision };

package/dist/esm-node/backend-federation-build/emit.mjs

@@ -5,9 +5,10 @@ import node_path from "node:path";
 import { resolveUltramodernReleaseIdentity } from "@modern-js/app-tools-extensions/release-identity";
 import { BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_REMOTE_ENTRY_FILE, ULTRAMODERN_BUILD_ARTIFACT_FILE, stampUltramodernBuildArtifactIdentity } from "@modern-js/backend-federation-contracts";
 import { createBackendFederationEntryIntegrity } from "@modern-js/server-runtime-extensions/backend-federation-security/node";
+import { emitRendererBuildArtifact, stampFinalizedRendererBuildArtifact, validateFinalizedRendererBuild } from "../release-envelope/renderer-output-stamp.mjs";
 import { createBackendManifest, createBackendRemoteEntrySource } from "./codegen.mjs";
-import { COMPACT_CONFIG_PATH, buildArtifactPathFor, createStampedDeliveryUnit, findBackendFederationApp, findWorkspaceRoot, readBuildIdentity, resolveWorkspaceSourceRevision } from "./config.mjs";
-const emitBackendFederationArtifacts = async (appDirectory, distDirectory)=>{
+import { REFERENCE_TOPOLOGY_PATH, buildArtifactPathFor, createStampedDeliveryUnit, findBackendFederationApp, findWorkspaceRoot, readBuildIdentity, resolveWorkspaceSourceRevision } from "./config.mjs";
+const emitBackendFederationArtifacts = async (appDirectory, distDirectory, options = {})=>{
     const workspaceRoot = findWorkspaceRoot(appDirectory);
     if (!workspaceRoot) return;
     const effectApiPath = node_path.join(appDirectory, 'api/effect-api.ts');
@@ -16,35 +17,50 @@ const emitBackendFederationArtifacts = async (appDirectory, distDirectory)=>{
     const app = await findBackendFederationApp(workspaceRoot, appDirectory);
     if (!app) return;
     const buildIdentity = await readBuildIdentity(appDirectory);
-    const compactDeliveryUnit = app.compactDeliveryUnit;
-    const hasCompactDeliveryUnit = void 0 !== compactDeliveryUnit && (void 0 !== compactDeliveryUnit.unitId || void 0 !== compactDeliveryUnit.buildMarker || void 0 !== compactDeliveryUnit.packageName || void 0 !== compactDeliveryUnit.version);
+    const topologyDeliveryUnit = app.topologyDeliveryUnit;
+    const hasTopologyDeliveryUnit = void 0 !== topologyDeliveryUnit && (void 0 !== topologyDeliveryUnit.unitId || void 0 !== topologyDeliveryUnit.buildMarker || void 0 !== topologyDeliveryUnit.packageName || void 0 !== topologyDeliveryUnit.version);
     const hasBuildIdentity = void 0 !== buildIdentity.unitId || void 0 !== buildIdentity.buildVersion || void 0 !== buildIdentity.packageName || void 0 !== buildIdentity.version;
     if (hasBuildIdentity) {
-        const compactConfigPath = node_path.join(workspaceRoot, COMPACT_CONFIG_PATH);
+        const topologyPath = node_path.join(workspaceRoot, REFERENCE_TOPOLOGY_PATH);
         const buildIdentityPath = buildArtifactPathFor(appDirectory);
         const mismatches = [];
         const compare = (label, a, b, leftLabel = 'deliveryUnit')=>{
             if (void 0 !== a && void 0 !== b && a !== b) mismatches.push(`${label}: ${leftLabel}=${a} vs ultramodern-build=${b}`);
         };
         compare('appId', app.id, buildIdentity.appId, 'topology');
-        if (hasCompactDeliveryUnit) {
-            compare('unitId', compactDeliveryUnit?.unitId, buildIdentity.unitId);
-            compare('buildMarker/build', compactDeliveryUnit?.buildMarker, buildIdentity.buildVersion);
-            compare('packageName', compactDeliveryUnit?.packageName, buildIdentity.packageName);
-            compare('version', compactDeliveryUnit?.version, buildIdentity.version);
+        if (hasTopologyDeliveryUnit) {
+            compare('unitId', topologyDeliveryUnit?.unitId, buildIdentity.unitId);
+            compare('buildMarker/build', topologyDeliveryUnit?.buildMarker, buildIdentity.buildVersion);
+            compare('packageName', topologyDeliveryUnit?.packageName, buildIdentity.packageName);
+            compare('version', topologyDeliveryUnit?.version, buildIdentity.version);
         }
-        if (mismatches.length > 0) throw new Error(`[backend-federation-build] Delivery-unit identity drift between ${compactConfigPath} (topology) and ${buildIdentityPath}: ${mismatches.join('; ')}`);
+        compare('packageName', app.packageName, buildIdentity.packageName, 'package.json');
+        compare('packageName', topologyDeliveryUnit?.packageName, app.packageName, 'topology');
+        compare('version', app.version, buildIdentity.version, 'package.json');
+        compare('version', topologyDeliveryUnit?.version, app.version, 'topology');
+        if (mismatches.length > 0) throw new Error(`[backend-federation-build] Delivery-unit identity drift between ${topologyPath}, package.json and ${buildIdentityPath}: ${mismatches.join('; ')}`);
     }
-    const unitId = compactDeliveryUnit?.unitId ?? buildIdentity.unitId;
-    const generationBuildMarker = compactDeliveryUnit?.buildMarker ?? buildIdentity.buildVersion;
-    const sourceRevision = await resolveWorkspaceSourceRevision(workspaceRoot);
-    const buildVersion = generationBuildMarker && unitId ? resolveUltramodernReleaseIdentity({
+    const unitId = topologyDeliveryUnit?.unitId ?? buildIdentity.unitId;
+    const generationBuildMarker = topologyDeliveryUnit?.buildMarker ?? buildIdentity.buildVersion;
+    let finalizedRendererBuild;
+    if (options.resolveRendererBuild && buildIdentity.artifact?.surfaces.ui) {
+        if (!options.entrypoints?.length) throw new Error('[backend-federation-build] Renderer output stamping requires the actual finalized application entries.');
+        const context = {
+            appDirectory,
+            distDirectory,
+            entrypoints: options.entrypoints
+        };
+        finalizedRendererBuild = await options.resolveRendererBuild(context);
+        validateFinalizedRendererBuild(finalizedRendererBuild, context, app.id);
+    }
+    const sourceRevision = finalizedRendererBuild?.sourceRevision ?? await resolveWorkspaceSourceRevision(workspaceRoot);
+    const buildVersion = finalizedRendererBuild?.buildMarker ?? (generationBuildMarker && unitId ? resolveUltramodernReleaseIdentity({
         generationBuildMarker,
         unitId,
         workspaceRoot
-    }).buildMarker : void 0;
-    const packageName = compactDeliveryUnit?.packageName ?? buildIdentity.packageName ?? app.packageName;
-    const version = compactDeliveryUnit?.version ?? buildIdentity.version;
+    }).buildMarker : void 0);
+    const packageName = app.packageName;
+    const version = app.version;
     const deliveryUnit = createStampedDeliveryUnit({
         appId: app.id,
         unitId,
@@ -53,10 +69,15 @@ const emitBackendFederationArtifacts = async (appDirectory, distDirectory)=>{
         version,
         sourceRevision
     });
-    const stampedBuildArtifact = buildIdentity.artifact ? stampUltramodernBuildArtifactIdentity(buildIdentity.artifact, {
+    let stampedBuildArtifact = buildIdentity.artifact ? stampUltramodernBuildArtifactIdentity(buildIdentity.artifact, {
         buildMarker: buildVersion ?? buildIdentity.artifact.deliveryUnit.buildMarker,
         sourceRevision
     }) : void 0;
+    if (finalizedRendererBuild && stampedBuildArtifact?.surfaces.ui) stampedBuildArtifact = stampFinalizedRendererBuildArtifact(stampedBuildArtifact, finalizedRendererBuild, {
+        appDirectory,
+        distDirectory,
+        entrypoints: options.entrypoints
+    });
     const resolvedApp = {
         ...app,
         packageName,
@@ -87,14 +108,34 @@ const emitBackendFederationArtifacts = async (appDirectory, distDirectory)=>{
         remoteType: resolvedApp.remoteType
     };
 };
-const emit = ()=>({
+const emit = (options = {})=>{
+    if (options.resolveRendererBuild && !options.rendererBuildPlugin) throw new Error('[backend-federation-build] A finalized renderer resolver requires its owning metadata producer plugin.');
+    return {
         name: '@modern-js/backend-federation-build',
+        pre: options.resolveRendererBuild ? [
+            options.rendererBuildPlugin
+        ] : [],
+        required: options.resolveRendererBuild ? [
+            options.rendererBuildPlugin
+        ] : [],
         setup (api) {
             api.onAfterBuild(async ()=>{
-                const { appDirectory, distDirectory } = api.getAppContext();
-                await emitBackendFederationArtifacts(appDirectory, distDirectory);
+                const { appDirectory, distDirectory, entrypoints, apiOnly } = api.getAppContext();
+                if (options.resolveRendererBuild && !apiOnly) await emitRendererBuildArtifact({
+                    appDirectory,
+                    distDirectory,
+                    entrypoints: entrypoints ?? []
+                }, {
+                    resolveRendererBuild: options.resolveRendererBuild,
+                    rendererBuildPlugin: options.rendererBuildPlugin
+                });
+                await emitBackendFederationArtifacts(appDirectory, distDirectory, {
+                    ...options,
+                    entrypoints
+                });
             });
         }
-    });
+    };
+};
 export default emit;
 export { emitBackendFederationArtifacts };

package/dist/esm-node/build-config/build-environment.mjs

@@ -1,148 +1,29 @@
 import "node:module";
-import { execFileSync } from "node:child_process";
 import { createHash } from "node:crypto";
 import { accessSync, chmodSync, constants, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import { createRequire } from "node:module";
+import { createRequire, findPackageJSON } from "node:module";
 import { tmpdir } from "node:os";
-import { basename, dirname, join, resolve } from "node:path";
-const EFFECT_TSGO_PACKAGE = '@effect/tsgo';
-const EFFECT_TSGO_BIN = 'effect-tsgo';
+import { basename, join } from "node:path";
+import "node:url";
+const owningModuleUrl = import.meta.url;
+const owningManifest = findPackageJSON(owningModuleUrl, owningModuleUrl);
+if (!owningManifest) throw new Error('Cannot find owning build-config package manifest');
+const owningName = JSON.parse(readFileSync(owningManifest, 'utf8')).name;
+if ('string' != typeof owningName || 0 === owningName.length) throw new Error(`Invalid owning build-config package name: ${owningManifest}`);
+const { effectCompilerDiscoveryFailureStage: effectCompilerDiscoveryFailureStage, resolveInstalledEffectCompiler: resolveInstalledEffectCompiler } = createRequire(owningModuleUrl)(`${owningName}/internal-effect-discovery`);
 const EFFECT_TSGO_RESOLUTION_ERROR = 'Unable to resolve the Effect TS-Go compiler. Install "@effect/tsgo" and a native TypeScript backend for this build config, or set EFFECT_TSGO_BIN.';
 const executableEffectTsgoCompilers = new Map();
-const BUILD_CONFIG_ENVIRONMENT_PLUGIN = 'ModernJsBuildConfigEnvironmentLeasePlugin';
-const ENVIRONMENT_LEASE_REGISTRY_KEY = Symbol.for('@modern-js/app-tools/build-config-environment-lease-registry/v1');
-const ENVIRONMENT_LEASE_REGISTRY_BRAND = Symbol.for('@modern-js/app-tools/build-config-environment-lease-registry-brand/v1');
-const LIFECYCLE_HOOK_NAMES = [
-    'run',
-    'watchRun',
-    'afterDone',
-    'failed',
-    'shutdown',
-    'watchClose'
-];
-function restoreEnvironment(name, value) {
-    if (void 0 === value) delete process.env[name];
-    else process.env[name] = value;
-}
-function createEnvironmentLeaseRegistry() {
-    const environmentLeases = new Map();
-    return Object.freeze({
-        acquire (name, value) {
-            let lease = environmentLeases.get(name);
-            if (lease) {
-                if (lease.value !== value) throw new Error(`Build config environment "${name}" already has an active lease for a different value.`);
-                if (process.env[name] !== lease.value) throw new Error(`Build config environment lease for "${name}" lost ownership before another lease was acquired.`);
-            } else {
-                lease = {
-                    originalValue: process.env[name],
-                    owners: new Set(),
-                    value
-                };
-                process.env[name] = value;
-                environmentLeases.set(name, lease);
-            }
-            const owner = Symbol(name);
-            lease.owners.add(owner);
-            let released = false;
-            return ()=>{
-                if (released) return;
-                if (environmentLeases.get(name) !== lease || !lease.owners.has(owner)) throw new Error(`Build config environment lease for "${name}" cannot be restored because its ownership record was lost.`);
-                released = true;
-                const lostOwnership = process.env[name] !== lease.value;
-                lease.owners.delete(owner);
-                if (0 === lease.owners.size) {
-                    environmentLeases.delete(name);
-                    restoreEnvironment(name, lease.originalValue);
-                } else if (lostOwnership) process.env[name] = lease.value;
-                if (lostOwnership) throw new Error(`Build config environment lease for "${name}" lost ownership before restoration.`);
-            };
-        },
-        brand: ENVIRONMENT_LEASE_REGISTRY_BRAND
-    });
-}
-function getEnvironmentLeaseRegistry() {
-    const descriptor = Object.getOwnPropertyDescriptor(process, ENVIRONMENT_LEASE_REGISTRY_KEY);
-    if (descriptor) {
-        const registry = descriptor.value;
-        if (descriptor.configurable || descriptor.enumerable || descriptor.writable || registry?.brand !== ENVIRONMENT_LEASE_REGISTRY_BRAND || 'function' != typeof registry.acquire) throw new Error('The process-global build config environment lease registry is occupied by an incompatible value.');
-        return registry;
-    }
-    const registry = createEnvironmentLeaseRegistry();
-    Object.defineProperty(process, ENVIRONMENT_LEASE_REGISTRY_KEY, {
-        configurable: false,
-        enumerable: false,
-        value: registry,
-        writable: false
+function effectTsgoResolutionError(cause, stage, from) {
+    const detail = cause instanceof Error ? `${cause.name}: ${cause.message}` : String(cause);
+    return new Error(`${EFFECT_TSGO_RESOLUTION_ERROR}\n${stage} failed for ${String(from)}: ${detail}`, {
+        cause
     });
-    return registry;
-}
-function acquireEnvironmentLease(name, value) {
-    return getEnvironmentLeaseRegistry().acquire(name, value);
-}
-function releaseAfterFailure(release, originalError) {
-    try {
-        release();
-    } catch (restorationError) {
-        throw new AggregateError([
-            originalError,
-            restorationError
-        ], 'Build config environment setup and restoration both failed.');
-    }
-    throw originalError;
-}
-class BuildConfigEnvironmentLeasePlugin {
-    apply(compiler) {
-        const hooks = compiler.hooks;
-        try {
-            const lifecycleHooks = {};
-            for (const hookName of LIFECYCLE_HOOK_NAMES){
-                const hook = hooks[hookName];
-                if (!hook || 'function' != typeof hook.tap) throw new Error(`Rspack does not expose the "${hookName}" lifecycle hook required to restore build config environment leases.`);
-                lifecycleHooks[hookName] = hook;
-            }
-            let mode = 'pending';
-            const modeTap = {
-                name: BUILD_CONFIG_ENVIRONMENT_PLUGIN,
-                stage: Number.MIN_SAFE_INTEGER
-            };
-            const releaseTap = {
-                name: BUILD_CONFIG_ENVIRONMENT_PLUGIN,
-                stage: Number.MAX_SAFE_INTEGER
-            };
-            const releaseAfterOneShot = ()=>{
-                if ('watch' !== mode && true !== compiler.watchMode) this.release();
-            };
-            lifecycleHooks.run.tap(modeTap, ()=>{
-                mode = 'run';
-            });
-            lifecycleHooks.watchRun.tap(modeTap, ()=>{
-                mode = 'watch';
-            });
-            lifecycleHooks.afterDone.tap(releaseTap, releaseAfterOneShot);
-            lifecycleHooks.failed.tap(releaseTap, releaseAfterOneShot);
-            lifecycleHooks.shutdown.tap(releaseTap, this.release);
-            lifecycleHooks.watchClose.tap(releaseTap, this.release);
-        } catch (error) {
-            releaseAfterFailure(this.release, error);
-        }
-    }
-    constructor(release){
-        this.release = release;
-    }
-}
-function resolveEffectTsgoCli(from) {
-    const projectRequire = createRequire(from);
-    const packageJsonPath = projectRequire.resolve(`${EFFECT_TSGO_PACKAGE}/package.json`);
-    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-    const bin = 'string' == typeof packageJson.bin ? packageJson.bin : packageJson.bin?.[EFFECT_TSGO_BIN];
-    if (!bin) throw new Error(EFFECT_TSGO_RESOLUTION_ERROR);
-    return resolve(dirname(packageJsonPath), bin);
 }
 function resolveExecutableEffectTsgoCompiler(compilerPath) {
     if ('win32' === process.platform) return compilerPath;
     const sourcePath = realpathSync(compilerPath);
     const source = lstatSync(sourcePath);
-    if (!source.isFile()) throw new Error(EFFECT_TSGO_RESOLUTION_ERROR);
+    if (!source.isFile()) throw new Error(`Effect TS-Go compiler path is not a regular file: ${sourcePath}`);
     try {
         accessSync(sourcePath, constants.X_OK);
         return compilerPath;
@@ -189,37 +70,22 @@ function resolveExecutableEffectTsgoCompiler(compilerPath) {
 function getBuildConfigEnvironment(name) {
     return process.env[name];
 }
-function withBuildConfigEnvironment(name, value, setup) {
-    return async (config, ...args)=>{
-        const release = acquireEnvironmentLease(name, value);
-        try {
-            const configured = await setup(config, ...args) ?? config;
-            configured.plugins = [
-                ...configured.plugins ?? [],
-                new BuildConfigEnvironmentLeasePlugin(release)
-            ];
-            return configured;
-        } catch (error) {
-            releaseAfterFailure(release, error);
-        }
-    };
-}
 function resolveEffectTsgoCompiler(options) {
     const configuredCompiler = getBuildConfigEnvironment('EFFECT_TSGO_BIN')?.trim();
     if (configuredCompiler) try {
         return resolveExecutableEffectTsgoCompiler(configuredCompiler);
-    } catch  {
-        throw new Error(EFFECT_TSGO_RESOLUTION_ERROR);
+    } catch (cause) {
+        throw effectTsgoResolutionError(cause, 'Configured compiler validation', options.from);
     }
+    let stage = 'Package CLI resolution';
     try {
-        const compiler = execFileSync(process.execPath, [
-            resolveEffectTsgoCli(options.from),
-            'get-exe-path'
-        ], {
-            encoding: 'utf-8'
-        }).trim();
-        if (compiler) return resolveExecutableEffectTsgoCompiler(compiler);
-    } catch  {}
-    throw new Error(EFFECT_TSGO_RESOLUTION_ERROR);
+        const compiler = resolveInstalledEffectCompiler(options.from).trim();
+        stage = 'Compiler backend lookup';
+        if (!compiler) throw new Error('Effect TS-Go discovery returned an empty compiler path');
+        stage = 'Compiler executable validation';
+        return resolveExecutableEffectTsgoCompiler(compiler);
+    } catch (cause) {
+        throw effectTsgoResolutionError(cause, effectCompilerDiscoveryFailureStage(cause) ?? stage, options.from);
+    }
 }
-export { getBuildConfigEnvironment, resolveEffectTsgoCompiler, withBuildConfigEnvironment };
+export { getBuildConfigEnvironment, resolveEffectTsgoCompiler };