@bleedingdev/modern-js-ultramodern-create 3.9.0-ultramodern.2 → 3.9.0-ultramodern.4

package/dist/cjs/ultramodern-tooling/commands/migrate-strict-effect/workspace-artifact-ownership.cjs

@@ -0,0 +1,215 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __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__, {
+    preserveConsumerWorkspaceArtifacts: ()=>preserveConsumerWorkspaceArtifacts
+});
+const external_node_fs_namespaceObject = require("node:fs");
+var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
+const external_node_path_namespaceObject = require("node:path");
+var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
+const parser_namespaceObject = require("@babel/parser");
+const fs_io_cjs_namespaceObject = require("../../../ultramodern-workspace/fs-io.cjs");
+function isLiteralData(node, literalIdentifiers) {
+    if (!node) return false;
+    if ('Identifier' === node.type) return literalIdentifiers?.has(node.name) ?? false;
+    if ([
+        'StringLiteral',
+        'NumericLiteral',
+        'BooleanLiteral',
+        'NullLiteral'
+    ].includes(node.type)) return true;
+    if ('UnaryExpression' === node.type) return '-' === node.operator && 'NumericLiteral' === node.argument.type;
+    if ('ArrayExpression' === node.type) return node.elements.every((element)=>isLiteralData(element, literalIdentifiers));
+    return 'ObjectExpression' === node.type && node.properties.every((property)=>'ObjectProperty' === property.type && !property.computed && !property.shorthand && [
+            'Identifier',
+            'StringLiteral',
+            'NumericLiteral'
+        ].includes(property.key.type) && isLiteralData(property.value, literalIdentifiers));
+}
+function withoutGeneratedData(source, binding) {
+    if (!binding) return source;
+    const parsed = (0, parser_namespaceObject.parse)(source, {
+        sourceType: 'module',
+        plugins: [
+            "typescript"
+        ]
+    });
+    for (const statement of parsed.program.body)if ('VariableDeclaration' === statement.type && 'const' === statement.kind) {
+        for (const declaration of statement.declarations)if ('Identifier' === declaration.id.type && declaration.id.name === binding && declaration.init && isLiteralData(declaration.init)) return source.slice(0, declaration.init.start) + '{}' + source.slice(declaration.init.end);
+    }
+    return source;
+}
+function staticPropertyValue(node, name) {
+    if (node?.type !== 'ObjectExpression') return;
+    const keys = new Set();
+    let value;
+    for (const property of node.properties){
+        if ('ObjectProperty' !== property.type || property.computed || property.shorthand || ![
+            'Identifier',
+            'StringLiteral'
+        ].includes(property.key.type)) return;
+        const key = property.key.name ?? property.key.value;
+        if (keys.has(key)) return;
+        keys.add(key);
+        if (key === name) value = property.value;
+    }
+    return value;
+}
+function refreshValidatorReleaseCohort(source, releaseCohort) {
+    try {
+        const parsed = (0, parser_namespaceObject.parse)(source, {
+            sourceType: 'module',
+            plugins: [
+                "typescript"
+            ],
+            tokens: true
+        });
+        const constants = parsed.program.body.flatMap((statement)=>'VariableDeclaration' === statement.type && 'const' === statement.kind ? statement.declarations : []);
+        const matches = [];
+        for (const statement of parsed.program.body)if ('VariableDeclaration' === statement.type && 'const' === statement.kind) for (const declaration of statement.declarations){
+            const kind = staticPropertyValue(declaration.init, 'kind');
+            if (kind?.type !== 'StringLiteral' || 'modernjs.ultramodern-workspace-validation-contract' !== kind.value) continue;
+            const cohort = staticPropertyValue(staticPropertyValue(declaration.init, 'cohort'), 'releaseCohort');
+            const schema = staticPropertyValue(cohort, 'schema');
+            const schemaVersion = staticPropertyValue(cohort, 'schemaVersion');
+            const version = staticPropertyValue(staticPropertyValue(cohort, 'release'), 'version');
+            const versionConstant = version?.type === 'Identifier' ? constants.find((declaration)=>'Identifier' === declaration.id.type && declaration.id.name === version.name && declaration.init?.type === 'StringLiteral') : void 0;
+            if (schema?.type === 'StringLiteral' && 'bleedingdev.ultramodern.release-cohort' === schema.value && schemaVersion?.type === 'NumericLiteral' && 1 === schemaVersion.value && isLiteralData(cohort, versionConstant ? new Set([
+                version.name
+            ]) : void 0)) matches.push({
+                cohort,
+                version,
+                versionConstant
+            });
+        }
+        if (1 !== matches.length) return source;
+        const { cohort, version, versionConstant } = matches[0];
+        let content = JSON.stringify(releaseCohort, null, 2);
+        const edits = [];
+        if (versionConstant && !parsed.tokens?.some((token)=>'name' === token.type.label && token.value === version.name && token.start !== versionConstant.id.start && (token.start < cohort.start || token.end > cohort.end))) {
+            content = content.replaceAll(`"version": ${JSON.stringify(releaseCohort.release.version)}`, `"version": ${version.name}`);
+            edits.push({
+                start: versionConstant.init.start,
+                end: versionConstant.init.end,
+                content: JSON.stringify(releaseCohort.release.version)
+            });
+        }
+        edits.push({
+            start: cohort.start,
+            end: cohort.end,
+            content
+        });
+        for (const edit of edits.toSorted((left, right)=>right.start - left.start))source = source.slice(0, edit.start) + edit.content + source.slice(edit.end);
+        return source;
+    } catch  {
+        return source;
+    }
+}
+function preserveConsumerWorkspaceArtifacts(io, candidates) {
+    const preservedPaths = new Set();
+    const physicalRoot = external_node_fs_default().realpathSync(io.workspaceRoot);
+    const canonicalSources = (0, fs_io_cjs_namespaceObject.formatGeneratedSourceCandidates)(candidates.map((candidate, index)=>[
+            `canonical/${index}/${candidate.relativePath}`,
+            withoutGeneratedData(candidate.content, candidate.generatedDataBinding)
+        ]));
+    for (const [index, candidate] of candidates.entries()){
+        const paths = [
+            candidate.relativePath,
+            candidate.legacyPath
+        ].filter((value)=>void 0 !== value);
+        for (const relativePath of paths){
+            const filePath = external_node_path_default().join(io.workspaceRoot, relativePath);
+            if (!external_node_fs_default().existsSync(filePath)) continue;
+            const physicalRelative = external_node_path_default().relative(physicalRoot, external_node_fs_default().realpathSync(filePath));
+            if ('..' === physicalRelative || physicalRelative.startsWith(`..${external_node_path_default().sep}`) || external_node_path_default().isAbsolute(physicalRelative)) throw new Error(`Refusing to inspect an artifact outside the workspace: ${relativePath}`);
+            const source = external_node_fs_default().readFileSync(filePath, 'utf8');
+            let recognized = source === candidate.content;
+            if (!recognized) try {
+                const normalized = withoutGeneratedData(source, candidate.generatedDataBinding);
+                const canonical = canonicalSources[index];
+                recognized = normalized === canonical || (0, fs_io_cjs_namespaceObject.formatGeneratedSourceCandidates)([
+                    [
+                        relativePath,
+                        normalized
+                    ]
+                ])[0] === canonical;
+            } catch  {}
+            if (!recognized) for (const pairedPath of paths)preservedPaths.add(pairedPath);
+        }
+    }
+    const reported = new Set();
+    const isPreserved = (filePath)=>{
+        const relativePath = external_node_path_default().relative(io.workspaceRoot, filePath).split(external_node_path_default().sep).join('/');
+        if (!preservedPaths.has(relativePath)) return false;
+        if (!reported.has(relativePath)) {
+            io.log(`${relativePath} preserved consumer-owned artifact: its canonical generated source does not match.`);
+            reported.add(relativePath);
+        }
+        return true;
+    };
+    return {
+        preservedPaths,
+        refreshReleaseCohort (releaseCohort) {
+            if (!releaseCohort) return;
+            for (const candidate of candidates)if ('workspaceValidationContract' === candidate.generatedDataBinding) for (const relativePath of [
+                candidate.relativePath,
+                candidate.legacyPath
+            ]){
+                if (!relativePath || !preservedPaths.has(relativePath)) continue;
+                const filePath = external_node_path_default().join(io.workspaceRoot, relativePath);
+                if (!external_node_fs_default().existsSync(filePath)) continue;
+                const source = external_node_fs_default().readFileSync(filePath, 'utf8');
+                io.write(filePath, refreshValidatorReleaseCohort(source, releaseCohort));
+            }
+        },
+        io: {
+            ...io,
+            write: (filePath, content)=>isPreserved(filePath) ? false : io.write(filePath, content),
+            writeGenerated: (filePath, content)=>isPreserved(filePath) ? false : io.writeGenerated(filePath, content),
+            remove: (filePath)=>isPreserved(filePath) ? false : io.remove(filePath)
+        }
+    };
+}
+exports.preserveConsumerWorkspaceArtifacts = __webpack_exports__.preserveConsumerWorkspaceArtifacts;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "preserveConsumerWorkspaceArtifacts"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/ultramodern-tooling/commands/migrate-strict-effect.cjs

