@bleedingdev/modern-js-plugin-bff-extensions 3.9.0-ultramodern.9 → 3.9.3-ultramodern.1

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

@@ -10,16 +10,35 @@ const JS_OR_TS_EXTS = [
     '.cjs',
     '.cts'
 ];
-function resolveEffectEntryFile(options) {
-    const { appDir, apiDir, effectEntry } = options;
-    const resolveEntry = (entryWithoutExt)=>{
-        if ('' !== upath.extname(entryWithoutExt)) return fs.existsSync(entryWithoutExt) ? entryWithoutExt : void 0;
-        return findExists(JS_OR_TS_EXTS.map((ext)=>`${entryWithoutExt}${ext}`)) || void 0;
+const emittedEffectEntry = (entry)=>entry.replace(/\.(?:[cm]?ts|tsx|jsx)$/u, '.js');
+function relativeEffectAppPath(appDir, entry) {
+    const relative = upath.relative(appDir, entry);
+    return '..' === relative || relative.startsWith('../') || relative.split('/').includes('node_modules') ? void 0 : relative;
+}
+function existingEntry(entry) {
+    return upath.extname(entry) ? fs.existsSync(entry) ? entry : void 0 : findExists(JS_OR_TS_EXTS.map((ext)=>`${entry}${ext}`)) || void 0;
+}
+function resolveEffectEntry(options) {
+    const { appDir, apiDir, effectEntry, distDir } = options;
+    const entry = upath.resolve(appDir, effectEntry || upath.join(apiDir, 'index'));
+    if (distDir && void 0 !== relativeEffectAppPath(distDir, entry)) return {
+        kind: 'built-output',
+        path: existingEntry(emittedEffectEntry(entry))
+    };
+    const relative = relativeEffectAppPath(appDir, entry);
+    if (void 0 === relative) return {
+        kind: 'external-sdk',
+        path: existingEntry(entry)
     };
-    if (void 0 !== effectEntry && '' !== effectEntry) {
-        const entryWithoutExt = upath.isAbsolute(effectEntry) ? effectEntry : upath.resolve(appDir, effectEntry);
-        return resolveEntry(entryWithoutExt);
-    }
-    return resolveEntry(upath.resolve(apiDir, 'index'));
+    return distDir ? {
+        kind: 'built-output',
+        path: existingEntry(emittedEffectEntry(upath.resolve(distDir, relative)))
+    } : {
+        kind: 'app-source',
+        path: existingEntry(entry)
+    };
+}
+function resolveEffectEntryFile(options) {
+    return resolveEffectEntry(options).path;
 }
-export { resolveEffectEntryFile };
+export { emittedEffectEntry, relativeEffectAppPath, resolveEffectEntry, resolveEffectEntryFile };

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

@@ -8,19 +8,21 @@ export { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE,
 export type BackendFederationRemote = BackendFederationEdgeRemote;
 export type BackendFederationRuntimeOptions = BackendFederationEdgeRuntimeOptions;
 export type BackendFederationLoadEntryPluginOptions = BackendFederationEdgeLoadEntryPluginOptions;
-export type EdgeBackendFederationLoadOptions = Omit<BackendFederationLoadOptions, 'entryPolicy' | 'plugins' | 'remote' | 'remotes' | 'runtime'> & {
+export type EdgeBackendFederationLoadOptions = Omit<BackendFederationLoadOptions, 'entryPolicy' | 'plugins' | 'remote' | 'remotes' | 'runtime' | 'shared'> & {
     entryPolicy?: never;
     plugins?: BackendFederationEdgeLoadEntryPlugin[];
     remote?: BackendFederationEdgeRemote;
     remotes?: BackendFederationEdgeRemote[];
     runtime?: never;
+    shared?: never;
 };
-export type EdgeBackendFederationIdentityLoadOptions = Omit<UniversalBackendFederationIdentityLoadOptions, 'entryPolicy' | 'plugins' | 'remote' | 'remotes' | 'runtime'> & {
+export type EdgeBackendFederationIdentityLoadOptions = Omit<UniversalBackendFederationIdentityLoadOptions, 'entryPolicy' | 'plugins' | 'remote' | 'remotes' | 'runtime' | 'shared'> & {
     entryPolicy?: never;
     plugins?: BackendFederationEdgeLoadEntryPlugin[];
     remote?: BackendFederationEdgeRemote;
     remotes?: BackendFederationEdgeRemote[];
     runtime?: never;
+    shared?: never;
 };
 export type BackendFederationIdentityLoadOptions = EdgeBackendFederationIdentityLoadOptions;
 export declare function loadBackendFederatedEffectApi(options: EdgeBackendFederationIdentityLoadOptions): Promise<BackendFederatedEffectApiModule>;

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

@@ -11,11 +11,8 @@ export type BackendFederationIdentityIssue = {
     path: string;
     message: string;
 };
-/**
- * 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.
- */
+/** Decode independently at each received-manifest / executed-expose boundary. */
+export declare function backendFederationCompatibility(loaded: unknown): Record<string, unknown> | undefined;
+export declare function validateBackendFederationCompatibility(compatibility: Record<string, unknown>, expected: Record<string, string | undefined>): BackendFederationIdentityIssue[];
 export declare function validateExpectedBackendFederationIdentity(loaded: unknown, expected: BackendFederationExpectedIdentity): BackendFederationIdentityIssue[];
 export declare function formatBackendFederationIdentityIssues(issues: BackendFederationIdentityIssue[]): string;

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

@@ -0,0 +1,13 @@
+import { Module, type ModuleFederation, type ModuleFederationRuntimePlugin } from '@module-federation/runtime';
+import type { BackendFederationEntryExports, BackendFederationRemote, BackendFederationRuntimeOptions } from './types.js';
+type RemoteInfo = ConstructorParameters<typeof Module>[0]['remoteInfo'];
+export declare const PROVIDED_ENTRY_SCHEME: RegExp;
+export declare function registerRemoteContainer(origin: ModuleFederation, remoteInfo: RemoteInfo, container: BackendFederationEntryExports): void;
+/**
+ * Loads each configured remote once per runtime and registers the resulting
+ * container with that runtime only, so Module Federation initializes it with
+ * the runtime's own share scope. Registered last, it replaces any container a
+ * caller plugin supplied for a scheme it owns.
+ */
+export declare function createBackendFederationIntegrityPlugin(options: BackendFederationRuntimeOptions, remotes: readonly BackendFederationRemote[]): ModuleFederationRuntimePlugin;
+export {};

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

@@ -0,0 +1,20 @@
+import type { BackendFederationRuntimeOptions } from './types.js';
+type HostShared = NonNullable<BackendFederationRuntimeOptions['shared']>;
+/**
+ * Shares the package-private Effect handler factory registry and the Effect
+ * request storage with every backend container, so factories a remote creates
+ * with defineEffectBff are recognized by this host's module resolver and its
+ * endpoints read the context this host's dispatcher enters.
+ *
+ * Loaded on first call, not when this module loads: a CommonJS require() of
+ * the Effect ES modules throws while a concurrent import() is still loading
+ * them.
+ */
+export declare function effectBffHostShared(): HostShared;
+/**
+ * Adds the host shares to caller shares. Their names are reserved: a caller
+ * replacement would make containers use a registry or a request storage this
+ * host never consults.
+ */
+export declare function withEffectBffHostShared(shared: BackendFederationRuntimeOptions['shared']): HostShared;
+export {};

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

@@ -1,2 +1,5 @@
+import { effectBffHostShared } from './node-shared.js';
+/** Call for the `shared` option when building a custom runtime for Node hosts. */
+export { effectBffHostShared };
 import type { BackendFederatedEffectApiModule, BackendFederationIdentityLoadOptions } from './types.js';
 export declare function loadBackendFederatedEffectApi(options: BackendFederationIdentityLoadOptions): Promise<BackendFederatedEffectApiModule>;

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

@@ -1,3 +1,7 @@
 import type { ModuleFederationRuntimePlugin } from '@module-federation/runtime';
 import type { BackendFederationLoadEntryPluginOptions } from './types.js';
+/**
+ * Serves binding:, service: and static: entries. The provider resolves each
+ * remote once per runtime and registers the container with that runtime only.
+ */
 export declare function createBackendFederationLoadEntryPlugin(options: BackendFederationLoadEntryPluginOptions): ModuleFederationRuntimePlugin;

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

@@ -7,8 +7,6 @@ export type BackendFederationRemote = {
     name: string;
     entry: string;
     type?: 'commonjs-module' | 'module' | string;
-    entryGlobalName?: string;
-    shareScope?: string | string[];
     expose?: typeof BACKEND_FEDERATION_EFFECT_EXPOSE;
     verification?: BackendFederationRemoteEntryVerification;
 };
@@ -17,6 +15,8 @@ export type BackendFederationRuntimeOptions = {
     remote?: BackendFederationRemote;
     remotes?: BackendFederationRemote[];
     plugins?: ModuleFederationRuntimePlugin[];
+    /** Host shares handed to every remote container's `init()`. */
+    shared?: ConstructorParameters<typeof ModuleFederation>[0]['shared'];
     entryPolicy?: BackendFederationRemoteEntryPolicy;
 };
 export type BackendFederationEntryExports = {
@@ -63,8 +63,3 @@ export type BackendFederationLoadOptions = BackendFederationRuntimeOptions & {
 export type BackendFederationIdentityLoadOptions = BackendFederationLoadOptions & {
     expected: BackendFederationExpectedIdentity;
 };
-export type BackendFederationLoadEntryPlugin = ModuleFederationRuntimePlugin & {
-    loadEntry?: (args: {
-        remoteInfo: BackendFederationRemote;
-    }) => BackendFederationEntryExports | undefined | Promise<BackendFederationEntryExports | undefined>;
-};

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

@@ -1,6 +1,6 @@
 import type { BackendFederationRemoteEntryPolicy, BackendFederationResourcePolicy, BackendFederationResourceResponse } from '@modern-js/server-runtime-extensions/backend-federation-security';
 import type { ModuleFederation, ModuleFederationRuntimePlugin } from '@module-federation/runtime';
-import type { BackendFederatedEffectApiModule, BackendFederationRemote } from '../backend-federation/index.js';
+import type { BackendFederatedEffectApiModule, BackendFederationRemote, BackendFederationRuntimeOptions } from '../backend-federation/index.js';
 import type { BackendFederationManifestAdapterError } from './errors.js';
 export type BackendFederationManifest = Record<string, unknown>;
 export type BackendFederationVersionBoundaryExpectation = {
@@ -44,6 +44,7 @@ export type BackendFederationManifestAdapterOptions = {
     plugins?: ModuleFederationRuntimePlugin[];
     remote?: Partial<BackendFederationRemote>;
     runtime?: ModuleFederation;
+    shared?: BackendFederationRuntimeOptions['shared'];
     signal?: AbortSignal;
     timeoutMs?: number;
 };

package/dist/types/cross-project-policy/node.d.ts

@@ -1,5 +1,5 @@
 import '@modern-js/server-runtime-extensions/server-config';
 import type { ServerPluginAPI } from '@modern-js/server-core';
-import { type OperationContractSource } from '@modern-js/server-runtime-extensions/bff-policy/node';
+import { type OperationContractSource, resolveOperationProducer } from '@modern-js/server-runtime-extensions/bff-policy/node';
 import type { ResolvedCrossProjectPolicy } from './evaluation.js';
-export declare const resolveAdapterCrossProjectPolicy: (api: ServerPluginAPI, handlers: OperationContractSource[]) => ResolvedCrossProjectPolicy | undefined;
+export declare const resolveAdapterCrossProjectPolicy: (api: ServerPluginAPI, handlers: OperationContractSource[], producer?: ReturnType<typeof resolveOperationProducer>) => ResolvedCrossProjectPolicy | undefined;

package/dist/types/effect-server/cross-project-policy.d.ts

@@ -0,0 +1,5 @@
+import { type EffectApiModule } from '@modern-js/bff-effect/effect';
+import type { ServerPluginAPI } from '@modern-js/server-core';
+import type { resolveOperationProducer } from '@modern-js/server-runtime-extensions/bff-policy/node';
+import type { ResolvedCrossProjectPolicy } from '../cross-project-policy/evaluation.js';
+export declare function resolveEffectServerCrossProjectPolicy(api: ServerPluginAPI, prefix: string, mod: EffectApiModule | null, producer?: ReturnType<typeof resolveOperationProducer>): Promise<ResolvedCrossProjectPolicy | undefined>;

package/dist/types/{effect-adapter → effect-server}/entry.d.ts

@@ -1,3 +1,3 @@
 import '@modern-js/server-runtime-extensions/server-config';
 import type { ServerPluginAPI } from '@modern-js/server-core';
-export declare function resolveEffectAdapterEntryFile(api: ServerPluginAPI): string | undefined;
+export declare function resolveEffectServerEntryFile(api: ServerPluginAPI): string | undefined;

package/dist/types/effect-server/error-response.d.ts

@@ -0,0 +1,2 @@
+import type { Context, ServerPluginAPI } from '@modern-js/server-core';
+export declare function createEffectServerRuntimeErrorResponse(api: ServerPluginAPI, error: unknown, context: Context): Promise<Response>;

package/dist/types/effect-server/index.d.ts

@@ -0,0 +1,4 @@
+import '@modern-js/server-runtime-extensions/server-config';
+import type { ServerPlugin } from '@modern-js/server-core';
+export default _default;
+declare function _default(): ServerPlugin;

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

@@ -1,5 +1,23 @@
-export declare function resolveEffectEntryFile(options: {
+export declare const emittedEffectEntry: (entry: string) => string;
+export declare function relativeEffectAppPath(appDir: string, entry: string): string | undefined;
+type EffectEntryOptions = {
     appDir: string;
     apiDir: string;
     effectEntry?: string;
-}): string | undefined;
+};
+export type EffectEntry = {
+    kind: 'app-source';
+    path: string | undefined;
+} | {
+    kind: 'built-output';
+    path: string | undefined;
+} | {
+    kind: 'external-sdk';
+    path: string | undefined;
+};
+/** Classify ownership before resolving files: production works without source. */
+export declare function resolveEffectEntry(options: EffectEntryOptions & {
+    distDir?: string;
+}): EffectEntry;
+export declare function resolveEffectEntryFile(options: EffectEntryOptions): string | undefined;
+export {};

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@bleedingdev/modern-js-plugin-bff-extensions",
   "description": "Fork-owned UltraModern.js BFF adapters, generation, policy, and backend federation extensions.",
-  "homepage": "https://github.com/BleedingDev/ultramodern.js#readme",
+  "homepage": "https://github.com/ultramodernjs/ultramodern.js#readme",
   "bugs": {
-    "url": "https://github.com/BleedingDev/ultramodern.js/issues"
+    "url": "https://github.com/ultramodernjs/ultramodern.js/issues"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/BleedingDev/ultramodern.js.git",
+    "url": "git+https://github.com/ultramodernjs/ultramodern.js.git",
     "directory": "packages/cli/plugin-bff-extensions"
   },
   "license": "MIT",
@@ -18,7 +18,7 @@
     "modern.js",
     "ultramodern.js"
   ],
-  "version": "3.9.0-ultramodern.9",
+  "version": "3.9.3-ultramodern.1",
   "files": [
     "dist",
     "src"
@@ -50,13 +50,13 @@
       },
       "default": "./dist/cjs/cross-project-generation/index.js"
     },
-    "./effect-adapter": {
-      "types": "./dist/types/effect-adapter/index.d.ts",
+    "./effect-server": {
+      "types": "./dist/types/effect-server/index.d.ts",
       "node": {
-        "import": "./dist/esm-node/effect-adapter/index.mjs",
-        "require": "./dist/cjs/effect-adapter/index.js"
+        "import": "./dist/esm-node/effect-server/index.mjs",
+        "require": "./dist/cjs/effect-server/index.js"
       },
-      "default": "./dist/cjs/effect-adapter/index.js"
+      "default": "./dist/cjs/effect-server/index.js"
     },
     "./effect-source-loader": {
       "types": "./dist/types/effect-source-loader/index.d.ts",
@@ -147,9 +147,9 @@
         "./dist/types/cross-project-generation/index.d.ts",
         "./src/cross-project-generation/index.ts"
       ],
-      "effect-adapter": [
-        "./dist/types/effect-adapter/index.d.ts",
-        "./src/effect-adapter/index.ts"
+      "effect-server": [
+        "./dist/types/effect-server/index.d.ts",
+        "./src/effect-server/index.ts"
       ],
       "effect-source-loader": [
         "./dist/types/effect-source-loader/index.d.ts",
@@ -190,24 +190,24 @@
     }
   },
   "engines": {
-    "node": ">=26.7.0"
+    "node": ">=26.10.0"
   },
   "dependencies": {
-    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.0-ultramodern.9",
-    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.9.0-ultramodern.9",
-    "@modern-js/bff-effect": "npm:@bleedingdev/modern-js-bff-effect@3.9.0-ultramodern.9",
-    "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.0-ultramodern.9",
-    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.0-ultramodern.9",
-    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.0-ultramodern.9",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.9",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.9",
-    "@module-federation/runtime": "2.9.0",
-    "@swc/core": "1.16.2",
+    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.3-ultramodern.1",
+    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.9.3-ultramodern.1",
+    "@modern-js/bff-effect": "npm:@bleedingdev/modern-js-bff-effect@3.9.3-ultramodern.1",
+    "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.3-ultramodern.1",
+    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.3-ultramodern.1",
+    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.3-ultramodern.1",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.3-ultramodern.1",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.3-ultramodern.1",
+    "@module-federation/runtime": "2.9.2",
+    "@swc/core": "1.16.13",
     "esbuild": "^0.28.2"
   },
   "peerDependencies": {
-    "@effect/opentelemetry": "4.0.0-rc.112",
-    "effect": "4.0.0-rc.112"
+    "@effect/opentelemetry": "4.0.0",
+    "effect": "4.0.0"
   },
   "peerDependenciesMeta": {
     "@effect/opentelemetry": {
@@ -218,15 +218,14 @@
     }
   },
   "devDependencies": {
-    "@effect/opentelemetry": "4.0.0-rc.112",
-    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.0-ultramodern.9",
-    "@rsbuild/core": "2.2.3",
-    "@rslib/core": "1.0.0",
+    "@effect/opentelemetry": "4.0.0",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.3-ultramodern.1",
+    "@rsbuild/core": "2.2.11",
+    "@rslib/core": "1.0.3",
     "@scripts/rstest-config": "2.66.0",
-    "@types/node": "^26.4.1",
-    "@types/react": "^19.2.18",
-    "@typescript/native-preview": "7.0.0-dev.20260707.2",
-    "effect": "4.0.0-rc.112"
+    "@types/node": "^26.6.3",
+    "@types/react": "^19.3.0",
+    "effect": "4.0.0"
   },
   "sideEffects": false,
   "publishConfig": {
@@ -237,5 +236,8 @@
     "dev": "rslib build --watch",
     "build": "rslib build",
     "test": "rstest"
+  },
+  "ultramodern": {
+    "sourceName": "@modern-js/plugin-bff-extensions"
   }
 }

package/src/backend-federation/edge.ts

@@ -52,24 +52,26 @@ export type BackendFederationLoadEntryPluginOptions =
 
 export type EdgeBackendFederationLoadOptions = Omit<
   BackendFederationLoadOptions,
-  'entryPolicy' | 'plugins' | 'remote' | 'remotes' | 'runtime'
+  'entryPolicy' | 'plugins' | 'remote' | 'remotes' | 'runtime' | 'shared'
 > & {
   entryPolicy?: never;
   plugins?: BackendFederationEdgeLoadEntryPlugin[];
   remote?: BackendFederationEdgeRemote;
   remotes?: BackendFederationEdgeRemote[];
   runtime?: never;
+  shared?: never;
 };
 
 export type EdgeBackendFederationIdentityLoadOptions = Omit<
   UniversalBackendFederationIdentityLoadOptions,
-  'entryPolicy' | 'plugins' | 'remote' | 'remotes' | 'runtime'
+  'entryPolicy' | 'plugins' | 'remote' | 'remotes' | 'runtime' | 'shared'
 > & {
   entryPolicy?: never;
   plugins?: BackendFederationEdgeLoadEntryPlugin[];
   remote?: BackendFederationEdgeRemote;
   remotes?: BackendFederationEdgeRemote[];
   runtime?: never;
+  shared?: never;
 };
 
 export type BackendFederationIdentityLoadOptions =
@@ -80,11 +82,12 @@ export function loadBackendFederatedEffectApi(
 ): Promise<BackendFederatedEffectApiModule> {
   if (
     (options as BackendFederationLoadOptions).runtime !== undefined ||
-    (options as BackendFederationLoadOptions).entryPolicy !== undefined
+    (options as BackendFederationLoadOptions).entryPolicy !== undefined ||
+    (options as BackendFederationLoadOptions).shared !== undefined
   ) {
     return Promise.reject(
       new Error(
-        '[BFF][Effect] Edge backend federation does not execute custom runtimes or entry evaluators. Register a static or service-binding entry provider.',
+        '[BFF][Effect] Edge backend federation does not execute custom runtimes, entry evaluators or host shares. Register a static or service-binding entry provider.',
       ),
     );
   }

package/src/backend-federation/identity.ts

@@ -17,59 +17,51 @@ export type BackendFederationIdentityIssue = {
   message: string;
 };
 
-/**
- * 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.
- */
-export function validateExpectedBackendFederationIdentity(
-  loaded: unknown,
-  expected: BackendFederationExpectedIdentity,
-): BackendFederationIdentityIssue[] {
-  const issues: BackendFederationIdentityIssue[] = [];
+/** Decode independently at each received-manifest / executed-expose boundary. */
+export function backendFederationCompatibility(loaded: unknown) {
   const contract = isRecord(loaded)
     ? loaded.backendFederationContract
     : undefined;
   const compatibility = isRecord(contract) ? contract.compatibility : undefined;
+  return isRecord(compatibility) ? compatibility : undefined;
+}
 
-  if (!isRecord(compatibility)) {
-    return [
-      {
-        path: 'backendFederationContract.compatibility',
-        message:
-          'loaded module declares no compatibility metadata; delivery-unit identity cannot be validated',
-      },
-    ];
-  }
-
-  const unitId = compatibility.unitId;
-  if (typeof unitId !== 'string' || unitId.length === 0) {
-    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',
-      message: `expected ${expected.unitId}, received ${unitId}`,
-    });
-  }
-
-  const build = compatibility.build;
-  if (typeof build !== 'string' || build.length === 0) {
-    issues.push({
-      path: 'backendFederationContract.compatibility.build',
-      message: `missing build marker; expected ${expected.buildMarker}`,
-    });
-  } else if (build !== expected.buildMarker) {
-    issues.push({
-      path: 'backendFederationContract.compatibility.build',
-      message: `expected ${expected.buildMarker}, received ${build}`,
-    });
-  }
+export function validateBackendFederationCompatibility(
+  compatibility: Record<string, unknown>,
+  expected: Record<string, string | undefined>,
+): BackendFederationIdentityIssue[] {
+  return Object.entries(expected).flatMap(([field, value]) =>
+    value === undefined ||
+    (typeof compatibility[field] === 'string' &&
+      compatibility[field].length > 0 &&
+      compatibility[field] === value)
+      ? []
+      : [
+          {
+            path: `backendFederationContract.compatibility.${field}`,
+            message: `expected ${value}, received ${typeof compatibility[field] === 'string' ? compatibility[field] : typeof compatibility[field]}`,
+          },
+        ],
+  );
+}
 
-  return issues;
+export function validateExpectedBackendFederationIdentity(
+  loaded: unknown,
+  expected: BackendFederationExpectedIdentity,
+): BackendFederationIdentityIssue[] {
+  const compatibility = backendFederationCompatibility(loaded);
+  return compatibility
+    ? validateBackendFederationCompatibility(compatibility, {
+        unitId: expected.unitId,
+        build: expected.buildMarker,
+      })
+    : [
+        {
+          path: 'backendFederationContract.compatibility',
+          message:
+            'loaded module declares no compatibility metadata; delivery-unit identity cannot be validated',
+        },
+      ];
 }
 
 export function formatBackendFederationIdentityIssues(