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

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

@@ -113,6 +113,7 @@ function mergeTypeScriptConfig(generated, existing) {
         ...existingCompilerOptions,
         ...generatedCompilerOptions
     };
+    if (Array.isArray(generatedCompilerOptions.types)) compilerOptions.types = mergeUniqueJsonValues(generatedCompilerOptions.types, existingCompilerOptions.types);
     if (Array.isArray(generatedCompilerOptions.plugins) || Array.isArray(existingCompilerOptions.plugins)) compilerOptions.plugins = mergeTypeScriptPlugins(generatedCompilerOptions.plugins, existingCompilerOptions.plugins);
     const merged = {
         ...existingConfig,

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

@@ -170,6 +170,8 @@ function mergeGeneratedScript(consumer, framework, canRetireLegacyOxfmtCliExclus
     const frameworkSegmentSet = new Set(frameworkSegments);
     const canonicalFrameworkSegment = (segment)=>{
         if (frameworkSegmentSet.has(segment)) return segment;
+        const referenceBuild = segment.replace('--project tsconfig.json', '--build tsconfig.json');
+        if (frameworkSegmentSet.has(referenceBuild)) return referenceBuild;
         const portableEnvironmentSegment = `cross-env ${segment}`;
         if (frameworkSegmentSet.has(portableEnvironmentSegment)) return portableEnvironmentSegment;
         const portableOxfmtSegment = segment.replace(/ '!repos\/\*\*'$/u, '');

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

@@ -0,0 +1,99 @@
+"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__, {
+    ensureSharedApiInfrastructure: ()=>ensureSharedApiInfrastructure
+});
+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 fs_io_cjs_namespaceObject = require("../../../ultramodern-workspace/fs-io.cjs");
+const package_json_cjs_namespaceObject = require("../../../ultramodern-workspace/package-json.cjs");
+const external_io_cjs_namespaceObject = require("./io.cjs");
+const directory = 'packages/shared-contracts';
+function record(value, label) {
+    if (null === value || 'object' != typeof value || Array.isArray(value)) throw new Error(`${label} must be an object; resolve it before migration.`);
+    return value;
+}
+function ensureSharedApiInfrastructure(io, scope, packageSource) {
+    for (const relativePath of [
+        'packages',
+        directory,
+        `${directory}/package.json`,
+        `${directory}/src`,
+        `${directory}/src/index.ts`
+    ])if (external_node_fs_default().lstatSync(external_node_path_default().join(io.workspaceRoot, relativePath), {
+        throwIfNoEntry: false
+    })?.isSymbolicLink()) throw new Error(`Shared API migration cannot write through a symbolic link: ${relativePath}`);
+    const manifestPath = external_node_path_default().join(io.workspaceRoot, directory, 'package.json');
+    const defaults = (0, package_json_cjs_namespaceObject.createSharedPackage)(scope, 'shared-contracts', 'Shared workspace contracts', packageSource);
+    const manifest = external_node_fs_default().existsSync(manifestPath) ? record((0, external_io_cjs_namespaceObject.readJsonFile)(manifestPath), `${directory}/package.json`) : defaults;
+    const exports1 = void 0 === manifest.exports ? {} : 'string' == typeof manifest.exports ? {
+        '.': manifest.exports
+    } : record(manifest.exports, `${directory}/package.json exports`);
+    if (Object.keys(exports1).some((key)=>!key.startsWith('.')) || void 0 !== exports1['.'] && './src/index.ts' !== exports1['.']) throw new Error(`${directory}/package.json exports must expose ./src/index.ts at "." before adding shared API infrastructure; consumer exports were not overwritten.`);
+    for (const [subpath, target] of Object.entries(record(defaults.exports, 'Shared contract exports')))if (void 0 !== exports1[subpath] && exports1[subpath] !== target) throw new Error(`${directory}/package.json ${subpath} must expose ${String(target)}; consumer exports were not overwritten.`);
+    const dependencies = record(manifest.dependencies ?? {}, `${directory}/package.json dependencies`);
+    manifest.exports = {
+        ...record(defaults.exports, 'Shared contract exports'),
+        ...exports1
+    };
+    manifest.dependencies = {
+        ...record(defaults.dependencies, 'Shared contract dependencies'),
+        ...dependencies
+    };
+    const writeMissing = (relativePath, content)=>{
+        const filePath = external_node_path_default().join(io.workspaceRoot, directory, relativePath);
+        if (void 0 === external_node_fs_default().lstatSync(filePath, {
+            throwIfNoEntry: false
+        })) io.writeGenerated(filePath, content);
+    };
+    writeMissing('src/effect-bff-runtime.ts', (0, fs_io_cjs_namespaceObject.readFileTemplate)('packages/effect-bff-runtime.ts'));
+    writeMissing('src/microvertical-api-baseline.ts', (0, fs_io_cjs_namespaceObject.readFileTemplate)('packages/microvertical-api-baseline.ts'));
+    writeMissing('tsconfig.json', `${JSON.stringify((0, package_json_cjs_namespaceObject.createSharedPackageTsConfig)(directory), null, 2)}\n`);
+    writeMissing('src/index.ts', (0, fs_io_cjs_namespaceObject.readFileTemplate)('packages/shared-contracts-index.ts'));
+    (0, external_io_cjs_namespaceObject.writeJsonFile)(io, manifestPath, manifest);
+}
+exports.ensureSharedApiInfrastructure = __webpack_exports__.ensureSharedApiInfrastructure;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "ensureSharedApiInfrastructure"
+].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/toolchain-pins.cjs