@@ -44,11 +44,13 @@ var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node
 const external_node_path_namespaceObject = require("node:path");
 var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
 const external_ultramodern_release_cohort_cjs_namespaceObject = require("../../ultramodern-release-cohort.cjs");
+const app_files_cjs_namespaceObject = require("../../ultramodern-workspace/app-files.cjs");
 const contracts_cjs_namespaceObject = require("../../ultramodern-workspace/contracts.cjs");
 const delivery_unit_stamp_cjs_namespaceObject = require("../../ultramodern-workspace/delivery-unit-stamp.cjs");
 const policy_cjs_namespaceObject = require("../../ultramodern-workspace/policy.cjs");
 const shells_cjs_namespaceObject = require("../../ultramodern-workspace/shells.cjs");
 const workspace_scripts_cjs_namespaceObject = require("../../ultramodern-workspace/workspace-scripts.cjs");
+const zerops_cjs_namespaceObject = require("../../ultramodern-workspace/zerops.cjs");
 const external_config_cjs_namespaceObject = require("../config.cjs");
 const api_metadata_cjs_namespaceObject = require("./migrate-strict-effect/api-metadata.cjs");
 const declaration_patches_cjs_namespaceObject = require("./migrate-strict-effect/declaration-patches.cjs");
@@ -61,7 +63,9 @@ const package_cohort_cjs_namespaceObject = require("./migrate-strict-effect/pack
 const package_source_cjs_namespaceObject = require("./migrate-strict-effect/package-source.cjs");
 const pnpm_policy_cjs_namespaceObject = require("./migrate-strict-effect/pnpm-policy.cjs");
 const react_router_retirement_cjs_namespaceObject = require("./migrate-strict-effect/react-router-retirement.cjs");
+const shared_api_infrastructure_cjs_namespaceObject = require("./migrate-strict-effect/shared-api-infrastructure.cjs");
 const toolchain_pins_cjs_namespaceObject = require("./migrate-strict-effect/toolchain-pins.cjs");
+const workspace_artifact_ownership_cjs_namespaceObject = require("./migrate-strict-effect/workspace-artifact-ownership.cjs");
 const external_options_cjs_namespaceObject = require("./options.cjs");
 const retiredMetadataPaths = [
     '.modernjs/ultramodern-generated-contract.json',
@@ -117,10 +121,24 @@ function synchronizeMigrationDeliveryUnitMetadata(io, raw, packageSource) {
         'schemaVersion',
         'id',
         "description",
-        'preset',
-        'sharedPackages',
-        'validation'
-    ])topology[key] = canonicalTopology[key];
+        'preset'
+    ])if ('id' === key || "description" === key) topology[key] ??= canonicalTopology[key];
+    else topology[key] = canonicalTopology[key];
+    const existingSharedPackages = Array.isArray(topology.sharedPackages) ? topology.sharedPackages : [];
+    topology.sharedPackages = [
+        ...existingSharedPackages,
+        ...canonicalTopology.sharedPackages.filter((candidate)=>!existingSharedPackages.some((existing)=>existing.id === candidate.id))
+    ];
+    topology.validation = {
+        ...canonicalTopology.validation,
+        ...topology.validation,
+        commands: [
+            ...new Set([
+                ...topology.validation?.commands ?? [],
+                ...canonicalTopology.validation.commands
+            ])
+        ]
+    };
     const canonicalTopologyApps = new Map([
         canonicalTopology.shell,
         ...canonicalTopology.verticals ?? []
@@ -143,8 +161,21 @@ function synchronizeMigrationDeliveryUnitMetadata(io, raw, packageSource) {
                 'api',
                 'cloudflare',
                 'ownership'
-            ])if (Object.hasOwn(canonicalEntry, key)) entry[key] = canonicalEntry[key];
-            else delete entry[key];
+            ])if (Object.hasOwn(canonicalEntry, key)) {
+                const canonicalValue = canonicalEntry[key];
+                if ('api' === key && entry.api && canonicalValue && 'object' == typeof canonicalValue) {
+                    const nextApi = {
+                        ...entry.api,
+                        ...canonicalValue
+                    };
+                    if (!Object.hasOwn(entry.api, 'domainOperations')) delete nextApi.domainOperations;
+                    entry.api = nextApi;
+                } else if ('cloudflare' === key && entry.cloudflare && canonicalValue && 'object' == typeof canonicalValue) entry.cloudflare = {
+                    ...canonicalValue,
+                    ...entry.cloudflare
+                };
+                else entry[key] = canonicalValue;
+            } else delete entry[key];
         }
     }
     (0, io_cjs_namespaceObject.writeJsonFile)(io, topologyPath, topology);
