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

package/template-workspace/.modernjs/release-cohort.json

@@ -43,202 +43,202 @@
     {
       "sourceName": "@modern-js/adapter-rstest",
       "targetName": "@bleedingdev/modern-js-adapter-rstest",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/app-tools",
       "targetName": "@bleedingdev/modern-js-app-tools",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/app-tools-extensions",
       "targetName": "@bleedingdev/modern-js-app-tools-extensions",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/bff-core",
       "targetName": "@bleedingdev/modern-js-bff-core",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/bff-effect",
       "targetName": "@bleedingdev/modern-js-bff-effect",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/bff-runtime",
       "targetName": "@bleedingdev/modern-js-bff-runtime",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/builder",
       "targetName": "@bleedingdev/modern-js-builder",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/code-tools",
       "targetName": "@bleedingdev/modern-js-code-tools",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/create-request",
       "targetName": "@bleedingdev/modern-js-create-request",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/i18n-runtime-extensions",
       "targetName": "@bleedingdev/modern-js-i18n-runtime-extensions",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/i18n-utils",
       "targetName": "@bleedingdev/modern-js-i18n-utils",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/image",
       "targetName": "@bleedingdev/modern-js-image",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/main-doc",
       "targetName": "@bleedingdev/modern-js-main-doc",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/plugin",
       "targetName": "@bleedingdev/modern-js-plugin",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/plugin-bff",
       "targetName": "@bleedingdev/modern-js-plugin-bff",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/plugin-bff-extensions",
       "targetName": "@bleedingdev/modern-js-plugin-bff-extensions",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/plugin-data-loader",
       "targetName": "@bleedingdev/modern-js-plugin-data-loader",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/plugin-i18n",
       "targetName": "@bleedingdev/modern-js-plugin-i18n",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/plugin-polyfill",
       "targetName": "@bleedingdev/modern-js-plugin-polyfill",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/plugin-ssg",
       "targetName": "@bleedingdev/modern-js-plugin-ssg",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/plugin-styled-components",
       "targetName": "@bleedingdev/modern-js-plugin-styled-components",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/plugin-tanstack",
       "targetName": "@bleedingdev/modern-js-plugin-tanstack",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/prod-server",
       "targetName": "@bleedingdev/modern-js-prod-server",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/render",
       "targetName": "@bleedingdev/modern-js-render",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/runtime",
       "targetName": "@bleedingdev/modern-js-runtime",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/runtime-extensions",
       "targetName": "@bleedingdev/modern-js-runtime-extensions",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/runtime-utils",
       "targetName": "@bleedingdev/modern-js-runtime-utils",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/sandpack-react",
       "targetName": "@bleedingdev/modern-js-sandpack-react",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/server",
       "targetName": "@bleedingdev/modern-js-server",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/server-core",
       "targetName": "@bleedingdev/modern-js-server-core",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/server-runtime",
       "targetName": "@bleedingdev/modern-js-server-runtime",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/server-runtime-extensions",
       "targetName": "@bleedingdev/modern-js-server-runtime-extensions",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/server-utils",
       "targetName": "@bleedingdev/modern-js-server-utils",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/tsconfig",
       "targetName": "@bleedingdev/modern-js-tsconfig",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/types",
       "targetName": "@bleedingdev/modern-js-types",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/ultramodern-create",
       "targetName": "@bleedingdev/modern-js-ultramodern-create",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/ultramodern-sandpack-profile",
       "targetName": "@bleedingdev/modern-js-ultramodern-sandpack-profile",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     },
     {
       "sourceName": "@modern-js/utils",
       "targetName": "@bleedingdev/modern-js-utils",
-      "version": "3.9.0-ultramodern.2"
+      "version": "3.9.0-ultramodern.3"
     }
   ],
   "release": {
     "tag": "latest",
-    "version": "3.9.0-ultramodern.2"
+    "version": "3.9.0-ultramodern.3"
   },
   "schema": "bleedingdev.ultramodern.release-cohort",
   "schemaVersion": 1,
   "source": {
-    "commit": "d2c75828230edf92775feca796c0960af754508f",
+    "commit": "57e02edeaf733de0d592237cd2374f5f58c27822",
     "repository": "BleedingDev/ultramodern.js"
   }
 }

package/templates/packages/effect-bff-runtime.ts

