@bleedingdev/modern-js-plugin-bff-extensions 3.9.0-ultramodern.5 → 3.9.0-ultramodern.6

package/dist/esm-node/effect-source-loader/operation-contracts.mjs

@@ -0,0 +1,46 @@
+import "node:module";
+import { collectEffectEndpoints, toOperationContractSources } from "@modern-js/bff-effect/effect";
+import { buildOperationContractMap, deriveOperationVersion } from "@modern-js/server-runtime-extensions/bff-policy/node";
+import { fs, upath } from "@modern-js/utils";
+import { getHttpApiRuntime, loadEffectApi } from "./http-api-runtime.mjs";
+function getPackageInfo(resourcePath, appDir, onDependency) {
+    for (const startDir of [
+        upath.dirname(resourcePath),
+        appDir
+    ]){
+        let current = upath.resolve(startDir);
+        for(let depth = 0; depth < 32; depth += 1){
+            const packageJsonPath = upath.join(current, 'package.json');
+            if (fs.existsSync(packageJsonPath)) {
+                onDependency?.(packageJsonPath);
+                try {
+                    const packageJson = fs.readJSONSync(packageJsonPath);
+                    return {
+                        name: packageJson.name,
+                        version: packageJson.version
+                    };
+                } catch  {
+                    return {};
+                }
+            }
+            const parent = upath.dirname(current);
+            if (parent === current) break;
+            current = parent;
+        }
+    }
+    return {};
+}
+async function resolveEffectOperationContracts(options) {
+    const api = await loadEffectApi(options);
+    if (null === api) return null;
+    const runtime = await getHttpApiRuntime();
+    const endpoints = collectEffectEndpoints(runtime.reflect, api, options.prefix);
+    const packageInfo = getPackageInfo(options.resourcePath, options.appDir, options.onDependency);
+    const requestId = options.requestId?.trim() || packageInfo.name || 'default';
+    return buildOperationContractMap({
+        handlers: toOperationContractSources(endpoints),
+        requestId,
+        operationVersion: deriveOperationVersion(packageInfo.version)
+    });
+}
+export { resolveEffectOperationContracts };

package/dist/esm-node/effect-source-loader/rspack-loader.mjs

@@ -1,7 +1,7 @@
 import __rslib_shim_module__ from "node:module";
 const require = /*#__PURE__*/ __rslib_shim_module__.createRequire(/*#__PURE__*/ (()=>import.meta.url)());
 import { realpathSync } from "node:fs";
-import { bundleEffectWorkerRuntimeSource, generateEffectClientCode, generateEffectWorkerRuntimeWrapper, resolveEffectEntryFile } from "./index.mjs";
+import { bundleEffectWorkerRuntimeSource, generateEffectWorkerRuntimeWrapper, resolveEffectEntryFile } from "./index.mjs";
 async function loader(source) {
     this.cacheable();
     delete require.cache[this.resourcePath];
@@ -29,23 +29,7 @@ async function loader(source) {
             });
             callback(void 0, await bundleEffectWorkerRuntimeSource(transformed.code, this.resourcePath, this));
         } else if (query.has('modern-bff-runtime')) callback(void 0, await generateEffectWorkerRuntimeWrapper(this, options, this.resourcePath));
-        else {
-            const code = await generateEffectClientCode({
-                appDir: options.appDir,
-                apiDir: options.apiDir,
-                resourcePath: this.resourcePath,
-                prefix: options.prefix,
-                port: Number(options.port),
-                target: options.target,
-                requestId: options.requestId,
-                requestCreator: options.requestCreator,
-                httpMethodDecider: options.httpMethodDecider,
-                dataPlatformBatch: options.effectDataPlatformBatch,
-                onDependency: (dependency)=>this.addDependency(dependency)
-            });
-            if (null === code) throw new Error(`Failed to generate Effect client for ${this.resourcePath}`);
-            callback(void 0, code);
-        }
+        else throw new Error('Effect BFF entries are server-only. Import the shared HttpApi contract and use HttpApiClient.make (or makeEffectHttpApiClient) for a fully inferred client.');
     } catch (error) {
         callback(error instanceof Error ? error : new Error(String(error)));
     }