@@ -80,6 +80,7 @@ function updateRootPackageToolchain(packageJson) {
     const devDependencies = ensureRecord(packageJson, 'devDependencies', 'package.json devDependencies');
     for (const packageName of retiredRootToolingDependencies)delete devDependencies[packageName];
     devDependencies["@typescript/native"] = policy_cjs_namespaceObject.ULTRAMODERN_PACKAGE_PINS.rootDevDependencies["@typescript/native"];
+    devDependencies['@types/node'] = policy_cjs_namespaceObject.ULTRAMODERN_PACKAGE_PINS.rootDevDependencies["@types/node"];
     devDependencies.miniflare = policy_cjs_namespaceObject.ULTRAMODERN_PACKAGE_PINS.rootDevDependencies.miniflare;
 }
 function updateMiseTools(content) {

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

@@ -61,6 +61,7 @@ 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 external_options_cjs_namespaceObject = require("./options.cjs");
 const retiredMetadataPaths = [
@@ -325,6 +326,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 [

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
     };

package/dist/cjs/ultramodern-workspace/module-federation/reexport-module.cjs

@@ -79,22 +79,17 @@ const ultramodernBuildArtifact = {
   },
 } as const;
 
-export { ultramodernBuildArtifact };
-
 export const ultramodernDeliveryUnit =
   ultramodernBuildArtifact.deliveryUnit;
-export const ultramodernVerticalIdentity = ultramodernDeliveryUnit;
 export const ultramodernUiMarker = ultramodernBuildArtifact.surfaces.ui;
 export const ultramodernApiMarker = ultramodernBuildArtifact.surfaces.api;
 `;
 }
 function createUltramodernBuildReexportModule() {
     return `export {
-  ultramodernBuildArtifact,
   ultramodernApiMarker,
   ultramodernDeliveryUnit,
   ultramodernUiMarker,
-  ultramodernVerticalIdentity,
 } from '../shared/ultramodern-build';
 `;
 }

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

@@ -214,7 +214,7 @@ function createAppPackage(scope, app, packageSource, enableTailwind, remotes = [
     if (Object.keys(packageExports).length > 0) packageJson.exports = packageExports;
     return packageJson;
 }
-function createSharedPackage(scope, id, description) {
+function createSharedPackage(scope, id, description, packageSource) {
     const packageJson = {
         private: true,
         name: (0, external_naming_cjs_namespaceObject.packageName)(scope, id),
@@ -231,6 +231,17 @@ function createSharedPackage(scope, id, description) {
             '@effect/tsgo': external_policy_cjs_namespaceObject.ULTRAMODERN_PACKAGE_PINS.appDevDependencies["@effect/tsgo"]
         }
     };
+    if ('shared-contracts' === id) {
+        packageJson.exports = {
+            '.': './src/index.ts',
+            './microvertical-api-baseline': './src/microvertical-api-baseline.ts',
+            './server/effect-bff-runtime': './src/effect-bff-runtime.ts'
+        };
+        packageJson.dependencies = {
+            ...external_policy_cjs_namespaceObject.ULTRAMODERN_PACKAGE_PINS.bffEffectDependencies,
+            '@modern-js/plugin-bff': packageSource ? (0, external_ultramodern_package_source_cjs_namespaceObject.modernPackageSpecifier)('@modern-js/plugin-bff', packageSource) : external_ultramodern_package_source_cjs_namespaceObject.WORKSPACE_PACKAGE_VERSION
+        };
+    }
     if ('shared-design-tokens' === id) packageJson.exports = {
         ...packageJson.exports,
         './tokens.css': './src/tokens.css'

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

@@ -290,6 +290,7 @@ const ULTRAMODERN_PACKAGE_PINS = {
     rootDevDependencies: {
         '@effect/tsgo': external_versions_cjs_namespaceObject.EFFECT_TSGO_VERSION,
         "@typescript/native": `npm:typescript@${external_versions_cjs_namespaceObject.TYPESCRIPT_VERSION}`,
+        '@types/node': external_versions_cjs_namespaceObject.TYPES_NODE_VERSION,
         'cross-env': external_versions_cjs_namespaceObject.CROSS_ENV_VERSION,
         lefthook: external_versions_cjs_namespaceObject.LEFTHOOK_VERSION,
         miniflare: external_versions_cjs_namespaceObject.MINIFLARE_VERSION,

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

@@ -53,6 +53,9 @@ function createTsConfigBase() {
     return {
         compilerOptions: {
             target: 'ESNext',
+            types: [
+                'node'
+            ],
             lib: [
                 'ESNext',
                 'DOM',

package/dist/cjs/ultramodern-workspace/workspace-script-plan.cjs

@@ -175,7 +175,7 @@ function createWorkspaceRootScriptPlan(remotes = [], options = {}) {
         migrateStrictEffect: rootToolingWrapperCommand('migrateStrictEffect'),
         zeropsMaterialize: "node ./scripts/materialize-zerops-runtime.mjs",
         contractCheck: rootToolingWrapperCommand('validate'),
-        typecheck: options.typecheck ?? `${rootToolingWrapperCommand('typecheck')} --project tsconfig.json`,
+        typecheck: options.typecheck ?? `${rootToolingWrapperCommand('typecheck')} --build tsconfig.json`,
         check: `pnpm format:check && pnpm lint && pnpm typecheck && pnpm skills:check && pnpm i18n:boundaries && pnpm api:check && pnpm contract:check && pnpm performance:readiness${bridgeCheck}`
     };
 }

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

@@ -176,6 +176,7 @@ function writeGeneratedWorkspaceScripts(targetDir, scope, enableTailwind, remote
     const hasBackendSurface = remotes.some(external_descriptors_cjs_namespaceObject.appHasApi);
     writeWorkspaceOwnedMtsScript(targetDir, 'check-ultramodern-i18n-boundaries', createWorkspaceI18nBoundaryValidationScript());
     writeWorkspaceOwnedMtsScript(targetDir, 'check-ultramodern-api-boundaries', createWorkspaceApiBoundaryValidationScript());
+    writeWorkspaceOwnedMtsScript(targetDir, 'microvertical-api-baseline-boundary', (0, external_fs_io_cjs_namespaceObject.readFileTemplate)("workspace-scripts/microvertical-api-baseline-boundary.mts"));
     if (!shellOnly) {
         (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, "scripts/materialize-zerops-runtime.mjs", createZeropsRuntimeMaterializationScript());
         writeWorkspaceOwnedMtsScript(targetDir, 'proof-workerd-ssr', createWorkerdSsrProofScript());
@@ -203,6 +204,10 @@ function migratedWorkspaceScriptArtifacts(options) {
             content: createWorkspaceI18nBoundaryValidationScript(),
             legacyPath: "scripts/check-ultramodern-i18n-boundaries.mjs"
         },
+        {
+            relativePath: "scripts/microvertical-api-baseline-boundary.mts",
+            content: (0, external_fs_io_cjs_namespaceObject.readFileTemplate)("workspace-scripts/microvertical-api-baseline-boundary.mts")
+        },
         {
             relativePath: "scripts/check-ultramodern-api-boundaries.mts",
             content: createWorkspaceApiBoundaryValidationScript(),

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

@@ -122,12 +122,18 @@ function writeAppApiAndRemoteExposeFiles({ targetDir, scope, resolvedApp, emitsU
     if ((0, external_descriptors_cjs_namespaceObject.appHasApi)(resolvedApp)) {
         const rpcProtocol = 'rpc' === (0, external_descriptors_cjs_namespaceObject.resolveApiProtocol)(resolvedApp);
         if (rpcProtocol) (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/shared/rpc.ts`, (0, rpc_cjs_namespaceObject.createRpcContractFile)(resolvedApp));