@@ -0,0 +1,50 @@
+/** Server-only assembly for the invariant tail of a strict Effect BFF runtime factory. */
+import {
+  defineEffectBff,
+  HttpApiBuilder,
+  Layer,
+} from '@modern-js/plugin-bff/effect-edge';
+import type {
+  EffectRuntimeRequirements,
+  HttpApi,
+  HttpApiGroup,
+} from '@modern-js/plugin-bff/effect-edge';
+
+export interface EffectBffRuntimeAssembly<
+  ApiId extends string,
+  Groups extends HttpApiGroup.Constraint,
+  HandlerRequirements extends EffectRuntimeRequirements,
+  TransportRequirements extends EffectRuntimeRequirements = never,
+> {
+  readonly api: HttpApi.HttpApi<ApiId, Groups>;
+  readonly handlers: Layer.Layer<
+    HttpApiGroup.ToService<ApiId, Groups>,
+    never,
+    HandlerRequirements
+  >;
+  readonly transport?: Layer.Layer<never, never, TransportRequirements>;
+}
+
+export const assembleEffectBffRuntime = <
+  ApiId extends string,
+  Groups extends HttpApiGroup.Constraint,
+  HandlerRequirements extends EffectRuntimeRequirements,
+  TransportRequirements extends EffectRuntimeRequirements = never,
+>({
+  api,
+  handlers,
+  transport,
+}: EffectBffRuntimeAssembly<
+  ApiId,
+  Groups,
+  HandlerRequirements,
+  TransportRequirements
+>) => {
+  const apiLayer = HttpApiBuilder.layer(api).pipe(Layer.provide(handlers));
+  const layer =
+    transport === undefined
+      ? apiLayer
+      : apiLayer.pipe(Layer.merge(transport));
+
+  return defineEffectBff({ api, layer });
+};

package/templates/packages/microvertical-api-baseline.ts

@@ -0,0 +1,102 @@
+import { Schema } from 'effect';
+
+const MicroVerticalAppIdSchema = Schema.String.pipe(
+  Schema.brand('MicroVerticalAppId'),
+  Schema.decodeTo(Schema.String),
+);
+const MicroVerticalUnitIdSchema = Schema.String.pipe(
+  Schema.brand('MicroVerticalUnitId'),
+  Schema.decodeTo(Schema.String),
+);
+const MicroVerticalOperationIdSchema = Schema.String.pipe(
+  Schema.brand('MicroVerticalOperationId'),
+  Schema.decodeTo(Schema.String),
+);
+const MicroVerticalTraceIdSchema = Schema.String.pipe(
+  Schema.brand('MicroVerticalTraceId'),
+  Schema.decodeTo(Schema.String),
+);
+
+export const MicroVerticalBuildMarkerSchema = Schema.Struct({
+  appId: MicroVerticalAppIdSchema,
+  build: Schema.String,
+  buildMarker: Schema.String,
+  deployProfile: Schema.String,
+  packageName: Schema.String,
+  sourceRevision: Schema.String,
+  surface: Schema.String,
+  unitId: MicroVerticalUnitIdSchema,
+  version: Schema.String,
+});
+export type MicroVerticalBuildMarker =
+  typeof MicroVerticalBuildMarkerSchema.Type;
+
+export const MicroVerticalReadinessSchema = Schema.Struct({
+  checks: Schema.Struct({
+    api: Schema.Literal('ready'),
+    moduleFederation: Schema.Literal('ready'),
+    ssr: Schema.Literal('ready'),
+    translations: Schema.Literal('ready'),
+  }),
+  marker: MicroVerticalBuildMarkerSchema,
+  status: Schema.Literal('ready'),
+  versionSkew: Schema.Literal('none'),
+});
+export type MicroVerticalReadiness = typeof MicroVerticalReadinessSchema.Type;
+
+export const MicroVerticalOperationSourceSchema = Schema.Literals([
+  'client',
+  'server',
+  'generated-client',
+  'effect-adapter',
+  'data-platform',
+  'unknown',
+]);
+export type MicroVerticalOperationSource =
+  typeof MicroVerticalOperationSourceSchema.Type;
+
+export const MicroVerticalOperationContextSchema = Schema.Struct({
+  method: Schema.String,
+  operationId: MicroVerticalOperationIdSchema,
+  routePath: Schema.String,
+  source: MicroVerticalOperationSourceSchema,
+  traceId: Schema.optionalKey(MicroVerticalTraceIdSchema),
+});
+export type MicroVerticalOperationContext =
+  typeof MicroVerticalOperationContextSchema.Type;
+
+export const createMicroVerticalOperationContext = <
+  const Method extends string,
+  const OperationId extends string,
+  const RoutePath extends string,
+>(input: {
+  readonly method: Method;
+  readonly operationId: OperationId;
+  readonly routePath: RoutePath;
+  // eslint-disable-next-line effect-native/no-threaded-correlation-parameter -- This pure browser-safe contract deliberately carries optional trace metadata; it does not perform ambient request work.
+  readonly traceId?: string;
+}): Readonly<typeof input & { source: 'generated-client' }> => {
+  const context = {
+    method: input.method,
+    operationId: input.operationId,
+    routePath: input.routePath,
+    source: 'generated-client' as const,
+  };
+  return input.traceId === undefined
+    ? context
+    : { ...context, traceId: input.traceId };
+};
+
+export const microVerticalOperationAttributes = (
+  operationContext: MicroVerticalOperationContext,
+) => {
+  const attributes = {
+    'modernjs.operation.id': operationContext.operationId,
+    'modernjs.operation.method': operationContext.method,
+    'modernjs.operation.route': operationContext.routePath,
+    'modernjs.operation.source': operationContext.source,
+  };
+  return operationContext.traceId === undefined
+    ? attributes
+    : { ...attributes, 'modernjs.trace.id': operationContext.traceId };
+};

