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

package/dist/esm-node/ultramodern-workspace/api/client.js

@@ -3,7 +3,7 @@ import { resolveApiProtocol, resolveApiStem, verticalApiApps } from "../descript
 import { packageName, toPascalCase } from "../naming.js";
 import { createCheckoutCartClientExports, serviceHasCheckoutCartState } from "./checkout-cart.js";
 import { verticalApiErrorStem, verticalApiExport, verticalApiGroupName, verticalApiNotFoundErrorExport } from "./names.js";
-function createApiClient(service, contractImportPath) {
+function createApiClient(service, contractImportPath, options) {
     const apiExport = verticalApiExport(service);
     const contractExport = verticalApiGroupName(service);
     const stem = resolveApiStem(service);
@@ -119,7 +119,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/esm-node/ultramodern-workspace/api/service.js

@@ -5,23 +5,22 @@ import { packageName } from "../naming.js";
 import { createCheckoutCartServerHandlers, createCheckoutCartServerState } from "./checkout-cart.js";
 import { verticalApiExport, verticalApiGroupName, verticalApiNotFoundErrorExport } from "./names.js";
 import { createRpcApiServiceEntry, rpcPath, verticalRpcContractExport, verticalRpcGroupExport } from "./rpc.js";
-function createApiServiceEntry(service, contractImportPath) {
+function createApiServiceEntry(service, contractImportPath, options) {
     if ((service.api?.protocol ?? 'rest') === 'rpc') return createRpcApiServiceEntry(service);
     const apiExport = verticalApiExport(service);
     const groupName = verticalApiGroupName(service);
     const notFoundErrorExport = verticalApiNotFoundErrorExport(service);
     const stem = resolveApiStem(service);
-    return `import {
-  defineEffectBff,
+    const assemblyImport = options ? `import { assembleEffectBffRuntime } from '${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},
@@ -51,6 +50,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}',
@@ -69,7 +93,7 @@ const ${groupName}Layer = HttpApiBuilder.group(
           }),
         ),
       )