package/dist/esm-node/effect-source-loader/worker-runtime-wrapper.mjs

@@ -1,29 +1,17 @@
 import "node:module";
+import { resolveEffectOperationContracts } from "./operation-contracts.mjs";
 async function generateEffectWorkerRuntimeWrapper(loader, options, resourcePath) {
-    const { generateEffectClient } = await import("../client-generator/generator.mjs");
-    const artifacts = await generateEffectClient({
+    const operationContracts = await resolveEffectOperationContracts({
         appDir: options.appDir,
-        apiDir: options.apiDir,
         resourcePath,
         prefix: options.prefix,
-        port: Number(options.port),
-        target: 'bundle',
         requestId: options.requestId,
-        requestCreator: options.requestCreator,
-        httpMethodDecider: options.httpMethodDecider,
-        dataPlatformBatch: options.effectDataPlatformBatch,
         onDependency: (dependency)=>loader.addDependency(dependency)
     });
     const sourceRequest = `${resourcePath}?modern-bff-runtime-source`;
-    const operationContracts = artifacts?.operationContracts ?? {};
     return `import * as effectBffModule from ${JSON.stringify(sourceRequest)};
 import { createEffectBffEdgeDispatcherFactory } from '@modern-js/bff-effect/effect-edge';
-export const __modern_create_effect_bff_dispatcher = createEffectBffEdgeDispatcherFactory(effectBffModule, ${JSON.stringify(operationContracts)});
+export const __modern_create_effect_bff_dispatcher = createEffectBffEdgeDispatcherFactory(effectBffModule, ${JSON.stringify(operationContracts ?? {})});
 `;
 }
-async function generateEffectClientCode(options) {
-    const { generateEffectClient } = await import("../client-generator/generator.mjs");
-    const artifacts = await generateEffectClient(options);
-    return null === artifacts ? null : artifacts.code;
-}
-export { generateEffectClientCode, generateEffectWorkerRuntimeWrapper };
+export { generateEffectWorkerRuntimeWrapper };

package/dist/types/backend-federation/edge-runtime.d.ts

@@ -33,14 +33,9 @@ type BackendFederationEdgeRuntimeBaseOptions = {
 export type BackendFederationEdgeRuntimeOptions = BackendFederationEdgeRuntimeBaseOptions & {
     expected: BackendFederationExpectedIdentity;
 };
-type EdgeRuntimeLoadOptions = BackendFederationEdgeRuntimeBaseOptions & {
-    allowMissingIdentityMetadata?: boolean;
-    expected?: BackendFederationExpectedIdentity;
-};
 export type BackendFederationEdgeRuntime = {
     loadRemote<T>(request: string): Promise<T>;
 };
 export declare function createBackendFederationLoadEntryPlugin(options: BackendFederationEdgeLoadEntryPluginOptions): BackendFederationEdgeLoadEntryPlugin;
 export declare function createBackendFederationRuntime(options: BackendFederationEdgeRuntimeOptions): BackendFederationEdgeRuntime;
-export declare function createBackendFederationRuntimeForLoad(options: EdgeRuntimeLoadOptions): BackendFederationEdgeRuntime;
 export {};

package/dist/types/backend-federation/edge.d.ts

@@ -24,5 +24,3 @@ export type EdgeBackendFederationIdentityLoadOptions = Omit<UniversalBackendFede
 };
 export type BackendFederationIdentityLoadOptions = EdgeBackendFederationIdentityLoadOptions;
 export declare function loadBackendFederatedEffectApi(options: EdgeBackendFederationIdentityLoadOptions): Promise<BackendFederatedEffectApiModule>;
-/** @deprecated Pass `expected` delivery-unit identity. */
-export declare function loadBackendFederatedEffectApi(options: EdgeBackendFederationLoadOptions): Promise<BackendFederatedEffectApiModule>;

package/dist/types/backend-federation/identity.d.ts

@@ -15,16 +15,7 @@ export type BackendFederationIdentityIssue = {
  * Shared expected-identity validation for loaded backend federation modules.
  * Compares the expose's `backendFederationContract.compatibility` identity
  * (`unitId`, `build`) against the consumer's expected delivery-unit identity.
- * Missing identity metadata is an error: with an expectation present there is
- * no legacy escape hatch.
+ * Missing identity metadata is an error.
  */
-export declare function validateExpectedBackendFederationIdentity(loaded: unknown, expected: BackendFederationExpectedIdentity, options?: {
-    /**
-     * Tolerate exposes that declare no identity metadata (legacy modules).
-     * Mismatching declared values still fail. Used by the manifest adapter,
-     * whose manifest-side identity is already validated against `expected`;
-     * the raw identity-aware loader is strict.
-     */
-    allowMissingIdentityMetadata?: boolean;
-}): BackendFederationIdentityIssue[];
+export declare function validateExpectedBackendFederationIdentity(loaded: unknown, expected: BackendFederationExpectedIdentity): BackendFederationIdentityIssue[];
 export declare function formatBackendFederationIdentityIssues(issues: BackendFederationIdentityIssue[]): string;

package/dist/types/backend-federation/load.d.ts

@@ -1,13 +1,7 @@
-import type { BackendFederatedEffectApiModule, BackendFederationIdentityLoadOptions, BackendFederationLoadOptions } from './types.js';
+import type { BackendFederatedEffectApiModule, BackendFederationIdentityLoadOptions } from './types.js';
 /**
  * Load a federated Effect API with mandatory delivery-unit identity
  * validation (MV-G23): the loaded expose's compatibility metadata must match
  * `expected.unitId` + `expected.buildMarker`.
  */
 export declare function loadBackendFederatedEffectApi(options: BackendFederationIdentityLoadOptions): Promise<BackendFederatedEffectApiModule>;
-/**
- * @deprecated Pass `expected` (delivery-unit `unitId` + `buildMarker`).
- * Loads without an expected identity cannot be validated against a resolved
- * delivery-unit record and emit a runtime warning.
- */
-export declare function loadBackendFederatedEffectApi(options: BackendFederationLoadOptions): Promise<BackendFederatedEffectApiModule>;

package/dist/types/backend-federation/node.d.ts

@@ -1,4 +1,2 @@
-import type { BackendFederatedEffectApiModule, BackendFederationIdentityLoadOptions, BackendFederationLoadOptions } from './types.js';
+import type { BackendFederatedEffectApiModule, BackendFederationIdentityLoadOptions } from './types.js';
 export declare function loadBackendFederatedEffectApi(options: BackendFederationIdentityLoadOptions): Promise<BackendFederatedEffectApiModule>;
-/** @deprecated Pass `expected` delivery-unit identity. */
-export declare function loadBackendFederatedEffectApi(options: BackendFederationLoadOptions): Promise<BackendFederatedEffectApiModule>;

package/dist/types/backend-federation/types.d.ts

@@ -62,12 +62,6 @@ export type BackendFederationLoadOptions = BackendFederationRuntimeOptions & {
  */
 export type BackendFederationIdentityLoadOptions = BackendFederationLoadOptions & {
     expected: BackendFederationExpectedIdentity;
-    /**
-     * Tolerate legacy exposes without identity metadata (mismatching declared
-     * values still fail). Prefer leaving this unset: identity-less exposes
-     * cannot be validated against a resolved delivery-unit record.
-     */
-    allowMissingIdentityMetadata?: boolean;
 };
 export type BackendFederationLoadEntryPlugin = ModuleFederationRuntimePlugin & {
     loadEntry?: (args: {

package/dist/types/backend-federation/validate-loaded.d.ts

@@ -1,8 +1,7 @@
 import type { BackendFederationExpectedIdentity } from './identity.js';
 import type { BackendFederatedEffectApiModule } from './types.js';
 export declare function validateLoadedBackendFederatedEffectApi(loaded: unknown, options: {
-    allowMissingIdentityMetadata?: boolean;
-    expected?: BackendFederationExpectedIdentity;
+    expected: BackendFederationExpectedIdentity;
     remoteName: string;
     remoteRequest: string;
 }): BackendFederatedEffectApiModule;

package/dist/types/backend-federation-manifest/metadata.d.ts

@@ -6,12 +6,6 @@ export declare function resolveRemoteEntryFromMetadata(manifest: BackendFederati
 export declare function backendFederationMetadata(manifest: BackendFederationManifest): Record<string, unknown> | undefined;
 export declare function versionBoundaryMetadata(manifest: BackendFederationManifest): Record<string, unknown> | undefined;
 export declare function deliveryUnitMetadata(record: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
-/**
- * Resolves the delivery-unit identity root for a manifest (ADR-0019 §3):
- * prefers `versionBoundary.deliveryUnit`, falls back to the top-level
- * `backendFederation.deliveryUnit` record. Both are additive/optional so
- * legacy manifests without delivery-unit metadata continue to validate.
- */
 export declare function manifestDeliveryUnit(backendFederation: Record<string, unknown> | undefined, boundary: Record<string, unknown> | undefined): {
     boundary: Record<string, unknown> | undefined;
     top: Record<string, unknown> | undefined;

package/dist/types/effect-source-loader/index.d.ts

@@ -1,4 +1,6 @@
-export { resolveEffectEntryFile } from '../client-generator/paths.js';
+export { bundleBuiltEffectEntryForNode, resolveEffectEntryPaths, } from './built-entry.js';
 export { bundleEffectEntryForNode } from './loader.js';
+export { resolveEffectOperationContracts } from './operation-contracts.js';
+export { resolveEffectEntryFile } from './paths.js';
 export { bundleEffectWorkerRuntimeSource } from './worker-runtime-source.js';
-export { generateEffectClientCode, generateEffectWorkerRuntimeWrapper, } from './worker-runtime-wrapper.js';
+export { generateEffectWorkerRuntimeWrapper } from './worker-runtime-wrapper.js';

package/dist/types/effect-source-loader/operation-contracts.d.ts

@@ -0,0 +1,8 @@
+/** Derives server policy metadata without emitting or typing a client. */
+export declare function resolveEffectOperationContracts(options: {
+    appDir: string;
+    resourcePath: string;
+    prefix: string;
+    requestId?: string;
+    onDependency?: (dependency: string) => void;
+}): Promise<import("@modern-js/server-runtime-extensions/bff-policy/node").OperationContractMap | null>;

package/dist/types/effect-source-loader/rspack-loader.d.ts

@@ -1,23 +1,9 @@
-import type { HttpMethodDecider } from '@modern-js/types';
 import type { Rspack } from '@rsbuild/core';
 export interface EffectBffLoaderOptions {
     prefix: string;
     appDir: string;
     apiDir: string;
     effectEntry: string;
-    port: number;
-    target: string;
-    requestCreator?: string;
     requestId?: string;
-    httpMethodDecider?: HttpMethodDecider;
-    effectDataPlatformBatch?: {
-        enabled?: boolean;
-        endpoint?: string;
-        flushIntervalMs?: number;
-        maxBatchSize?: number;
-        maxBatchBytes?: number;
-        requestTimeoutMs?: number;
-        allowedMethods?: string[];
-    };
 }
 export default function loader(this: Rspack.LoaderContext<EffectBffLoaderOptions>, source: string): Promise<void>;

package/dist/types/effect-source-loader/worker-runtime-wrapper.d.ts

@@ -1,25 +1,7 @@
-import type { HttpMethodDecider } from '@modern-js/types';
-import type { EffectClientCodegenOptions } from '../client-generator/types.js';
-type EffectWorkerRuntimeGenerationOptions = {
-    apiDir: string;
+export declare function generateEffectWorkerRuntimeWrapper(loader: {
+    addDependency: (dependency: string) => void;
+}, options: {
     appDir: string;
-    effectDataPlatformBatch?: {
-        allowedMethods?: string[];
-        enabled?: boolean;
-        endpoint?: string;
-        flushIntervalMs?: number;
-        maxBatchBytes?: number;
-        maxBatchSize?: number;
-        requestTimeoutMs?: number;
-    };
-    httpMethodDecider?: HttpMethodDecider;
-    port: number;
     prefix: string;
-    requestCreator?: string;
     requestId?: string;
-};
-export declare function generateEffectWorkerRuntimeWrapper(loader: {
-    addDependency: (dependency: string) => void;
-}, options: EffectWorkerRuntimeGenerationOptions, resourcePath: string): Promise<string>;
-export declare function generateEffectClientCode(options: EffectClientCodegenOptions): Promise<string | null>;
-export {};
+}, resourcePath: string): Promise<string>;

package/package.json

@@ -18,7 +18,7 @@
     "modern.js",
     "ultramodern.js"
   ],
-  "version": "3.9.0-ultramodern.5",
+  "version": "3.9.0-ultramodern.6",
   "files": [
     "dist",
     "src"
@@ -66,14 +66,6 @@
       },
       "default": "./dist/cjs/effect-source-loader/index.js"
     },
-    "./client-generator": {
-      "types": "./dist/types/client-generator/index.d.ts",
-      "node": {
-        "import": "./dist/esm-node/client-generator/index.mjs",
-        "require": "./dist/cjs/client-generator/index.js"
-      },
-      "default": "./dist/cjs/client-generator/index.js"
-    },
     "./backend-federation": {
       "types": "./dist/types/backend-federation/index.d.ts",
       "node": {
@@ -163,10 +155,6 @@
         "./dist/types/effect-source-loader/index.d.ts",
         "./src/effect-source-loader/index.ts"
       ],
-      "client-generator": [
-        "./dist/types/client-generator/index.d.ts",
-        "./src/client-generator/index.ts"
-      ],
       "backend-federation": [
         "./dist/types/backend-federation/index.d.ts",
         "./src/backend-federation/index.ts"
@@ -205,14 +193,14 @@
     "node": ">=26.7.0"
   },
   "dependencies": {
-    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.0-ultramodern.5",
-    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.9.0-ultramodern.5",
-    "@modern-js/bff-effect": "npm:@bleedingdev/modern-js-bff-effect@3.9.0-ultramodern.5",
-    "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.0-ultramodern.5",
-    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.0-ultramodern.5",
-    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.0-ultramodern.5",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.5",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.5",
+    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.0-ultramodern.6",
+    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.9.0-ultramodern.6",
+    "@modern-js/bff-effect": "npm:@bleedingdev/modern-js-bff-effect@3.9.0-ultramodern.6",
+    "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.0-ultramodern.6",
+    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.0-ultramodern.6",
+    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.0-ultramodern.6",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.6",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.6",
     "@module-federation/runtime": "2.9.0",
     "@swc/core": "1.16.2",
     "esbuild": "^0.28.2"
@@ -231,7 +219,7 @@
   },
   "devDependencies": {
     "@effect/opentelemetry": "4.0.0-rc.112",
-    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.0-ultramodern.5",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.0-ultramodern.6",
     "@rsbuild/core": "2.2.3",
     "@rslib/core": "1.0.0",
     "@scripts/rstest-config": "2.66.0",

package/src/backend-federation/edge-runtime.ts

@@ -50,8 +50,7 @@ export type BackendFederationEdgeRuntimeOptions =
   };
 
 type EdgeRuntimeLoadOptions = BackendFederationEdgeRuntimeBaseOptions & {
-  allowMissingIdentityMetadata?: boolean;
-  expected?: BackendFederationExpectedIdentity;
+  expected: BackendFederationExpectedIdentity;
 };
 
 function parseRemoteRequest(request: string) {
@@ -113,9 +112,8 @@ async function resolveEdgeEntry(
 
 class EdgeBackendFederationRuntime {
   readonly #entries = new Map<string, Promise<BackendFederationEntryExports>>();
-  readonly #expected: BackendFederationExpectedIdentity | undefined;
+  readonly #expected: BackendFederationExpectedIdentity;
   readonly #hostName: string;
-  readonly #allowMissingIdentityMetadata: boolean;
   readonly #modules = new Map<string, Promise<unknown>>();
   readonly #plugins: readonly BackendFederationEdgeLoadEntryPlugin[];
   readonly #remotes: BackendFederationEdgeRemote[];
@@ -126,8 +124,6 @@ class EdgeBackendFederationRuntime {
         '[BFF][Effect] Edge backend federation does not execute entry evaluators. Register a static or service-binding entry provider.',
       );
     }
-    this.#allowMissingIdentityMetadata =
-      options.allowMissingIdentityMetadata === true;
     this.#expected = options.expected;
     this.#hostName = options.hostName;
     this.#plugins = options.plugins ?? [];
@@ -182,7 +178,6 @@ class EdgeBackendFederationRuntime {
       }
       const loaded = await factory();
       return validateLoadedBackendFederatedEffectApi(loaded, {
-        allowMissingIdentityMetadata: this.#allowMissingIdentityMetadata,
         expected: this.#expected,
         remoteName,
         remoteRequest: request,
@@ -250,9 +245,3 @@ export function createBackendFederationRuntime(
   }
   return new EdgeBackendFederationRuntime(options);
 }
-
-export function createBackendFederationRuntimeForLoad(
-  options: EdgeRuntimeLoadOptions,
-): BackendFederationEdgeRuntime {
-  return new EdgeBackendFederationRuntime(options);
-}

package/src/backend-federation/edge.ts

@@ -9,10 +9,8 @@ import {
   type BackendFederationEdgeLoadEntryPluginOptions,
   type BackendFederationEdgeRemote,
   type BackendFederationEdgeRuntimeOptions,
-  createBackendFederationRuntimeForLoad,
+  createBackendFederationRuntime,
 } from './edge-runtime';
-import type { BackendFederationExpectedIdentity } from './identity';
-import { LEGACY_LOAD_WARNING } from './legacy-warning';
 import type {
   BackendFederatedEffectApiModule,
   BackendFederationLoadOptions,
@@ -79,16 +77,6 @@ export type BackendFederationIdentityLoadOptions =
 
 export function loadBackendFederatedEffectApi(
   options: EdgeBackendFederationIdentityLoadOptions,
-): Promise<BackendFederatedEffectApiModule>;
-/** @deprecated Pass `expected` delivery-unit identity. */
-export function loadBackendFederatedEffectApi(
-  options: EdgeBackendFederationLoadOptions,
-): Promise<BackendFederatedEffectApiModule>;
-export function loadBackendFederatedEffectApi(
-  options: EdgeBackendFederationLoadOptions & {
-    expected?: BackendFederationExpectedIdentity;
-    allowMissingIdentityMetadata?: boolean;
-  },
 ): Promise<BackendFederatedEffectApiModule> {
   if (
     (options as BackendFederationLoadOptions).runtime !== undefined ||
@@ -108,8 +96,12 @@ export function loadBackendFederatedEffectApi(
     );
   }
 
-  if (options.expected === undefined) {
-    console.warn(LEGACY_LOAD_WARNING);
+  if (!options.expected?.unitId || !options.expected.buildMarker) {
+    return Promise.reject(
+      new Error(
+        '[BFF][Effect] Backend federation requires expected.unitId and expected.buildMarker.',
+      ),
+    );
   }
 
   const expose =
@@ -120,7 +112,7 @@ export function loadBackendFederatedEffectApi(
 
   let runtime;
   try {
-    runtime = createBackendFederationRuntimeForLoad(options);
+    runtime = createBackendFederationRuntime(options);
   } catch (error) {
     return Promise.reject(error);
   }

package/src/backend-federation/identity.ts

@@ -21,23 +21,12 @@ export type BackendFederationIdentityIssue = {
  * Shared expected-identity validation for loaded backend federation modules.
  * Compares the expose's `backendFederationContract.compatibility` identity
  * (`unitId`, `build`) against the consumer's expected delivery-unit identity.
- * Missing identity metadata is an error: with an expectation present there is
- * no legacy escape hatch.
+ * Missing identity metadata is an error.
  */
 export function validateExpectedBackendFederationIdentity(
   loaded: unknown,
   expected: BackendFederationExpectedIdentity,
-  options: {
-    /**
-     * Tolerate exposes that declare no identity metadata (legacy modules).
-     * Mismatching declared values still fail. Used by the manifest adapter,
-     * whose manifest-side identity is already validated against `expected`;
-     * the raw identity-aware loader is strict.
-     */
-    allowMissingIdentityMetadata?: boolean;
-  } = {},
 ): BackendFederationIdentityIssue[] {
-  const allowMissing = options.allowMissingIdentityMetadata === true;
   const issues: BackendFederationIdentityIssue[] = [];
   const contract = isRecord(loaded)
     ? loaded.backendFederationContract
@@ -45,9 +34,6 @@ export function validateExpectedBackendFederationIdentity(
   const compatibility = isRecord(contract) ? contract.compatibility : undefined;
 
   if (!isRecord(compatibility)) {
-    if (allowMissing) {
-      return [];
-    }
     return [
       {
         path: 'backendFederationContract.compatibility',
@@ -59,12 +45,10 @@ export function validateExpectedBackendFederationIdentity(
 
   const unitId = compatibility.unitId;
   if (typeof unitId !== 'string' || unitId.length === 0) {
-    if (!allowMissing) {
-      issues.push({
-        path: 'backendFederationContract.compatibility.unitId',
-        message: `missing delivery-unit id; expected ${expected.unitId}`,
-      });
-    }
+    issues.push({
+      path: 'backendFederationContract.compatibility.unitId',
+      message: `missing delivery-unit id; expected ${expected.unitId}`,
+    });
   } else if (unitId !== expected.unitId) {
     issues.push({
       path: 'backendFederationContract.compatibility.unitId',
@@ -74,12 +58,10 @@ export function validateExpectedBackendFederationIdentity(
 
   const build = compatibility.build;
   if (typeof build !== 'string' || build.length === 0) {
-    if (!allowMissing) {
-      issues.push({
-        path: 'backendFederationContract.compatibility.build',
-        message: `missing build marker; expected ${expected.buildMarker}`,
-      });
-    }
+    issues.push({
+      path: 'backendFederationContract.compatibility.build',
+      message: `missing build marker; expected ${expected.buildMarker}`,
+    });
   } else if (build !== expected.buildMarker) {
     issues.push({
       path: 'backendFederationContract.compatibility.build',

package/src/backend-federation/load.ts

@@ -1,9 +1,5 @@
 import { BACKEND_FEDERATION_EFFECT_EXPOSE } from '@modern-js/backend-federation-contracts';
-import * as Effect from 'effect/Effect';
-import * as Logger from 'effect/Logger';
 
-import { type BackendFederationExpectedIdentity } from './identity';
-import { LEGACY_LOAD_WARNING } from './legacy-warning';
 import { collectRemotes } from './remotes';
 import { createBackendFederationRuntime } from './runtime';
 import type {
@@ -14,18 +10,6 @@ import type {
 import { normalizeExpose } from './utils';
 import { validateLoadedBackendFederatedEffectApi } from './validate-loaded';
 
-const legacyWarningLogger = Logger.withLeveledConsole(Logger.formatLogFmt);
-
-function warnLegacyLoad() {
-  Effect.runSync(
-    Effect.provideService(
-      Effect.logWarning(LEGACY_LOAD_WARNING),
-      Logger.CurrentLoggers,
-      new Set([legacyWarningLogger]),
-    ),
-  );
-}
-
 /**
  * Load a federated Effect API with mandatory delivery-unit identity
  * validation (MV-G23): the loaded expose's compatibility metadata must match
@@ -33,20 +17,6 @@ function warnLegacyLoad() {
  */
 export function loadBackendFederatedEffectApi(
   options: BackendFederationIdentityLoadOptions,
-): Promise<BackendFederatedEffectApiModule>;
-/**
- * @deprecated Pass `expected` (delivery-unit `unitId` + `buildMarker`).
- * Loads without an expected identity cannot be validated against a resolved
- * delivery-unit record and emit a runtime warning.
- */
-export function loadBackendFederatedEffectApi(
-  options: BackendFederationLoadOptions,
-): Promise<BackendFederatedEffectApiModule>;
-export function loadBackendFederatedEffectApi(
-  options: BackendFederationLoadOptions & {
-    expected?: BackendFederationExpectedIdentity;
-    allowMissingIdentityMetadata?: boolean;
-  },
 ): Promise<BackendFederatedEffectApiModule> {
   const remoteName = options.remote?.name ?? options.remoteName;
   if (remoteName === undefined || remoteName.length === 0) {
@@ -55,8 +25,12 @@ export function loadBackendFederatedEffectApi(
     );
   }
 
-  if (options.expected === undefined) {
-    warnLegacyLoad();
+  if (!options.expected?.unitId || !options.expected.buildMarker) {
+    return Promise.reject(
+      new Error(
+        '[BFF][Effect] Backend federation requires expected.unitId and expected.buildMarker.',
+      ),
+    );
   }
 
   if (options.runtime !== undefined) {
@@ -93,7 +67,6 @@ export function loadBackendFederatedEffectApi(
   const remoteRequest = `${remoteName}/${normalizeExpose(expose)}`;
   return runtime.loadRemote(remoteRequest).then(loaded =>
     validateLoadedBackendFederatedEffectApi(loaded, {
-      allowMissingIdentityMetadata: options.allowMissingIdentityMetadata,
       expected: options.expected,
       remoteName,
       remoteRequest,

package/src/backend-federation/node.ts

@@ -1,6 +1,5 @@
 import { evaluateNodeBackendFederationCommonJs } from '@modern-js/server-runtime-extensions/backend-federation-security/node';
 
-import type { BackendFederationExpectedIdentity } from './identity';
 import { loadBackendFederatedEffectApi as loadUniversalBackendFederatedEffectApi } from './load';
 import type {
   BackendFederatedEffectApiModule,
@@ -10,16 +9,6 @@ import type {
 
 export function loadBackendFederatedEffectApi(
   options: BackendFederationIdentityLoadOptions,
-): Promise<BackendFederatedEffectApiModule>;
-/** @deprecated Pass `expected` delivery-unit identity. */
-export function loadBackendFederatedEffectApi(
-  options: BackendFederationLoadOptions,
-): Promise<BackendFederatedEffectApiModule>;
-export function loadBackendFederatedEffectApi(
-  options: BackendFederationLoadOptions & {
-    expected?: BackendFederationExpectedIdentity;
-    allowMissingIdentityMetadata?: boolean;
-  },
 ): Promise<BackendFederatedEffectApiModule> {
   return loadUniversalBackendFederatedEffectApi({
     ...options,

package/src/backend-federation/types.ts

@@ -85,12 +85,6 @@ export type BackendFederationLoadOptions = BackendFederationRuntimeOptions & {
 export type BackendFederationIdentityLoadOptions =
   BackendFederationLoadOptions & {
     expected: BackendFederationExpectedIdentity;
-    /**
-     * Tolerate legacy exposes without identity metadata (mismatching declared
-     * values still fail). Prefer leaving this unset: identity-less exposes
-     * cannot be validated against a resolved delivery-unit record.
-     */
-    allowMissingIdentityMetadata?: boolean;
   };
 
 export type BackendFederationLoadEntryPlugin = ModuleFederationRuntimePlugin & {