@@ -165,7 +196,10 @@ function synchronizeMigrationCompactPolicy(io, raw, packageSource) {
     const apps = (0, external_config_cjs_namespaceObject.workspaceAppsFromToolingConfig)(migrated);
     apps.filter((app)=>'shell' !== app.kind);
     const canonical = requireRecord((0, contracts_cjs_namespaceObject.createUltramodernConfig)(migrated.workspace.packageScope, packageSource.modernPackageVersion, packageSource, apps, migrated.features.tailwind, migrated.bridge, (0, external_config_cjs_namespaceObject.additionalShellsFromToolingConfig)(migrated), apps.find((app)=>'shell' === app.kind)), 'Generated compact policy');
-    for (const key of compactPolicyKeys)raw[key] = canonical[key];
+    for (const key of compactPolicyKeys){
+        if ('workspace' === key) canonical.workspace.packageManager.version = raw.workspace.packageManager.version;
+        raw[key] = canonical[key];
+    }
     (0, io_cjs_namespaceObject.writeJsonFile)(io, external_node_path_default().join(io.workspaceRoot, '.modernjs/ultramodern.json'), raw);
 }
 function reconcileRootPackageSourceMetadata(packageJson, packageSource) {
@@ -305,6 +339,33 @@ function migrateStrictEffect(args, context, io, dryRun, skipInstall) {
             version: packageSource.modernPackageVersion
         });
     const releaseCohort = 'install' === packageSource.strategy ? (0, external_ultramodern_release_cohort_cjs_namespaceObject.readCreateReleaseCohort)() : void 0;