package/templates/workspace-scripts/check-ultramodern-api-boundaries.mts

@@ -1,4 +1,9 @@
 #!/usr/bin/env node
+import {
+  createEffectApiImportResolver,
+  strictEffectRuntimeTopologyViolation,
+} from '@modern-js/code-tools/strict-effect-runtime';
+import { microVerticalApiBaselineViolation } from './microvertical-api-baseline-boundary.mts';
 import fs from 'node:fs';
 import path from 'node:path';
 
@@ -56,6 +61,14 @@ function listFiles(startDirectory) {
 
       const absoluteEntry = path.join(directory, entry.name);
       if (entry.isDirectory()) {
+        // Only the registered app's build output is generated. A directory
+        // named dist-cloudflare inside authored source is still source.
+        if (
+          entry.name === 'dist-cloudflare' &&
+          configuredApp(relative(directory)) !== undefined
+        ) {
+          continue;
+        }
         visit(absoluteEntry);
         continue;
       }
@@ -585,34 +598,42 @@ function assertApiSurface(appPath, app) {
   assertNoPath(rpcContract, `${appPath} REST unit must not emit ${rpcContract}.`);
   assertNoPath(rpcClient, `${appPath} REST unit must not emit the RPC API client.`);
 
-  assertModuleShape(apiEntry, {
-    imports: [
-      [
-        '@modern-js/plugin-bff/effect-edge',
-        ['defineEffectBff', 'Effect', 'HttpApiBuilder', 'Layer'],
-      ],
-      ['../shared/api.ts', []],
-    ],
-    calls: [
-      [
-        'defineEffectBff',
-        'must create the strict Effect runtime through defineEffectBff(...).',
-      ],
-      [
-        'HttpApiBuilder.group',
-        'must implement handlers through HttpApiBuilder.group(...).',
-      ],
-      [
-        'HttpApiBuilder.layer',
-        'must assemble the HttpApi runtime through HttpApiBuilder.layer(...).',
-      ],
-      [
-        'Layer.provide',
-        'must compose the handler group through Effect Layer.provide(...).',
-      ],
-    ],
-    defaultExport: 'apiRuntime',
-  });
+  if (exists(apiEntry)) {
+    const runtimeViolation = strictEffectRuntimeTopologyViolation(
+      readText(apiEntry),
+      createEffectApiImportResolver(path.resolve(workspaceRoot, apiEntry)),
+    );
+    assert(runtimeViolation === undefined, `${apiEntry}: ${runtimeViolation}`);
+  }
+  const sharedPackagePath = 'packages/shared-contracts/package.json';
+  assert(exists(sharedPackagePath), `${sharedPackagePath} is required.`);
+  if (exists(sharedApi) && exists(sharedPackagePath)) {
+    const sharedPackage = JSON.parse(readText(sharedPackagePath));
+    const apiPrefix = app?.api?.prefix ?? `/${stem}-api`;
+    const basePath = `${apiPrefix}/${stem}`;
+    const baselineViolation = microVerticalApiBaselineViolation(
+      stem,
+      path.resolve(workspaceRoot, sharedApi),
+      {
+        additionalPaths:
+          stem === 'checkout' ? { checkoutCartPath: `${basePath}/cart` } : {},
+        apiPrefix,
+        basePath,
+        effectClientPackage: '@modern-js/plugin-bff/effect-client',
+        ownerId: app?.id ?? path.posix.basename(appPath),
+        readinessPath: `${basePath}/readiness`,
+        sharedContractsPackage: sharedPackage.name,
+        sharedContractsDirectory: path.resolve(
+          workspaceRoot,
+          'packages/shared-contracts',
+        ),
+      },
+    );
+    assert(
+      baselineViolation === undefined,
+      `${sharedApi}: ${baselineViolation}`,
+    );
+  }
   assertBackendEffectSurface(appPath);
 
   assertModuleShape(sharedApi, {