@bleedingdev/modern-js-plugin-bff-extensions 3.9.0-ultramodern.2 → 3.9.0-ultramodern.21

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

@@ -1,14 +1,12 @@
+import type { BACKEND_FEDERATION_EFFECT_EXPOSE } from '@modern-js/backend-federation-contracts';
 import type { EffectApiModule } from '@modern-js/bff-effect/effect';
 import type { BackendFederationRemoteEntryPolicy, BackendFederationRemoteEntryVerification } from '@modern-js/server-runtime-extensions/backend-federation-security';
-import type { BACKEND_FEDERATION_EFFECT_EXPOSE } from '@modern-js/utils/universal';
 import type { ModuleFederation, ModuleFederationRuntimePlugin } from '@module-federation/runtime';
 import type { BackendFederationExpectedIdentity } from './identity.js';
 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 = {
@@ -62,15 +62,4 @@ 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: {
-        remoteInfo: BackendFederationRemote;
-    }) => BackendFederationEntryExports | undefined | Promise<BackendFederationEntryExports | undefined>;
 };

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/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/evaluation.d.ts

@@ -1,4 +1,4 @@
-import { type CrossProjectRequestObservation, type NormalizedCrossProjectPolicy } from '@modern-js/bff-core/security/cross-project-policy';
+import { type CrossProjectRequestObservation, type NormalizedCrossProjectPolicy } from '@modern-js/server-runtime-extensions/bff-policy';
 export type ResolvedCrossProjectPolicy = NormalizedCrossProjectPolicy;
 export declare const checkCrossProjectPolicyResponse: (headers: Record<string, unknown>, policy: ResolvedCrossProjectPolicy | undefined, observedRequest?: CrossProjectRequestObservation) => Response | null;
 export declare const checkCrossProjectPolicyForRequest: (request: Request, policy: ResolvedCrossProjectPolicy | undefined) => Response | null;

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

@@ -1,4 +1,5 @@
-import { type OperationContractSource } from '@modern-js/bff-core';
+import '@modern-js/server-runtime-extensions/server-config';
 import type { ServerPluginAPI } from '@modern-js/server-core';
+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/cross-project-policy/producer-runtime.d.ts

@@ -0,0 +1,20 @@
+interface ProducerClientOptions {
+    requestId?: string;
+    requireEnvelope?: boolean;
+    identityBinding?: {
+        enabled?: boolean;
+        strict?: boolean;
+        protectedHeaders?: string[];
+    };
+    operationContract?: {
+        enabled?: boolean;
+        strict?: boolean;
+        requireSchemaHash?: boolean;
+        requireOperationVersion?: boolean;
+    };
+}
+/** Bind producer defaults once while preserving every per-call nested override. */
+export declare function createProducerClient<Options extends ProducerClientOptions, Result>(configure: (options: Options) => Result, { requestId }: {
+    requestId: string;
+}): (options?: Options) => Result;
+export {};

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-server/entry.d.ts

@@ -0,0 +1,3 @@
+import '@modern-js/server-runtime-extensions/server-config';
+import type { ServerPluginAPI } from '@modern-js/server-core';
+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/index.d.ts

@@ -1,3 +1,6 @@
-export { resolveEffectEntryFile } from '../client-generator/paths.js';
+export { bundleBuiltEffectEntryForNode, resolveEffectEntryPaths, } from './built-entry.js';
 export { bundleEffectEntryForNode } from './loader.js';
-export { generateEffectClientCode, generateEffectWorkerRuntimeWrapper, } from './worker-runtime-wrapper.js';
+export { resolveEffectOperationContracts } from './operation-contracts.js';
+export { resolveEffectEntryFile } from './paths.js';
+export { bundleEffectWorkerRuntimeSource } from './worker-runtime-source.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/paths.d.ts

@@ -0,0 +1,23 @@
+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;
+};
+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/dist/types/effect-source-loader/rspack-loader.d.ts

@@ -0,0 +1,9 @@
+import type { Rspack } from '@rsbuild/core';
+export interface EffectBffLoaderOptions {
+    prefix: string;
+    appDir: string;
+    apiDir: string;
+    effectEntry: string;
+    requestId?: string;
+}
+export default function loader(this: Rspack.LoaderContext<EffectBffLoaderOptions>, source: string): Promise<void>;

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

@@ -0,0 +1,4 @@
+/** Keep the worker implementation graph out of the API-to-client loader. */
+export declare function bundleEffectWorkerRuntimeSource(source: string, resourcePath: string, loader: {
+    addDependency: (dependency: string) => void;
+}): Promise<string>;

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/dist/types/hono/node.d.ts

@@ -0,0 +1,4 @@
+import type { ServerPluginAPI } from '@modern-js/server-core';
+import type { OperationContractSource } from '@modern-js/server-runtime-extensions/bff-policy/node';
+import { type BindHonoRouteHandlersOptions } from './bind-route-handlers.js';
+export declare const createHonoRouteBinder: (api: ServerPluginAPI, handlers: OperationContractSource[]) => (options: Pick<BindHonoRouteHandlersOptions, 'handler' | 'routePath'>) => import("hono").MiddlewareHandler[] | import("hono").MiddlewareHandler;

package/package.json

@@ -18,7 +18,7 @@
     "modern.js",
     "ultramodern.js"
   ],