-        else (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/shared/api.ts`, (0, external_api_cjs_namespaceObject.createSharedApi)(resolvedApp));
-        (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/api/index.ts`, (0, external_api_cjs_namespaceObject.createApiServiceEntry)(resolvedApp, rpcProtocol ? '../shared/rpc.ts' : '../shared/api.ts'));
+        else (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/shared/api.ts`, (0, external_api_cjs_namespaceObject.createSharedApi)(resolvedApp, {
+            scope
+        }));
+        (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/api/index.ts`, (0, external_api_cjs_namespaceObject.createApiServiceEntry)(resolvedApp, rpcProtocol ? '../shared/rpc.ts' : '../shared/api.ts', {
+            scope
+        }));
         (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/api/backend-federation.ts`, (0, external_backend_federation_cjs_namespaceObject.createBackendFederationContractFile)(resolvedApp));
         (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/api/effect-api.ts`, (0, external_api_cjs_namespaceObject.createBackendEffectApiExpose)(scope, resolvedApp));
         if (rpcProtocol) (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-rpc-client.ts`, (0, rpc_cjs_namespaceObject.createRpcClientFile)(resolvedApp));
-        else (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-client.ts`, (0, external_api_cjs_namespaceObject.createApiClient)(resolvedApp, '../../shared/api'));
+        else (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-client.ts`, (0, external_api_cjs_namespaceObject.createApiClient)(resolvedApp, '../../shared/api', {
+            scope
+        }));
     }
     if ('vertical' === resolvedApp.kind && emitsUi) {
         writeAppFile('src/federation-entry.tsx', (0, external_demo_components_cjs_namespaceObject.createRemoteEntry)(resolvedApp));

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

@@ -63,12 +63,14 @@ const external_zerops_cjs_namespaceObject = require("./zerops.cjs");
 function hasExplicitInstallRequest(options) {
     return void 0 !== options.packageSource && 'workspace' !== options.packageSource.strategy;
 }
-function writeSharedPackages(targetDir, scope) {
+function writeSharedPackages(targetDir, scope, packageSource) {
     for (const sharedPackage of external_descriptors_cjs_namespaceObject.sharedPackages){
-        (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${sharedPackage.directory}/package.json`, (0, external_package_json_cjs_namespaceObject.createSharedPackage)(scope, sharedPackage.id, sharedPackage.description));
+        (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${sharedPackage.directory}/package.json`, (0, external_package_json_cjs_namespaceObject.createSharedPackage)(scope, sharedPackage.id, sharedPackage.description, packageSource));
         (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${sharedPackage.directory}/tsconfig.json`, (0, external_package_json_cjs_namespaceObject.createSharedPackageTsConfig)(sharedPackage.directory));
     }
     (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, 'packages/shared-contracts/src/index.ts', (0, external_package_json_cjs_namespaceObject.createSharedContractsIndex)());