-      .handle('readiness', () =>
+${options ? '' : `      .handle('readiness', () =>
         Effect.succeed({
           checks: {
             api: 'ready' as const,
@@ -87,6 +111,7 @@ const ${groupName}Layer = HttpApiBuilder.group(
           }),
         ),
       )
+`}
       .handle('get', ({ params }) => {
         const matchedItem = ${groupName}Items.find(
           candidate => candidate.id === params.id,
@@ -126,14 +151,18 @@ const ${groupName}Layer = HttpApiBuilder.group(
       )${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/esm-node/ultramodern-workspace/api/shared.js

@@ -1,7 +1,7 @@
 import "node:module";
 import { resolveApiPrefix, resolveApiStem } from "../descriptors.js";
 import { renderTemplate } from "../fs-io.js";
-import { toPascalCase } from "../naming.js";
+import { packageName, toPascalCase } from "../naming.js";
 import { createCheckoutCartApiContractFields, createCheckoutCartEndpointDefinitions, createCheckoutCartOperationContexts, createCheckoutCartSharedSchemas } from "./checkout-cart.js";
 import { verticalApiCreatePayloadSchemaExport, verticalApiExport, verticalApiGroupName, verticalApiMarkerSchemaExport, verticalApiName, verticalApiNotFoundErrorExport, verticalApiNotFoundSchemaExport, verticalApiReadinessSchemaExport, verticalApiSchemaExport } from "./names.js";
 function createSharedApiImports() {
@@ -14,7 +14,7 @@ function createSharedApiImports() {
 } from '@modern-js/plugin-bff/effect-client';
 `;
 }
-function createSharedApiContract(service) {
+function createSharedApiContract(service, shared = false) {
     const schemaExport = verticalApiSchemaExport(service);
     const markerSchemaExport = verticalApiMarkerSchemaExport(service);
     const readinessSchemaExport = verticalApiReadinessSchemaExport(service);
@@ -71,7 +71,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;
@@ -81,7 +81,7 @@ function createSharedApiContract(service) {
   readonly surface: string;
   readonly unitId: string;
   readonly version: string;
-}
+}`}
 
 export interface ${itemType} {
   readonly id: string;
@@ -89,7 +89,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';
@@ -99,7 +99,7 @@ export interface ${readinessType} {
   readonly marker: ${markerType};
   readonly status: 'ready';
   readonly versionSkew: 'none';
-}
+}`}
 
 export interface ${createPayloadType} {
   readonly title: string;
@@ -118,7 +118,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,
@@ -128,7 +128,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,
@@ -136,7 +136,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'),
@@ -146,7 +146,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,
@@ -158,7 +158,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;
@@ -170,9 +170,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}', {
@@ -184,11 +189,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},
@@ -209,7 +215,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 = {
@@ -220,8 +226,12 @@ ${createCheckoutCartApiContractFields(service)}  ownerId: '${service.id}',
 } as const;
 `;
 }
-function createSharedApi(service) {
+function createSharedApi(service, options) {
+    const imports = options ? `import { MicroVerticalBuildMarkerSchema, MicroVerticalReadinessSchema, createMicroVerticalOperationContext } from '${packageName(options.scope, 'shared-contracts')}/microvertical-api-baseline';
+import type { MicroVerticalBuildMarker, MicroVerticalReadiness, MicroVerticalOperationContext } from '${packageName(options.scope, 'shared-contracts')}/microvertical-api-baseline';
+` : '';
     return `${createSharedApiImports()}
-${createSharedApiContract(service)}`;
+${imports}
+${createSharedApiContract(service, void 0 !== options)}`;
 }
 export { createSharedApi };

package/dist/esm-node/ultramodern-workspace/mf-validation/inspect.js

@@ -12,7 +12,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 = parseObjectLiteral(value);
     if (!dts || dts.hasSpread) throw new Error(`Cannot statically extract Module Federation DTS settings from ${configPath}; use a literal dts object.`);
@@ -39,7 +43,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/esm-node/ultramodern-workspace/module-federation/reexport-module.js

@@ -46,22 +46,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/esm-node/ultramodern-workspace/package-json.js

@@ -172,7 +172,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: packageName(scope, id),
@@ -189,6 +189,17 @@ function createSharedPackage(scope, id, description) {
             '@effect/tsgo': 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 = {
+            ...ULTRAMODERN_PACKAGE_PINS.bffEffectDependencies,
+            '@modern-js/plugin-bff': packageSource ? modernPackageSpecifier('@modern-js/plugin-bff', packageSource) : WORKSPACE_PACKAGE_VERSION
+        };
+    }
     if ('shared-design-tokens' === id) packageJson.exports = {
         ...packageJson.exports,
         './tokens.css': './src/tokens.css'

package/dist/esm-node/ultramodern-workspace/policy.js

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

package/dist/esm-node/ultramodern-workspace/tsconfigs.js

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

package/dist/esm-node/ultramodern-workspace/workspace-script-plan.js

@@ -140,7 +140,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/esm-node/ultramodern-workspace/workspace-scripts.js

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

package/dist/esm-node/ultramodern-workspace/write-app.js

@@ -89,11 +89,17 @@ function writeAppRouteAndShellFiles({ targetDir, scope, resolvedApp, emitsUi, re
 function writeAppApiAndRemoteExposeFiles({ targetDir, scope, resolvedApp, emitsUi, writeAppFile }) {
     if (appHasApi(resolvedApp)) {
         const rpcProtocol = 'rpc' === resolveApiProtocol(resolvedApp);
-        rpcProtocol ? writeFile(targetDir, `${resolvedApp.directory}/shared/rpc.ts`, createRpcContractFile(resolvedApp)) : writeFile(targetDir, `${resolvedApp.directory}/shared/api.ts`, createSharedApi(resolvedApp));
-        writeFile(targetDir, `${resolvedApp.directory}/api/index.ts`, createApiServiceEntry(resolvedApp, rpcProtocol ? '../shared/rpc.ts' : '../shared/api.ts'));
+        rpcProtocol ? writeFile(targetDir, `${resolvedApp.directory}/shared/rpc.ts`, createRpcContractFile(resolvedApp)) : writeFile(targetDir, `${resolvedApp.directory}/shared/api.ts`, createSharedApi(resolvedApp, {
+            scope
+        }));
+        writeFile(targetDir, `${resolvedApp.directory}/api/index.ts`, createApiServiceEntry(resolvedApp, rpcProtocol ? '../shared/rpc.ts' : '../shared/api.ts', {
+            scope
+        }));
         writeFile(targetDir, `${resolvedApp.directory}/api/backend-federation.ts`, createBackendFederationContractFile(resolvedApp));
         writeFile(targetDir, `${resolvedApp.directory}/api/effect-api.ts`, createBackendEffectApiExpose(scope, resolvedApp));
-        rpcProtocol ? writeFile(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-rpc-client.ts`, createRpcClientFile(resolvedApp)) : writeFile(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-client.ts`, createApiClient(resolvedApp, '../../shared/api'));
+        rpcProtocol ? writeFile(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-rpc-client.ts`, createRpcClientFile(resolvedApp)) : writeFile(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-client.ts`, createApiClient(resolvedApp, '../../shared/api', {
+            scope
+        }));
     }
     if ('vertical' === resolvedApp.kind && emitsUi) {
         writeAppFile('src/federation-entry.tsx', createRemoteEntry(resolvedApp));

package/dist/esm-node/ultramodern-workspace/write-workspace.js

@@ -6,7 +6,7 @@ import { createSharedDesignTokensCss } from "./app-files.js";
 import { normalizeUltramodernBridgeConfig } from "./bridge-config.js";
 import { createDevelopmentOverlay, createOwnership, createTopology, createUltramodernConfig } from "./contracts.js";
 import { ULTRAMODERN_CONFIG_PATH, createShellHost, sharedPackages, shellApp } from "./descriptors.js";
-import { copyRootTemplate, formatGeneratedWorkspaceFiles, writeFile, writeFileReplacing, writeJson } from "./fs-io.js";
+import { copyRootTemplate, formatGeneratedWorkspaceFiles, readFileTemplate, writeFile, writeFileReplacing, writeJson } from "./fs-io.js";
 import { createFileSnapshot, createGenerationResult, diffFileSnapshots } from "./generation-result.js";
 import { assertUniqueTailwindPrefixes, toPackageScope } from "./naming.js";
 import { runCodeSmithOverlays } from "./overlays.js";
@@ -20,12 +20,14 @@ import { createZeropsYaml } from "./zerops.js";
 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 sharedPackages){
-        writeJson(targetDir, `${sharedPackage.directory}/package.json`, createSharedPackage(scope, sharedPackage.id, sharedPackage.description));
+        writeJson(targetDir, `${sharedPackage.directory}/package.json`, createSharedPackage(scope, sharedPackage.id, sharedPackage.description, packageSource));
         writeJson(targetDir, `${sharedPackage.directory}/tsconfig.json`, createSharedPackageTsConfig(sharedPackage.directory));
     }
     writeFile(targetDir, 'packages/shared-contracts/src/index.ts', createSharedContractsIndex());
+    writeFile(targetDir, 'packages/shared-contracts/src/microvertical-api-baseline.ts', readFileTemplate('packages/microvertical-api-baseline.ts'));
+    writeFile(targetDir, 'packages/shared-contracts/src/effect-bff-runtime.ts', readFileTemplate('packages/effect-bff-runtime.ts'));
     writeFile(targetDir, 'packages/shared-design-tokens/src/index.ts', `export const sharedDesignTokens = {
   color: {
     accent: '#2f8f68',
@@ -145,7 +147,7 @@ function generateUltramodernWorkspaceInPlace(options, logicalWorkspaceRoot = opt
     writeJson(options.targetDir, ULTRAMODERN_CONFIG_PATH, createCompactUltramodernConfig(scope, options.modernVersion, packageSource, createdApps, enableTailwind, bridge));
     writeApp(options.targetDir, scope, shellApp, packageSource, enableTailwind, initialVerticals, bridge);
     for (const remote of initialVerticals)writeApp(options.targetDir, scope, remote, packageSource, enableTailwind, initialVerticals, bridge);
-    writeSharedPackages(options.targetDir, scope);
+    writeSharedPackages(options.targetDir, scope, packageSource);
     writeGeneratedWorkspaceScripts(options.targetDir, scope, enableTailwind, initialVerticals, releaseCohort);
     const preliminaryAfterFiles = createFileSnapshot(options.targetDir);
     const preliminaryDiff = diffFileSnapshots(beforeFiles, preliminaryAfterFiles);

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/shared-api-infrastructure.d.ts

@@ -0,0 +1,4 @@
+import type { ResolvedPackageSource } from '../../../ultramodern-workspace/types.js';
+import { type MigrationIo } from './io.js';
+/** Add infrastructure only: existing contracts and business handlers stay owned by the consumer. */
+export declare function ensureSharedApiInfrastructure(io: MigrationIo, scope: string, packageSource: ResolvedPackageSource): void;

package/dist/types/ultramodern-workspace/api/client.d.ts

@@ -2,5 +2,7 @@ import type { WorkspaceApi, WorkspaceApp } from '../types.js';
 export declare function createApiClient(service: {
     id: string;
     api?: WorkspaceApi;
-}, contractImportPath: string): string;
+}, contractImportPath: string, options?: {
+    readonly scope: string;
+}): string;
 export declare function createShellApiClient(scope: string, remotes?: WorkspaceApp[]): string;

package/dist/types/ultramodern-workspace/api/service.d.ts

@@ -2,5 +2,7 @@ import type { WorkspaceApi, WorkspaceApp } from '../types.js';
 export declare function createApiServiceEntry(service: {
     id: string;
     api?: WorkspaceApi;
-}, contractImportPath: string): string;
+}, contractImportPath: string, options?: {
+    readonly scope: string;
+}): string;
 export declare function createBackendEffectApiExpose(scope: string, service: WorkspaceApp): string;

package/dist/types/ultramodern-workspace/api/shared.d.ts

@@ -2,4 +2,6 @@ import type { WorkspaceApi } from '../types.js';
 export declare function createSharedApi(service: {
     id: string;
     api?: WorkspaceApi;
+}, options?: {
+    readonly scope: string;
 }): string;

package/dist/types/ultramodern-workspace/package-json.d.ts

@@ -4,5 +4,5 @@ export declare function appDependencies(scope: string, packageSource: ResolvedPa
 export declare function createRootPackageJson(scope: string, packageSource: ResolvedPackageSource, remotes?: WorkspaceApp[], bridge?: UltramodernBridgeConfig, additionalShells?: WorkspaceApp[]): JsonValue;
 export { createAppMfTypesTsConfig, createAppTsConfig, createPackageTsConfig, createRootTsConfig, createSharedPackageTsConfig, createTsConfigBase, } from './tsconfigs.js';
 export declare function createAppPackage(scope: string, app: WorkspaceApp, packageSource: ResolvedPackageSource, enableTailwind: boolean, remotes?: WorkspaceApp[], bridge?: UltramodernBridgeConfig): JsonValue;
-export declare function createSharedPackage(scope: string, id: string, description: string): JsonValue;
+export declare function createSharedPackage(scope: string, id: string, description: string, packageSource?: ResolvedPackageSource): JsonValue;
 export declare function createSharedContractsIndex(): string;

package/dist/types/ultramodern-workspace/policy.d.ts

@@ -82,6 +82,7 @@ export declare const ULTRAMODERN_PACKAGE_PINS: {
     readonly rootDevDependencies: {
         readonly '@effect/tsgo': "0.41.0";
         readonly '@typescript/native': "npm:typescript@7.0.2";
+        readonly '@types/node': "^26.4.1";
         readonly 'cross-env': "10.1.0";
         readonly lefthook: "^2.1.10";
         readonly miniflare: "4.20260730.0";
@@ -134,6 +135,7 @@ export declare const ULTRAMODERN_WORKSPACE_POLICY: {
         readonly rootDevDependencies: {
             readonly '@effect/tsgo': "0.41.0";
             readonly '@typescript/native': "npm:typescript@7.0.2";
+            readonly '@types/node': "^26.4.1";
             readonly 'cross-env': "10.1.0";
             readonly lefthook: "^2.1.10";
             readonly miniflare: "4.20260730.0";

package/package.json

@@ -26,7 +26,7 @@
   "engines": {
     "node": ">=26.7.0"
   },
-  "version": "3.9.0-ultramodern.2",
+  "version": "3.9.0-ultramodern.3",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/esm-node/index.js",
   "bin": {
@@ -82,8 +82,8 @@
   ],
   "dependencies": {
     "@modern-js/codesmith": "2.6.9",
-    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.9.0-ultramodern.2",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.2",
+    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.9.0-ultramodern.3",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.3",
     "esbuild": "^0.28.2",
     "oxfmt": "0.66.0",
     "ultracite": "7.11.0"
@@ -110,6 +110,6 @@
     "type-check": "tsgo --noEmit -p tsconfig.json"
   },
   "ultramodern": {
-    "frameworkVersion": "3.9.0-ultramodern.2"
+    "frameworkVersion": "3.9.0-ultramodern.3"
   }
 }