-  "version": "3.9.0-ultramodern.2",
+  "version": "3.9.0-ultramodern.21",
   "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",
@@ -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": {
@@ -115,6 +107,30 @@
         "require": "./dist/cjs/backend-federation-manifest/node.js"
       },
       "default": "./dist/cjs/backend-federation-manifest/node.js"
+    },
+    "./effect-source-loader/rspack-loader": {
+      "types": "./dist/types/effect-source-loader/rspack-loader.d.ts",
+      "node": {
+        "import": "./dist/esm-node/effect-source-loader/rspack-loader.mjs",
+        "require": "./dist/cjs/effect-source-loader/rspack-loader.js"
+      },
+      "default": "./dist/cjs/effect-source-loader/rspack-loader.js"
+    },
+    "./producer-runtime": {
+      "types": "./dist/types/cross-project-policy/producer-runtime.d.ts",
+      "node": {
+        "import": "./dist/esm-node/cross-project-policy/producer-runtime.mjs",
+        "require": "./dist/cjs/cross-project-policy/producer-runtime.js"
+      },
+      "import": "./dist/esm/cross-project-policy/producer-runtime.mjs",
+      "default": "./dist/esm/cross-project-policy/producer-runtime.mjs"
+    },
+    "./hono/node": {
+      "types": "./dist/types/hono/node.d.ts",
+      "node": {
+        "import": "./dist/esm-node/hono/node.mjs",
+        "require": "./dist/cjs/hono/node.js"
+      }
     }
   },
   "typesVersions": {
@@ -131,18 +147,14 @@
         "./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",
         "./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"
@@ -162,6 +174,18 @@
       "backend-federation-manifest/node": [
         "./dist/types/backend-federation-manifest/node.d.ts",
         "./src/backend-federation-manifest/node.ts"
+      ],
+      "effect-source-loader/rspack-loader": [
+        "./dist/types/effect-source-loader/rspack-loader.d.ts",
+        "./src/effect-source-loader/rspack-loader.ts"
+      ],
+      "producer-runtime": [
+        "./dist/types/cross-project-policy/producer-runtime.d.ts",
+        "./src/cross-project-policy/producer-runtime.ts"
+      ],
+      "hono/node": [
+        "./dist/types/hono/node.d.ts",
+        "./src/hono/node.ts"
       ]
     }
   },
@@ -169,19 +193,21 @@
     "node": ">=26.7.0"
   },
   "dependencies": {
-    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.9.0-ultramodern.2",
-    "@modern-js/bff-effect": "npm:@bleedingdev/modern-js-bff-effect@3.9.0-ultramodern.2",
-    "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.0-ultramodern.2",
-    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.0-ultramodern.2",
-    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.0-ultramodern.2",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.2",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.2",
-    "@module-federation/runtime": "2.9.0",
+    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.0-ultramodern.21",
+    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.9.0-ultramodern.21",
+    "@modern-js/bff-effect": "npm:@bleedingdev/modern-js-bff-effect@3.9.0-ultramodern.21",
+    "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.0-ultramodern.21",
+    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.0-ultramodern.21",
+    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.0-ultramodern.21",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.21",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.21",
+    "@module-federation/runtime": "2.9.2",
+    "@swc/core": "1.16.2",
     "esbuild": "^0.28.2"
   },
   "peerDependencies": {
-    "@effect/opentelemetry": "4.0.0-rc.112",
-    "effect": "4.0.0-rc.112"
+    "@effect/opentelemetry": "4.0.0-rc.117",
+    "effect": "4.0.0-rc.117"
   },
   "peerDependenciesMeta": {
     "@effect/opentelemetry": {
@@ -192,13 +218,15 @@
     }
   },
   "devDependencies": {
-    "@effect/opentelemetry": "4.0.0-rc.112",
-    "@rslib/core": "1.0.0",
+    "@effect/opentelemetry": "4.0.0-rc.117",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.0-ultramodern.21",
+    "@rsbuild/core": "2.2.10",
+    "@rslib/core": "1.0.2",
     "@scripts/rstest-config": "2.66.0",
-    "@types/node": "^26.4.1",
-    "@types/react": "^19.2.18",
+    "@types/node": "^26.6.2",
+    "@types/react": "^19.3.0",
     "@typescript/native-preview": "7.0.0-dev.20260707.2",
-    "effect": "4.0.0-rc.112"
+    "effect": "4.0.0-rc.117"
   },
   "sideEffects": false,
   "publishConfig": {

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

@@ -3,16 +3,14 @@ import {
   BACKEND_FEDERATION_EFFECT_EXPOSE,
   BACKEND_FEDERATION_MANIFEST_FILE,
   BACKEND_FEDERATION_NODE_ADAPTER_VERSION,
-} from '@modern-js/utils/universal';
+} from '@modern-js/backend-federation-contracts';
 import {
   type BackendFederationEdgeLoadEntryPlugin,
   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,
@@ -54,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 =
@@ -79,24 +79,15 @@ 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 ||
-    (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.',
       ),
     );
   }
@@ -108,8 +99,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 +115,7 @@ export function loadBackendFederatedEffectApi(
 
   let runtime;
   try {
-    runtime = createBackendFederationRuntimeForLoad(options);
+    runtime = createBackendFederationRuntime(options);
   } catch (error) {
     return Promise.reject(error);
   }