+    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, 'packages/shared-contracts/src/microvertical-api-baseline.ts', (0, external_fs_io_cjs_namespaceObject.readFileTemplate)('packages/microvertical-api-baseline.ts'));
+    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, 'packages/shared-contracts/src/effect-bff-runtime.ts', (0, external_fs_io_cjs_namespaceObject.readFileTemplate)('packages/effect-bff-runtime.ts'));
     (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, 'packages/shared-design-tokens/src/index.ts', `export const sharedDesignTokens = {
   color: {
     accent: '#2f8f68',
@@ -188,7 +190,7 @@ function generateUltramodernWorkspaceInPlace(options, logicalWorkspaceRoot = opt
     (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, external_descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH, createCompactUltramodernConfig(scope, options.modernVersion, packageSource, createdApps, enableTailwind, bridge));
     (0, external_write_app_cjs_namespaceObject.writeApp)(options.targetDir, scope, external_descriptors_cjs_namespaceObject.shellApp, packageSource, enableTailwind, initialVerticals, bridge);
     for (const remote of initialVerticals)(0, external_write_app_cjs_namespaceObject.writeApp)(options.targetDir, scope, remote, packageSource, enableTailwind, initialVerticals, bridge);
-    writeSharedPackages(options.targetDir, scope);
+    writeSharedPackages(options.targetDir, scope, packageSource);
     (0, external_workspace_scripts_cjs_namespaceObject.writeGeneratedWorkspaceScripts)(options.targetDir, scope, enableTailwind, initialVerticals, releaseCohort);
     const preliminaryAfterFiles = (0, external_generation_result_cjs_namespaceObject.createFileSnapshot)(options.targetDir);
     const preliminaryDiff = (0, external_generation_result_cjs_namespaceObject.diffFileSnapshots)(beforeFiles, preliminaryAfterFiles);

package/dist/esm/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-typescript.js

@@ -70,6 +70,7 @@ function mergeTypeScriptConfig(generated, existing) {
         ...existingCompilerOptions,
         ...generatedCompilerOptions
     };
+    if (Array.isArray(generatedCompilerOptions.types)) compilerOptions.types = mergeUniqueJsonValues(generatedCompilerOptions.types, existingCompilerOptions.types);
     if (Array.isArray(generatedCompilerOptions.plugins) || Array.isArray(existingCompilerOptions.plugins)) compilerOptions.plugins = mergeTypeScriptPlugins(generatedCompilerOptions.plugins, existingCompilerOptions.plugins);
     const merged = {
         ...existingConfig,

package/dist/esm/ultramodern-tooling/commands/migrate-strict-effect/package-cohort.js

@@ -135,6 +135,8 @@ function mergeGeneratedScript(consumer, framework, canRetireLegacyOxfmtCliExclus
     const frameworkSegmentSet = new Set(frameworkSegments);
     const canonicalFrameworkSegment = (segment)=>{
         if (frameworkSegmentSet.has(segment)) return segment;
+        const referenceBuild = segment.replace('--project tsconfig.json', '--build tsconfig.json');
+        if (frameworkSegmentSet.has(referenceBuild)) return referenceBuild;
         const portableEnvironmentSegment = `cross-env ${segment}`;
         if (frameworkSegmentSet.has(portableEnvironmentSegment)) return portableEnvironmentSegment;
         const portableOxfmtSegment = segment.replace(/ '!repos\/\*\*'$/u, '');