+    const currentApps = (0, external_config_cjs_namespaceObject.workspaceAppsFromToolingConfig)(current);
+    const allCurrentApps = (0, external_config_cjs_namespaceObject.allWorkspaceAppsFromToolingConfig)(current);
+    const artifactOwnership = (0, workspace_artifact_ownership_cjs_namespaceObject.preserveConsumerWorkspaceArtifacts)(io, [
+        ...allCurrentApps.map((app)=>({
+                relativePath: `${app.directory}/src/modern-app-env.d.ts`,
+                content: (0, app_files_cjs_namespaceObject.createAppEnvDts)(app, allCurrentApps.filter((remote)=>'shell' !== remote.kind), current.workspace.packageScope)
+            })),
+        ...(0, workspace_scripts_cjs_namespaceObject.migratedWorkspaceScriptArtifacts)({
+            shellOnly: false,
+            hasBackendSurface: true
+        }).filter((artifact)=>"scripts/validate-ultramodern-workspace.mts" !== artifact.relativePath),
+        {
+            relativePath: "scripts/validate-ultramodern-workspace.mts",
+            legacyPath: "scripts/validate-ultramodern-workspace.mjs",
+            generatedDataBinding: 'workspaceValidationContract',
+            content: (0, workspace_scripts_cjs_namespaceObject.createWorkspaceValidationScript)(current.workspace.packageScope, current.features.tailwind, currentApps.filter((app)=>'shell' !== app.kind), void 0, (0, external_config_cjs_namespaceObject.additionalShellsFromToolingConfig)(current), currentApps.find((app)=>'shell' === app.kind))
+        },
+        {
+            relativePath: 'zerops.yaml',
+            content: `${(0, zerops_cjs_namespaceObject.createZeropsYaml)(current.workspace.packageScope, (0, external_config_cjs_namespaceObject.allWorkspaceAppsFromToolingConfig)(current))}\n`
+        },
+        {
+            relativePath: "scripts/materialize-zerops-runtime.mjs",
+            content: (0, workspace_scripts_cjs_namespaceObject.createZeropsRuntimeMaterializationScript)()
+        }
+    ]);
+    io = artifactOwnership.io;
     (0, api_metadata_cjs_namespaceObject.reconcileCompactPackageSourceMetadata)(raw.packageSource, packageSource);
     reconcileRootPackageSourceMetadata((0, io_cjs_namespaceObject.readJsonFile)(external_node_path_default().join(io.workspaceRoot, 'package.json')), packageSource);
     (0, pnpm_policy_cjs_namespaceObject.updateGeneratedPnpmWorkspacePolicy)((0, io_cjs_namespaceObject.createMigrationIo)(io.workspaceRoot, true), packageSource, {
@@ -325,6 +386,7 @@ function migrateStrictEffect(args, context, io, dryRun, skipInstall) {
     const verticalApps = migrated.topology.apps.filter((app)=>'shell' !== app.kind);
     const hasBackendSurface = verticalApps.some((app)=>app.api);
     const shellOnly = 0 === verticalApps.length;
+    if (hasBackendSurface) (0, shared_api_infrastructure_cjs_namespaceObject.ensureSharedApiInfrastructure)(io, migrated.workspace.packageScope, packageSource);
     if (shellOnly) {
         io.log('Shell-only workspace: skipping backend-federation and Zerops runtime stages.');
         for (const relativePath of [
@@ -355,6 +417,7 @@ function migrateStrictEffect(args, context, io, dryRun, skipInstall) {
         io.writeGenerated(external_node_path_default().join(io.workspaceRoot, artifact.relativePath), artifact.content);
     }
     io.writeGenerated(external_node_path_default().join(io.workspaceRoot, "scripts/validate-ultramodern-workspace.mts"), (0, workspace_scripts_cjs_namespaceObject.createWorkspaceValidationScript)(validationContractInputs.scope, validationContractInputs.enableTailwind, validationContractInputs.remotes, releaseCohort, validationContractInputs.additionalShells, validationContractInputs.primaryShell, raw, external_node_fs_default().existsSync(external_node_path_default().join(io.workspaceRoot, 'topology/ownership.json')) ? requireRecord((0, io_cjs_namespaceObject.readJsonFile)(external_node_path_default().join(io.workspaceRoot, 'topology/ownership.json')), 'Ownership topology') : void 0, developmentOverlay));
+    artifactOwnership.refreshReleaseCohort(releaseCohort);
     for (const relativePath of retiredMetadataPaths)io.remove(external_node_path_default().join(io.workspaceRoot, relativePath));
     (0, generated_artifacts_cjs_namespaceObject.updateGeneratedBuildIdentityModules)(io, migrated);
     (0, generated_artifacts_cjs_namespaceObject.updateGeneratedTypeScriptSurfaces)(io, migrated);
@@ -369,7 +432,7 @@ function migrateStrictEffect(args, context, io, dryRun, skipInstall) {
             reconcileRootPackageSourceMetadata(packageJson, packageSource);
             (0, toolchain_pins_cjs_namespaceObject.updateRootPackageToolchain)(packageJson);
         }
-        (0, package_cohort_cjs_namespaceObject.updateModernDependencies)(packageJson, packageSource);
+        (0, package_cohort_cjs_namespaceObject.updateModernDependencies)(packageJson, packageSource, releaseCohort);
         const ownsGeneratedScripts = 'package.json' === relativePackageFile || allMigratedApps.some((app)=>`${app.directory}/package.json` === relativePackageFile);
         (0, package_cohort_cjs_namespaceObject.updateGeneratedToolingDependencies)(packageJson, {
             ownsGeneratedScripts
@@ -379,6 +442,7 @@ function migrateStrictEffect(args, context, io, dryRun, skipInstall) {
         if ('preserved' === retiredReactRouter) io.log(`${relativePackageFile} keeps its react-router dependency: authored source imports React Router directly, so its generated Module Federation config keeps bridge.enableBridgeRouter: true.`);
         else if ('removed' === retiredReactRouter) io.log(`${relativePackageFile} dropped its obsolete react-router dependency: no authored source imports React Router.`);
         (0, package_cohort_cjs_namespaceObject.updateGeneratedPackageScripts)(packageJson, {
+            preservedArtifacts: artifactOwnership.preservedPaths,
             relativePackageFile,
             apps: allMigratedApps,
             shellOnly,

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

@@ -35,7 +35,7 @@ const external_descriptors_cjs_namespaceObject = require("../descriptors.cjs");
 const external_naming_cjs_namespaceObject = require("../naming.cjs");
 const external_checkout_cart_cjs_namespaceObject = require("./checkout-cart.cjs");
 const external_names_cjs_namespaceObject = require("./names.cjs");
-function createApiClient(service, contractImportPath) {
+function createApiClient(service, contractImportPath, options) {
     const apiExport = (0, external_names_cjs_namespaceObject.verticalApiExport)(service);
     const contractExport = (0, external_names_cjs_namespaceObject.verticalApiGroupName)(service);
     const stem = (0, external_descriptors_cjs_namespaceObject.resolveApiStem)(service);
@@ -151,7 +151,7 @@ export const ${readinessName} = (
     operationContext:
       options.operationContext ?? ${groupName}OperationContexts.readiness,
   }).pipe(
-    Effect.flatMap(client => client.${groupName}.readiness({})),
+    Effect.flatMap(client => client.${options ? 'foundation' : groupName}.readiness({})),
   );
 
 export const ${getName} = (

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

@@ -37,23 +37,22 @@ const external_naming_cjs_namespaceObject = require("../naming.cjs");
 const external_checkout_cart_cjs_namespaceObject = require("./checkout-cart.cjs");
 const external_names_cjs_namespaceObject = require("./names.cjs");
 const external_rpc_cjs_namespaceObject = require("./rpc.cjs");
-function createApiServiceEntry(service, contractImportPath) {
+function createApiServiceEntry(service, contractImportPath, options) {
     if ((service.api?.protocol ?? 'rest') === 'rpc') return (0, external_rpc_cjs_namespaceObject.createRpcApiServiceEntry)(service);
     const apiExport = (0, external_names_cjs_namespaceObject.verticalApiExport)(service);
     const groupName = (0, external_names_cjs_namespaceObject.verticalApiGroupName)(service);
     const notFoundErrorExport = (0, external_names_cjs_namespaceObject.verticalApiNotFoundErrorExport)(service);
     const stem = (0, external_descriptors_cjs_namespaceObject.resolveApiStem)(service);
-    return `import {
-  defineEffectBff,
+    const assemblyImport = options ? `import { assembleEffectBffRuntime } from '${(0, external_naming_cjs_namespaceObject.packageName)(options.scope, 'shared-contracts')}/server/effect-bff-runtime';\n` : '';
+    return `${assemblyImport}import {
+  ${options ? '' : 'defineEffectBff,'}
   Effect,
   HttpApiBuilder,
   Layer,
 } from '@modern-js/plugin-bff/effect-edge';
-import type {
-  EffectBffDefinition,
-  EffectBffRuntime,
+${options ? '' : `import type {
   EffectRuntimeLayer,
-} from '@modern-js/plugin-bff/effect-edge';
+} from '@modern-js/plugin-bff/effect-edge';`}
 import { ultramodernApiMarker } from '../shared/ultramodern-build.ts';
 import {
   ${apiExport},
@@ -83,6 +82,31 @@ const operationAttributes = (operationContext: OperationContext) => ({
       : {}),
   });
 
+${options ? `const ${groupName}ReadinessLayer = HttpApiBuilder.group(
+  ${apiExport},
+  'foundation',
+  handlers => handlers
+      .handle('readiness', () =>
+        Effect.succeed({
+          checks: {
+            api: 'ready' as const,
+            moduleFederation: 'ready' as const,
+            ssr: 'ready' as const,
+            translations: 'ready' as const,
+          },
+          marker: ultramodernApiMarker,
+          status: 'ready' as const,
+          versionSkew: 'none' as const,
+        }).pipe(
+          Effect.withSpan('ultramodern.api.${groupName}.readiness', {
+            attributes: operationAttributes(${groupName}OperationContexts.readiness),
+            kind: 'server',
+          }),
+        ),
+      )
+,
+);` : ''}
+
 const ${groupName}Layer = HttpApiBuilder.group(
   ${apiExport},
   '${groupName}',
@@ -101,7 +125,7 @@ const ${groupName}Layer = HttpApiBuilder.group(
           }),
         ),
       )
-      .handle('readiness', () =>
+${options ? '' : `      .handle('readiness', () =>
         Effect.succeed({
           checks: {
             api: 'ready' as const,
@@ -119,6 +143,7 @@ const ${groupName}Layer = HttpApiBuilder.group(
           }),
         ),
       )
+`}
       .handle('get', ({ params }) => {
         const matchedItem = ${groupName}Items.find(
           candidate => candidate.id === params.id,
@@ -158,14 +183,18 @@ const ${groupName}Layer = HttpApiBuilder.group(
       )${(0, external_checkout_cart_cjs_namespaceObject.createCheckoutCartServerHandlers)(service)},
 );
 
-const layer = HttpApiBuilder.layer(${apiExport}).pipe(
-  Layer.provide(${groupName}Layer),
-) satisfies EffectRuntimeLayer;
-const apiRuntime: EffectBffDefinition<typeof ${apiExport}, EffectRuntimeLayer> &
-  EffectBffRuntime<typeof ${apiExport}, EffectRuntimeLayer> = defineEffectBff({
-  api: ${apiExport},
-  layer,
-});
+${options ? `const apiHandlersLive = Layer.mergeAll(${groupName}Layer, ${groupName}ReadinessLayer);
+export const make${apiExport[0].toUpperCase()}${apiExport.slice(1)}Runtime = () =>
+  assembleEffectBffRuntime({
+    api: ${apiExport},
+    handlers: apiHandlersLive,
+  });` : `export const make${apiExport[0].toUpperCase()}${apiExport.slice(1)}Runtime = () => {
+  const layer = HttpApiBuilder.layer(${apiExport}).pipe(
+    Layer.provide(${groupName}Layer),
+  ) satisfies EffectRuntimeLayer;
+  return defineEffectBff({ api: ${apiExport}, layer });
+};`}
+const apiRuntime = make${apiExport[0].toUpperCase()}${apiExport.slice(1)}Runtime();
 
 export default apiRuntime;
 `;

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

@@ -45,7 +45,7 @@ function createSharedApiImports() {
 } from '@modern-js/plugin-bff/effect-client';
 `;
 }
-function createSharedApiContract(service) {
+function createSharedApiContract(service, shared = false) {
     const schemaExport = (0, external_names_cjs_namespaceObject.verticalApiSchemaExport)(service);
     const markerSchemaExport = (0, external_names_cjs_namespaceObject.verticalApiMarkerSchemaExport)(service);
     const readinessSchemaExport = (0, external_names_cjs_namespaceObject.verticalApiReadinessSchemaExport)(service);
@@ -102,7 +102,7 @@ function createSharedApiContract(service) {
         listOperationContext,
         readinessOperationContext
     }).trim();
-    return `export interface ${markerType} {
+    return `${shared ? `export type ${markerType} = MicroVerticalBuildMarker;` : `export interface ${markerType} {
   readonly appId: string;
   readonly build: string;
   readonly buildMarker: string;
@@ -112,7 +112,7 @@ function createSharedApiContract(service) {
   readonly surface: string;
   readonly unitId: string;
   readonly version: string;
-}
+}`}
 
 export interface ${itemType} {
   readonly id: string;
@@ -120,7 +120,7 @@ export interface ${itemType} {
   readonly title: string;
 }
 
-export interface ${readinessType} {
+${shared ? `export type ${readinessType} = MicroVerticalReadiness;` : `export interface ${readinessType} {
   readonly checks: {
     readonly api: 'ready';
     readonly moduleFederation: 'ready';
@@ -130,7 +130,7 @@ export interface ${readinessType} {
   readonly marker: ${markerType};
   readonly status: 'ready';
   readonly versionSkew: 'none';
-}
+}`}
 
 export interface ${createPayloadType} {
   readonly title: string;
@@ -149,7 +149,7 @@ export interface ${notFoundErrorExport} {
   readonly id: string;
 }
 
-export const ${markerSchemaExport}: Schema.Codec<${markerType}> = Schema.Struct({
+${shared ? `export const ${markerSchemaExport}: Schema.Codec<${markerType}> = MicroVerticalBuildMarkerSchema;` : `export const ${markerSchemaExport}: Schema.Codec<${markerType}> = Schema.Struct({
   appId: Schema.String,
   build: Schema.String,
   buildMarker: Schema.String,
@@ -159,7 +159,7 @@ export const ${markerSchemaExport}: Schema.Codec<${markerType}> = Schema.Struct(
   surface: Schema.String,
   unitId: Schema.String,
   version: Schema.String,
-});
+});`}
 
 export const ${schemaExport}: Schema.Codec<${itemType}> = Schema.Struct({
   id: Schema.String,
@@ -167,7 +167,7 @@ export const ${schemaExport}: Schema.Codec<${itemType}> = Schema.Struct({
   title: Schema.String,
 });
 
-export const ${readinessSchemaExport}: Schema.Codec<${readinessType}> = Schema.Struct({
+${shared ? `export const ${readinessSchemaExport}: Schema.Codec<${readinessType}> = MicroVerticalReadinessSchema;` : `export const ${readinessSchemaExport}: Schema.Codec<${readinessType}> = Schema.Struct({
   checks: Schema.Struct({
     api: Schema.Literal('ready'),
     moduleFederation: Schema.Literal('ready'),
@@ -177,7 +177,7 @@ export const ${readinessSchemaExport}: Schema.Codec<${readinessType}> = Schema.S
   marker: ${markerSchemaExport},
   status: Schema.Literal('ready'),
   versionSkew: Schema.Literal('none'),
-});
+});`}
 
 export const ${createPayloadSchemaExport}: Schema.Codec<${createPayloadType}> = Schema.Struct({
   title: Schema.String,
@@ -189,7 +189,7 @@ ${checkoutCartSharedSchemaSection}export const ${notFoundSchemaExport}: Schema.C
   HttpApiSchema.status(404),
 );
 
-export interface OperationContext {
+${shared ? 'export type OperationContext = MicroVerticalOperationContext;' : `export interface OperationContext {
   method: string;
   operationId: string;
   routePath: string;
@@ -201,9 +201,14 @@ export interface OperationContext {
     | 'data-platform'
     | 'unknown';
   traceId?: string;
-}
+}`}
 
-export const ${apiExport} = HttpApi.make('${apiName}').add(
+${shared ? `export const ${groupName}FoundationApi = HttpApi.make('${apiName}Foundation').add(
+  HttpApiGroup.make('foundation').add(
+    HttpApiEndpoint.get('readiness', '/${stem}/readiness', { success: ${readinessSchemaExport} }),
+  ),
+);` : ''}
+export const ${apiExport} = HttpApi.make('${apiName}')${shared ? `.addHttpApi(${groupName}FoundationApi)` : ''}.add(
   HttpApiGroup.make('${groupName}')
     .add(
       HttpApiEndpoint.get('list', '/${stem}', {
@@ -215,11 +220,12 @@ export const ${apiExport} = HttpApi.make('${apiName}').add(
         }),
       }),
     )
-    .add(
+${shared ? '' : `    .add(
       HttpApiEndpoint.get('readiness', '/${stem}/readiness', {
         success: ${readinessSchemaExport},
       }),
     )
+`}
     .add(
       HttpApiEndpoint.get('get', '/${stem}/:id', {
         error: ${notFoundSchemaExport},
@@ -240,7 +246,7 @@ export const ${apiExport} = HttpApi.make('${apiName}').add(
 );
 
 export const ${groupName}OperationContexts = {
-${operationContextEntries}
+${shared ? operationContextEntries.replaceAll(/(\w+: )\{([\s\S]*?)\},/gu, (_, key, fields)=>`${key}createMicroVerticalOperationContext({${fields.replace(/\n\s*source: 'generated-client',/u, '')}}),`) : operationContextEntries}
 } satisfies Record<string, OperationContext>;
 
 export const ${groupName}ApiContract = {
@@ -251,9 +257,13 @@ ${(0, external_checkout_cart_cjs_namespaceObject.createCheckoutCartApiContractFi
 } as const;
 `;
 }
-function createSharedApi(service) {
+function createSharedApi(service, options) {
+    const imports = options ? `import { MicroVerticalBuildMarkerSchema, MicroVerticalReadinessSchema, createMicroVerticalOperationContext } from '${(0, external_naming_cjs_namespaceObject.packageName)(options.scope, 'shared-contracts')}/microvertical-api-baseline';
+import type { MicroVerticalBuildMarker, MicroVerticalReadiness, MicroVerticalOperationContext } from '${(0, external_naming_cjs_namespaceObject.packageName)(options.scope, 'shared-contracts')}/microvertical-api-baseline';
+` : '';
     return `${createSharedApiImports()}
-${createSharedApiContract(service)}`;
+${imports}
+${createSharedApiContract(service, void 0 !== options)}`;
 }
 exports.createSharedApi = __webpack_exports__.createSharedApi;
 for(var __rspack_i in __webpack_exports__)if (-1 === [

package/dist/cjs/ultramodern-workspace/mf-validation/inspect.cjs

@@ -43,7 +43,11 @@ function extractExposes(configPath, value) {
     if (array) return array.sort();
     throw new Error(`Cannot statically extract Module Federation exposes from ${configPath}; use a literal exposes object or string array.`);
 }
-function extractDtsSettings(configPath, value) {
+function extractDtsSettings(configPath, value, exposes) {
+    if ('false' === value) {
+        if (exposes.length > 0) throw new Error(`Module Federation DTS cannot be disabled for exposed app ${configPath}.`);
+        return {};
+    }
     if (void 0 === value) return {};
     const dts = (0, external_object_literal_cjs_namespaceObject.parseObjectLiteral)(value);
     if (!dts || dts.hasSpread) throw new Error(`Cannot statically extract Module Federation DTS settings from ${configPath}; use a literal dts object.`);
@@ -70,7 +74,7 @@ function inspectModuleFederationConfigSource(source, appDir, configPath) {
     return {
         appDir,
         configPath,
-        dts: extractDtsSettings(configPath, properties.properties.get('dts')),
+        dts: extractDtsSettings(configPath, properties.properties.get('dts'), exposes),
         exposes,
         hostOnlyNoExposes
     };