@bleedingdev/modern-js-create 3.5.0-ultramodern.3 → 3.5.0-ultramodern.30

package/dist/cjs/ultramodern-tooling/config.cjs

@@ -37,7 +37,9 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
+    normalizeCompactUltramodernConfig: ()=>normalizeCompactUltramodernConfig,
     readUltramodernConfig: ()=>readUltramodernConfig,
+    synthesizeCompactUltramodernConfig: ()=>synthesizeCompactUltramodernConfig,
     workspaceAppsFromToolingConfig: ()=>workspaceAppsFromToolingConfig
 });
 const external_node_fs_namespaceObject = require("node:fs");
@@ -47,6 +49,9 @@ var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_no
 const bridge_config_cjs_namespaceObject = require("../ultramodern-workspace/bridge-config.cjs");
 const descriptors_cjs_namespaceObject = require("../ultramodern-workspace/descriptors.cjs");
 const naming_cjs_namespaceObject = require("../ultramodern-workspace/naming.cjs");
+const LEGACY_GENERATED_CONTRACT_PATH = '.modernjs/ultramodern-generated-contract.json';
+const LEGACY_PACKAGE_SOURCE_METADATA_PATH = '.modernjs/ultramodern-package-source.json';
+const LEGACY_DEVELOPMENT_OVERLAY_PATH = 'topology/local-overlays/development.json';
 function readJsonObject(filePath) {
     const value = JSON.parse(external_node_fs_default().readFileSync(filePath, 'utf-8'));
     if (null === value || 'object' != typeof value || Array.isArray(value)) throw new Error(`UltraModern config must contain a JSON object: ${filePath}`);
@@ -55,11 +60,39 @@ function readJsonObject(filePath) {
 function readOptionalJsonObject(filePath) {
     return external_node_fs_default().existsSync(filePath) ? readJsonObject(filePath) : {};
 }
-function packageScopeFromRoot(workspaceRoot1) {
-    const rootPackage = readOptionalJsonObject(external_node_path_default().join(workspaceRoot1, 'package.json'));
-    return 'string' == typeof rootPackage.name && rootPackage.name.length > 0 ? rootPackage.name : external_node_path_default().basename(workspaceRoot1);
+function packageScopeFromRoot(workspaceRoot) {
+    const rootPackage = readOptionalJsonObject(external_node_path_default().join(workspaceRoot, 'package.json'));
+    return 'string' == typeof rootPackage.name && rootPackage.name.length > 0 ? rootPackage.name : external_node_path_default().basename(workspaceRoot);
 }
-function normalizeCompactConfig(sourcePath, config) {
+function packageSourceFromMetadata(workspaceRoot) {
+    const metadataPath = external_node_path_default().join(workspaceRoot, LEGACY_PACKAGE_SOURCE_METADATA_PATH);
+    if (!external_node_fs_default().existsSync(metadataPath)) return;
+    const metadata = readJsonObject(metadataPath);
+    const aliases = metadata.modernPackages?.aliases ?? {};
+    const firstAliasEntry = Object.entries(aliases).find((entry)=>'string' == typeof entry[1]);
+    const firstPackage = firstAliasEntry?.[0];
+    const firstAlias = firstAliasEntry?.[1];
+    const aliasScope = firstAlias?.match(/^@([^/]+)\//u)?.[1];
+    const unscopedName = firstPackage?.split('/').at(-1) ?? '';
+    const aliasUnscopedName = firstAlias?.split('/').at(-1) ?? '';
+    const aliasPackageNamePrefix = aliasUnscopedName && unscopedName && aliasUnscopedName.endsWith(unscopedName) ? aliasUnscopedName.slice(0, -unscopedName.length) : void 0;
+    return {
+        strategy: 'install' === metadata.strategy ? 'install' : 'workspace',
+        modernPackageVersion: 'string' == typeof metadata.modernPackages?.specifier ? metadata.modernPackages.specifier : 'workspace:*',
+        registry: 'string' == typeof metadata.modernPackages?.registry ? metadata.modernPackages.registry : void 0,
+        aliasScope,
+        aliasPackageNamePrefix
+    };
+}
+function readOverlayPorts(workspaceRoot) {
+    const overlayPath = external_node_path_default().join(workspaceRoot, LEGACY_DEVELOPMENT_OVERLAY_PATH);
+    if (!external_node_fs_default().existsSync(overlayPath)) return {};
+    const overlay = readJsonObject(overlayPath);
+    const ports = overlay.ports;
+    if (null === ports || 'object' != typeof ports || Array.isArray(ports)) return {};
+    return Object.fromEntries(Object.entries(ports).filter((entry)=>'number' == typeof entry[1]));
+}
+function normalizeCompactConfig(workspaceRoot, sourcePath, config) {
     const packageSource = config.packageSource && 'object' == typeof config.packageSource ? {
         strategy: 'install' === config.packageSource.strategy ? 'install' : 'workspace',
         modernPackageVersion: 'string' == typeof config.packageSource.modernPackageVersion ? config.packageSource.modernPackageVersion : 'workspace:*',
@@ -112,10 +145,114 @@ function normalizeCompactConfig(sourcePath, config) {
         }
     };
 }
-function readUltramodernConfig(workspaceRoot1 = process.cwd()) {
-    const compactPath = external_node_path_default().join(workspaceRoot1, descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH);
-    if (external_node_fs_default().existsSync(compactPath)) return normalizeCompactConfig(compactPath, readJsonObject(compactPath));
-    throw new Error(`Missing UltraModern config. Expected ${descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH}.`);
+function normalizeCompactUltramodernConfig(workspaceRoot, compact) {
+    return normalizeCompactConfig(workspaceRoot, external_node_path_default().join(workspaceRoot, descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH), compact);
+}
+function synthesizeCompactUltramodernConfig(workspaceRoot) {
+    const contractPath = external_node_path_default().join(workspaceRoot, LEGACY_GENERATED_CONTRACT_PATH);
+    if (!external_node_fs_default().existsSync(contractPath)) return;
+    const contract = readJsonObject(contractPath);
+    const sources = [
+        LEGACY_GENERATED_CONTRACT_PATH
+    ];
+    const missing = [];
+    const packageSource = packageSourceFromMetadata(workspaceRoot);
+    if (packageSource) sources.push(LEGACY_PACKAGE_SOURCE_METADATA_PATH);
+    else missing.push(LEGACY_PACKAGE_SOURCE_METADATA_PATH);
+    const ports = readOverlayPorts(workspaceRoot);
+    if (external_node_fs_default().existsSync(external_node_path_default().join(workspaceRoot, LEGACY_DEVELOPMENT_OVERLAY_PATH))) sources.push(LEGACY_DEVELOPMENT_OVERLAY_PATH);
+    else missing.push(LEGACY_DEVELOPMENT_OVERLAY_PATH);
+    const apps = Array.isArray(contract.apps) ? contract.apps : [];
+    const shell = apps.find((app)=>app?.id === descriptors_cjs_namespaceObject.shellApp.id);
+    const compact = {
+        schemaVersion: 'number' == typeof contract.schemaVersion ? contract.schemaVersion : 1,
+        ...'string' == typeof contract.profile ? {
+            profile: contract.profile
+        } : {},
+        workspace: {
+            packageScope: packageScopeFromRoot(workspaceRoot)
+        },
+        ...packageSource ? {
+            packageSource: {
+                strategy: packageSource.strategy,
+                modernPackageVersion: packageSource.modernPackageVersion,
+                ...packageSource.registry ? {
+                    registry: packageSource.registry
+                } : {},
+                ...packageSource.aliasScope ? {
+                    aliasScope: packageSource.aliasScope
+                } : {},
+                ...packageSource.aliasPackageNamePrefix ? {
+                    aliasPackageNamePrefix: packageSource.aliasPackageNamePrefix
+                } : {}
+            }
+        } : {},
+        features: {
+            tailwind: shell?.styling?.tailwind !== false
+        },
+        topology: {
+            apps: apps.map((app)=>{
+                const id = String(app.id);
+                const appPath = 'string' == typeof app.path ? app.path : id === descriptors_cjs_namespaceObject.shellApp.id ? descriptors_cjs_namespaceObject.shellApp.directory : `verticals/${(0, naming_cjs_namespaceObject.toKebabCase)(id)}`;
+                const domain = 'string' == typeof app.i18n?.namespace && 'shell' !== app.i18n.namespace ? app.i18n.namespace : appPath.split('/').at(-1);
+                const moduleFederation = app.moduleFederation && 'object' == typeof app.moduleFederation ? {
+                    role: 'vertical' === app.kind ? 'remote' : 'host',
+                    ...'string' == typeof app.moduleFederation.name ? {
+                        name: app.moduleFederation.name
+                    } : {},
+                    ...Array.isArray(app.moduleFederation.exposes) ? {
+                        exposes: app.moduleFederation.exposes.filter((expose)=>'string' == typeof expose)
+                    } : {},
+                    ...Array.isArray(app.moduleFederation.verticalRefs) ? {
+                        verticalRefs: app.moduleFederation.verticalRefs.filter((ref)=>'string' == typeof ref)
+                    } : {}
+                } : void 0;
+                const api = app.effect && 'object' == typeof app.effect ? {
+                    stem: 'string' == typeof app.effect.prefix ? app.effect.prefix.split('/').filter(Boolean).at(-1) ?? domain ?? id : domain ?? id,
+                    prefix: 'string' == typeof app.effect.prefix ? app.effect.prefix : `/${domain ?? id}-api`,
+                    consumedBy: [
+                        descriptors_cjs_namespaceObject.shellApp.id,
+                        id
+                    ]
+                } : void 0;
+                return {
+                    id,
+                    kind: 'vertical' === app.kind ? 'vertical' : 'shell',
+                    path: appPath,
+                    ...'string' == typeof app.package ? {
+                        package: app.package
+                    } : {},
+                    packageSuffix: 'string' == typeof app.package ? app.package.split('/').at(-1) : appPath.split('/').at(-1),
+                    ...id === descriptors_cjs_namespaceObject.shellApp.id ? {
+                        displayName: descriptors_cjs_namespaceObject.shellApp.displayName
+                    } : {},
+                    ...domain ? {
+                        domain
+                    } : {},
+                    ...'number' == typeof ports[id] ? {
+                        port: ports[id]
+                    } : {},
+                    ...moduleFederation ? {
+                        moduleFederation
+                    } : {},
+                    ...api ? {
+                        api
+                    } : {}
+                };
+            })
+        }
+    };
+    return {
+        compact,
+        missing,
+        sources
+    };
+}
+function readUltramodernConfig(workspaceRoot = process.cwd()) {
+    const compactPath = external_node_path_default().join(workspaceRoot, descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH);
+    if (external_node_fs_default().existsSync(compactPath)) return normalizeCompactConfig(workspaceRoot, compactPath, readJsonObject(compactPath));
+    if (external_node_fs_default().existsSync(external_node_path_default().join(workspaceRoot, LEGACY_GENERATED_CONTRACT_PATH))) throw new Error(`Missing ${descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH}. Legacy UltraModern metadata detected — run \`modern-js-create ultramodern migrate-strict-effect\` to synthesize it.`);
+    throw new Error(`Missing UltraModern config. Expected ${descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH}. Run \`modern-js-create ultramodern migrate-strict-effect\` if you have legacy UltraModern metadata to migrate.`);
 }
 function workspaceAppsFromToolingConfig(config) {
     return config.topology.apps.map((app)=>{
@@ -161,10 +298,14 @@ function workspaceAppsFromToolingConfig(config) {
         };
     });
 }
+exports.normalizeCompactUltramodernConfig = __webpack_exports__.normalizeCompactUltramodernConfig;
 exports.readUltramodernConfig = __webpack_exports__.readUltramodernConfig;
+exports.synthesizeCompactUltramodernConfig = __webpack_exports__.synthesizeCompactUltramodernConfig;
 exports.workspaceAppsFromToolingConfig = __webpack_exports__.workspaceAppsFromToolingConfig;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "normalizeCompactUltramodernConfig",
     "readUltramodernConfig",
+    "synthesizeCompactUltramodernConfig",
     "workspaceAppsFromToolingConfig"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {

package/dist/cjs/ultramodern-workspace/add-vertical.cjs

@@ -64,6 +64,8 @@ const external_ultramodern_package_source_cjs_namespaceObject = require("../ultr
 const config_cjs_namespaceObject = require("../ultramodern-tooling/config.cjs");
 const external_api_cjs_namespaceObject = require("./api.cjs");
 const external_app_files_cjs_namespaceObject = require("./app-files.cjs");
+const external_backend_federation_cjs_namespaceObject = require("./backend-federation.cjs");
+const external_delivery_unit_cjs_namespaceObject = require("./delivery-unit.cjs");
 const external_demo_components_cjs_namespaceObject = require("./demo-components.cjs");
 const external_descriptors_cjs_namespaceObject = require("./descriptors.cjs");
 const external_fs_io_cjs_namespaceObject = require("./fs-io.cjs");
@@ -79,6 +81,7 @@ const external_public_surface_cjs_namespaceObject = require("./public-surface.cj
 const external_types_cjs_namespaceObject = require("./types.cjs");
 const external_workspace_scripts_cjs_namespaceObject = require("./workspace-scripts.cjs");
 const external_write_workspace_cjs_namespaceObject = require("./write-workspace.cjs");
+const external_zerops_cjs_namespaceObject = require("./zerops.cjs");
 const FIRST_VERTICAL_PORT = 4101;
 const TOPOLOGY_PATH = 'topology/reference-topology.json';
 const OWNERSHIP_PATH = 'topology/ownership.json';
@@ -132,6 +135,7 @@ function rewriteShellAppFiles(workspaceRoot, scope, packageSource, enableTailwin
     (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(external_node_path_default().join(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/tsconfig.json`), (0, external_package_json_cjs_namespaceObject.createAppTsConfig)(shellHost, remotes));
     (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(external_node_path_default().join(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/tsconfig.mf-types.json`), (0, external_package_json_cjs_namespaceObject.createAppMfTypesTsConfig)(shellHost));
     (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/src/modern-app-env.d.ts`, (0, external_app_files_cjs_namespaceObject.createAppEnvDts)(shellHost, remotes));
+    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/modern.config.ts`, (0, external_module_federation_cjs_namespaceObject.createAppModernConfig)(scope, shellHost, remotes));
     (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, publicWeb.jsonLdHelperFile.path, publicWeb.jsonLdHelperFile.content);
     (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, publicWeb.routeMetadataFile.path, publicWeb.routeMetadataFile.content);
     (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, publicWeb.routeHeadFile.path, publicWeb.routeHeadFile.content);
@@ -183,6 +187,12 @@ function verticalTopologyEntry(scope, vertical, remotes = []) {
             fallbackTelemetryEvent: 'modernjs:mv-runtime-parity',
             sharedContractVersion: 'mf-ssr-contract-v1'
         },
+        ...(0, external_backend_federation_cjs_namespaceObject.createBackendFederationContract)(scope, vertical) ? {
+            backendFederation: (0, external_backend_federation_cjs_namespaceObject.createBackendFederationContract)(scope, vertical)
+        } : {},
+        ...vertical.api ? {
+            deliveryUnit: (0, external_delivery_unit_cjs_namespaceObject.deliveryUnitContractBlock)((0, external_delivery_unit_cjs_namespaceObject.createDeliveryUnitRecord)(scope, vertical))
+        } : {},
         ...(0, external_api_cjs_namespaceObject.apiTopologyMetadata)(vertical) ? {
             api: (0, external_api_cjs_namespaceObject.apiTopologyMetadata)(vertical)
         } : {},
@@ -423,6 +433,12 @@ function createDryRunJsonMutations(preflight, manifestUrl) {
             pointer: `/apis/${vertical.id}`,
             description: `Add local API URL for ${vertical.id}`,
             value: `http://localhost:${vertical.port}${(0, external_descriptors_cjs_namespaceObject.resolveApiPrefix)(vertical)}`
+        },
+        {
+            path: DEVELOPMENT_OVERLAY_PATH,
+            pointer: `/serverExecution/${vertical.id}`,
+            description: `Add local MicroVertical server execution metadata for ${vertical.id}`,
+            value: (0, external_backend_federation_cjs_namespaceObject.createServerExecutionOverlay)(scope, vertical)
         }
     ] : [];
     return [
@@ -538,6 +554,8 @@ function addUltramodernVertical(options) {
     overlay.ports[vertical.id] = vertical.port;
     overlay.manifests ??= {};
     overlay.manifests[vertical.id] = `http://localhost:${vertical.port}/mf-manifest.json`;
+    overlay.serverExecution ??= {};
+    overlay.serverExecution[vertical.id] = (0, external_backend_federation_cjs_namespaceObject.createServerExecutionOverlay)(scope, vertical);
     overlay.apis ??= {};
     overlay.apis[vertical.id] = `http://localhost:${vertical.port}${(0, external_descriptors_cjs_namespaceObject.resolveApiPrefix)(vertical)}`;
     (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(topologyPath, topology);
@@ -550,6 +568,13 @@ function addUltramodernVertical(options) {
         },
         ...updatedVerticals
     ], enableTailwind, bridge));
+    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(options.workspaceRoot, 'zerops.yaml', `${(0, external_zerops_cjs_namespaceObject.createZeropsYaml)(scope, [
+        {
+            ...external_descriptors_cjs_namespaceObject.shellApp,
+            verticalRefs: updatedVerticals.map((vertical)=>vertical.id)
+        },
+        ...updatedVerticals
+    ])}\n`);
     rewriteShellAppFiles(options.workspaceRoot, scope, packageSource, enableTailwind, updatedVerticals, bridge);
     (0, external_workspace_scripts_cjs_namespaceObject.writeGeneratedWorkspaceScripts)(options.workspaceRoot, scope, enableTailwind, updatedVerticals);
     addShellZephyrDependency(options.workspaceRoot, scope, vertical);

package/dist/cjs/ultramodern-workspace/api.cjs

@@ -35,6 +35,7 @@ __webpack_require__.d(__webpack_exports__, {
     createApiReadinessContract: ()=>createApiReadinessContract,
     createApiRequestContextContract: ()=>createApiRequestContextContract,
     createApiServiceEntry: ()=>createApiServiceEntry,
+    createBackendEffectApiExpose: ()=>createBackendEffectApiExpose,
     createSharedApi: ()=>createSharedApi,
     createSharedApiContract: ()=>createSharedApiContract,
     createSharedApiImports: ()=>createSharedApiImports,
@@ -50,6 +51,7 @@ __webpack_require__.d(__webpack_exports__, {
     verticalApiReadinessSchemaExport: ()=>verticalApiReadinessSchemaExport,
     verticalApiSchemaExport: ()=>verticalApiSchemaExport
 });
+const external_backend_federation_cjs_namespaceObject = require("./backend-federation.cjs");
 const external_descriptors_cjs_namespaceObject = require("./descriptors.cjs");
 const external_naming_cjs_namespaceObject = require("./naming.cjs");
 function verticalApiExport(service) {
@@ -691,6 +693,46 @@ const apiRuntime: EffectBffDefinition<typeof ${apiExport}, EffectRuntimeLayer> &
   layer,
 });
 
+export default apiRuntime;
+`;
+}
+function createBackendEffectApiExpose(scope, service) {
+    const apiExport = verticalApiExport(service);
+    const groupName = verticalApiGroupName(service);
+    const apiPrefix = (0, external_descriptors_cjs_namespaceObject.resolveApiPrefix)(service);
+    const stem = (0, external_descriptors_cjs_namespaceObject.resolveApiStem)(service);
+    return `import apiRuntime from './index.ts';
+import { ultramodernApiMarker } from '../shared/ultramodern-build.ts';
+import {
+  ${apiExport},
+  ${groupName}ApiContract,
+  ${groupName}OperationContexts,
+} from '../shared/api.ts';
+
+export const backendFederationContract = {
+  compatibility: {
+    build: ultramodernApiMarker.build,
+    contractVersion: '${external_backend_federation_cjs_namespaceObject.BACKEND_FEDERATION_CONTRACT_VERSION}',
+    nodeAdapterVersion: '${external_backend_federation_cjs_namespaceObject.BACKEND_FEDERATION_NODE_ADAPTER_VERSION}',
+    packageName: '${(0, external_naming_cjs_namespaceObject.packageName)(scope, service.packageSuffix)}',
+    sourceRevision: ultramodernApiMarker.sourceRevision,
+    unitId: ultramodernApiMarker.unitId,
+  },
+  executionSurfaces: ['node-mf-runtime'],
+  exposes: ['./effect-api'],
+  name: '${(0, external_descriptors_cjs_namespaceObject.createBackendFederationName)(service)}',
+  openapiPath: '${apiPrefix}/openapi.json',
+  readinessPath: '${apiPrefix}/${stem}/readiness',
+  role: 'microvertical-server',
+  runtimeFramework: 'effect',
+  strictEffectApproach: true,
+} as const;
+
+export const api: unknown = ${apiExport};
+export const contract = ${groupName}ApiContract;
+export const operationContexts = ${groupName}OperationContexts;
+export const runtime = apiRuntime;
+
 export default apiRuntime;
 `;
 }
@@ -1040,6 +1082,7 @@ exports.createApiOperationContract = __webpack_exports__.createApiOperationContr
 exports.createApiReadinessContract = __webpack_exports__.createApiReadinessContract;
 exports.createApiRequestContextContract = __webpack_exports__.createApiRequestContextContract;
 exports.createApiServiceEntry = __webpack_exports__.createApiServiceEntry;
+exports.createBackendEffectApiExpose = __webpack_exports__.createBackendEffectApiExpose;
 exports.createSharedApi = __webpack_exports__.createSharedApi;
 exports.createSharedApiContract = __webpack_exports__.createSharedApiContract;
 exports.createSharedApiImports = __webpack_exports__.createSharedApiImports;
@@ -1062,6 +1105,7 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "createApiReadinessContract",
     "createApiRequestContextContract",
     "createApiServiceEntry",
+    "createBackendEffectApiExpose",
     "createSharedApi",
     "createSharedApiContract",
     "createSharedApiImports",

package/dist/cjs/ultramodern-workspace/app-files.cjs

@@ -71,17 +71,14 @@ function createAppEnvDts(app, remotes = []) {
 }
 `;
         })).join('\n');
-    const reactTypeReference = remoteModuleDeclarations ? "/// <reference types='react' />\n" : '';
-    const siteUrlDeclaration = 'declare const ULTRAMODERN_SITE_URL: string;';
-    return `${reactTypeReference}/// <reference types='@modern-js/app-tools/types' />
-
-${siteUrlDeclaration}
-declare module '*.svg' {
-  const url: string;
-  export default url;
-}
-declare module '*.css';
-${remoteModuleDeclarations ? `\n${remoteModuleDeclarations}` : ''}`;
+    const reactTypeImport = remoteModuleDeclarations ? "import type React from 'react';\n" : '';
+    return [
+        `import '@modern-js/app-tools/types';\n${reactTypeImport}`.trimEnd(),
+        `declare global {
+  const ULTRAMODERN_SITE_URL: string;
+}`,
+        remoteModuleDeclarations.trimEnd()
+    ].filter((section)=>section.length > 0).join('\n\n').concat('\n');
 }
 function createAppRuntimeConfig(app, scope, remotes = []) {
     const pluginsConfig = 'shell' === app.kind ? `  plugins: [

package/dist/cjs/ultramodern-workspace/backend-federation.cjs

@@ -0,0 +1,282 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    BACKEND_FEDERATION_CONTRACT_VERSION: ()=>BACKEND_FEDERATION_CONTRACT_VERSION,
+    BACKEND_FEDERATION_NODE_ADAPTER_VERSION: ()=>BACKEND_FEDERATION_NODE_ADAPTER_VERSION,
+    createBackendFederationContract: ()=>createBackendFederationContract,
+    createBackendFederationContractFile: ()=>createBackendFederationContractFile,
+    createBackendFederationMetadata: ()=>createBackendFederationMetadata,
+    createBackendFederationSummary: ()=>createBackendFederationSummary,
+    createDispatchWorkerNameEnv: ()=>createDispatchWorkerNameEnv,
+    createServerExecutionOverlay: ()=>createServerExecutionOverlay,
+    createWorkerBindingEnv: ()=>createWorkerBindingEnv,
+    createWorkerBindingName: ()=>createWorkerBindingName
+});
+const external_api_cjs_namespaceObject = require("./api.cjs");
+const external_delivery_unit_cjs_namespaceObject = require("./delivery-unit.cjs");
+const external_descriptors_cjs_namespaceObject = require("./descriptors.cjs");
+const external_naming_cjs_namespaceObject = require("./naming.cjs");
+const external_versions_cjs_namespaceObject = require("./versions.cjs");
+const BACKEND_FEDERATION_CONTRACT_VERSION = 'microvertical-server-effect-v1';
+const BACKEND_FEDERATION_NODE_ADAPTER_VERSION = 'backend-mf-effect-v1';
+function createZephyrEnv(app, suffix) {
+    return `ZEPHYR_${(0, external_naming_cjs_namespaceObject.toEnvSegment)(app.domain ?? app.id)}_${suffix}`;
+}
+function createWorkerBindingName(app) {
+    return `VERTICAL_${(0, external_naming_cjs_namespaceObject.toEnvSegment)(app.domain ?? app.id)}_WORKER`;
+}
+function createWorkerBindingEnv(app) {
+    return `VERTICAL_${(0, external_naming_cjs_namespaceObject.toEnvSegment)(app.domain ?? app.id)}_WORKER_BINDING`;
+}
+function createDispatchNamespaceEnv(app) {
+    return `VERTICAL_${(0, external_naming_cjs_namespaceObject.toEnvSegment)(app.domain ?? app.id)}_DISPATCH_NAMESPACE`;
+}
+function createDispatchWorkerNameEnv(app) {
+    return `VERTICAL_${(0, external_naming_cjs_namespaceObject.toEnvSegment)(app.domain ?? app.id)}_WORKER_NAME`;
+}
+function createEffectExpose(app) {
+    const apiStem = (0, external_descriptors_cjs_namespaceObject.resolveApiStem)(app);
+    return {
+        contract: `${app.directory}/shared/api.ts`,
+        runtime: `${app.directory}/api/index.ts`,
+        client: `${app.directory}/src/api/${app.api.stem}-client.ts`,
+        openapi: `${app.api.prefix}/openapi.json`,
+        readiness: `${app.api.prefix}/${apiStem}/readiness`
+    };
+}
+function createCloudflareExecutionSurface(scope, app) {
+    return {
+        kind: 'cloudflare-worker-snapshot',
+        workerName: (0, external_descriptors_cjs_namespaceObject.createCloudflareWorkerName)(scope, app),
+        publicUrlEnv: (0, external_descriptors_cjs_namespaceObject.createCloudflarePublicUrlEnv)(app),
+        ssr: {
+            workerEntry: '.output/server/index.mjs',
+            workerManifest: '.output/server/modern-worker-manifest.json',
+            routeManifest: '.output/server/route.json',
+            ssrBundle: '.output/worker/index.js',
+            effectBffBundle: '.output/worker/__modern_bff_effect.js',
+            assetsBinding: 'ASSETS'
+        },
+        zephyr: {
+            runtime: 'ssr-worker',
+            integration: 'managed-cloudflare',
+            snapshotIdEnv: createZephyrEnv(app, 'SNAPSHOT_ID'),
+            versionIdEnv: createZephyrEnv(app, 'VERSION_ID'),
+            applicationUidEnv: createZephyrEnv(app, 'APPLICATION_UID')
+        },
+        workerDispatch: {
+            preferred: 'service-binding',
+            serviceBinding: createWorkerBindingName(app),
+            serviceBindingEnv: createWorkerBindingEnv(app),
+            dispatchNamespaceEnv: createDispatchNamespaceEnv(app),
+            dispatchWorkerNameEnv: createDispatchWorkerNameEnv(app),
+            requestInterface: 'fetch'
+        }
+    };
+}
+function createNodeExecutionSurface(app) {
+    return {
+        kind: 'node-mf-runtime',
+        adapterVersion: BACKEND_FEDERATION_NODE_ADAPTER_VERSION,
+        remoteName: (0, external_descriptors_cjs_namespaceObject.createBackendFederationName)(app),
+        manifestEnv: (0, external_descriptors_cjs_namespaceObject.createBackendFederationManifestEnv)(app),
+        manifestUrl: (0, external_descriptors_cjs_namespaceObject.createBackendFederationManifestUrl)(app),
+        containerEntry: (0, external_descriptors_cjs_namespaceObject.createBackendFederationContainerEntry)(app),
+        remoteType: 'module',
+        expose: './effect-api',
+        runtimePackage: '@modern-js/plugin-bff/effect'
+    };
+}
+function createServerExecutionOverlay(scope, app) {
+    if (!(0, external_descriptors_cjs_namespaceObject.appHasApi)(app)) return;
+    const deliveryUnit = (0, external_delivery_unit_cjs_namespaceObject.createDeliveryUnitRecord)(scope, app);
+    return {
+        apiBaseUrl: `http://localhost:${app.port}${(0, external_descriptors_cjs_namespaceObject.resolveApiPrefix)(app)}`,
+        versionBoundary: 'web-and-api-same-build',
+        deliveryUnit: {
+            unitId: deliveryUnit.unitId,
+            buildMarker: deliveryUnit.buildMarker
+        },
+        cloudflare: createCloudflareExecutionSurface(scope, app),
+        node: createNodeExecutionSurface(app)
+    };
+}
+function createBackendFederationContract(scope, app) {
+    if (!(0, external_descriptors_cjs_namespaceObject.appHasApi)(app)) return;
+    const readiness = `${app.api.prefix}/${(0, external_descriptors_cjs_namespaceObject.resolveApiStem)(app)}/readiness`;
+    const deliveryUnit = (0, external_delivery_unit_cjs_namespaceObject.createDeliveryUnitRecord)(scope, app);
+    return {
+        role: 'microvertical-server',
+        name: (0, external_descriptors_cjs_namespaceObject.createBackendFederationName)(app),
+        runtimeFramework: 'effect',
+        strictEffectApproach: true,
+        deliveryUnit: (0, external_delivery_unit_cjs_namespaceObject.deliveryUnitContractBlock)(deliveryUnit),
+        exposes: {
+            './effect-api': createEffectExpose(app)
+        },
+        versionBoundary: {
+            invariant: 'web-and-api-same-build',
+            identityRoot: 'deliveryUnit',
+            packageName: (0, external_naming_cjs_namespaceObject.packageName)(scope, app.packageSuffix),
+            ui: {
+                manifestEnv: (0, external_descriptors_cjs_namespaceObject.createRemoteManifestEnv)(app),
+                manifestUrl: `http://localhost:${app.port}/mf-manifest.json`,
+                buildMarker: `${app.directory}/src/routes/ultramodern-route-metadata.ts`
+            },
+            api: {
+                readiness,
+                buildMarker: `${app.directory}/shared/ultramodern-build.ts`,
+                publicUrlEnv: (0, external_descriptors_cjs_namespaceObject.createCloudflarePublicUrlEnv)(app)
+            }
+        },
+        executionSurfaces: {
+            cloudflare: createCloudflareExecutionSurface(scope, app),
+            node: createNodeExecutionSurface(app)
+        },
+        compatibility: {
+            contractVersion: BACKEND_FEDERATION_CONTRACT_VERSION,
+            packageName: (0, external_naming_cjs_namespaceObject.packageName)(scope, app.packageSuffix),
+            effectVersion: external_versions_cjs_namespaceObject.EFFECT_VERSION,
+            moduleFederationVersion: external_versions_cjs_namespaceObject.MODULE_FEDERATION_VERSION
+        },
+        cache: {
+            cloudflareSnapshot: 'immutable',
+            nodeManifest: 'no-store',
+            nodeVersionedContainer: 'immutable',
+            nodeUnpinnedContainer: 'revalidate'
+        },
+        fallback: {
+            timeoutMs: 1500,
+            failureEvent: 'modernjs:microvertical-server-fallback',
+            strategy: 'typed-effect-error'
+        }
+    };
+}
+function createBackendFederationMetadata(scope, app) {
+    if (!(0, external_descriptors_cjs_namespaceObject.appHasApi)(app)) return;
+    return {
+        contractVersion: BACKEND_FEDERATION_CONTRACT_VERSION,
+        deliveryUnit: (0, external_delivery_unit_cjs_namespaceObject.deliveryUnitContractBlock)((0, external_delivery_unit_cjs_namespaceObject.createDeliveryUnitRecord)(scope, app)),
+        executionSurfaces: [
+            'node-mf-runtime'
+        ],
+        exposes: [
+            './effect-api'
+        ],
+        name: (0, external_descriptors_cjs_namespaceObject.createBackendFederationName)(app),
+        nodeAdapterVersion: BACKEND_FEDERATION_NODE_ADAPTER_VERSION,
+        openapiPath: `${app.api.prefix}/openapi.json`,
+        readinessPath: `${app.api.prefix}/${(0, external_descriptors_cjs_namespaceObject.resolveApiStem)(app)}/readiness`,
+        role: 'microvertical-server',
+        runtimeFramework: 'effect',
+        strictEffectApproach: true
+    };
+}
+function createBackendFederationContractFile(app) {
+    if (!app.api) throw new Error(`App ${app.id} does not define an Effect API.`);
+    const apiExport = (0, external_api_cjs_namespaceObject.verticalApiExport)(app);
+    const groupName = (0, external_api_cjs_namespaceObject.verticalApiGroupName)(app);
+    const readinessPath = `${app.api.prefix}/${(0, external_descriptors_cjs_namespaceObject.resolveApiStem)(app)}/readiness`;
+    return `import runtime from './index.ts';
+import { ultramodernApiMarker } from '../shared/ultramodern-build.ts';
+import {
+  ${apiExport} as api,
+  ${groupName}ApiContract as contract,
+  ${groupName}OperationContexts as operationContexts,
+} from '../shared/api.ts';
+
+export const backendFederationContract = {
+  compatibility: {
+    build: ultramodernApiMarker.build,
+    contractVersion: '${BACKEND_FEDERATION_CONTRACT_VERSION}',
+    nodeAdapterVersion: '${BACKEND_FEDERATION_NODE_ADAPTER_VERSION}',
+    packageName: ultramodernApiMarker.packageName,
+    sourceRevision: ultramodernApiMarker.sourceRevision,
+    unitId: ultramodernApiMarker.unitId,
+  },
+  contractVersion: '${BACKEND_FEDERATION_CONTRACT_VERSION}',
+  executionSurfaces: ['node-mf-runtime'],
+  exposes: ['./effect-api'],
+  name: '${(0, external_descriptors_cjs_namespaceObject.createBackendFederationName)(app)}',
+  nodeAdapterVersion: '${BACKEND_FEDERATION_NODE_ADAPTER_VERSION}',
+  openapiPath: '${app.api.prefix}/openapi.json',
+  readinessPath: '${readinessPath}',
+  role: 'microvertical-server',
+  runtimeFramework: 'effect',
+  strictEffectApproach: true,
+} as const;
+
+export { api, contract, operationContexts, runtime };
+
+export default runtime;
+`;
+}
+function createBackendFederationSummary(scope, app) {
+    if (!(0, external_descriptors_cjs_namespaceObject.appHasApi)(app)) return;
+    return {
+        id: app.id,
+        path: app.directory,
+        role: 'microvertical-server',
+        name: (0, external_descriptors_cjs_namespaceObject.createBackendFederationName)(app),
+        runtimeFramework: 'effect',
+        strictEffectApproach: true,
+        contractVersion: BACKEND_FEDERATION_CONTRACT_VERSION,
+        deliveryUnit: (0, external_delivery_unit_cjs_namespaceObject.deliveryUnitContractBlock)((0, external_delivery_unit_cjs_namespaceObject.createDeliveryUnitRecord)(scope, app)),
+        executionSurfaces: {
+            cloudflare: createCloudflareExecutionSurface(scope, app),
+            node: createNodeExecutionSurface(app)
+        }
+    };
+}
+exports.BACKEND_FEDERATION_CONTRACT_VERSION = __webpack_exports__.BACKEND_FEDERATION_CONTRACT_VERSION;
+exports.BACKEND_FEDERATION_NODE_ADAPTER_VERSION = __webpack_exports__.BACKEND_FEDERATION_NODE_ADAPTER_VERSION;
+exports.createBackendFederationContract = __webpack_exports__.createBackendFederationContract;
+exports.createBackendFederationContractFile = __webpack_exports__.createBackendFederationContractFile;
+exports.createBackendFederationMetadata = __webpack_exports__.createBackendFederationMetadata;
+exports.createBackendFederationSummary = __webpack_exports__.createBackendFederationSummary;
+exports.createDispatchWorkerNameEnv = __webpack_exports__.createDispatchWorkerNameEnv;
+exports.createServerExecutionOverlay = __webpack_exports__.createServerExecutionOverlay;
+exports.createWorkerBindingEnv = __webpack_exports__.createWorkerBindingEnv;
+exports.createWorkerBindingName = __webpack_exports__.createWorkerBindingName;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "BACKEND_FEDERATION_CONTRACT_VERSION",
+    "BACKEND_FEDERATION_NODE_ADAPTER_VERSION",
+    "createBackendFederationContract",
+    "createBackendFederationContractFile",
+    "createBackendFederationMetadata",
+    "createBackendFederationSummary",
+    "createDispatchWorkerNameEnv",
+    "createServerExecutionOverlay",
+    "createWorkerBindingEnv",
+    "createWorkerBindingName"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});