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

package/dist/esm/backend-federation/identity.mjs

@@ -1,35 +1,29 @@
 import { isRecord } from "./utils.mjs";
-function validateExpectedBackendFederationIdentity(loaded, expected, options = {}) {
-    const allowMissing = true === options.allowMissingIdentityMetadata;
+function validateExpectedBackendFederationIdentity(loaded, expected) {
     const issues = [];
     const contract = isRecord(loaded) ? loaded.backendFederationContract : void 0;
     const compatibility = isRecord(contract) ? contract.compatibility : void 0;
-    if (!isRecord(compatibility)) {
-        if (allowMissing) return [];
-        return [
-            {
-                path: 'backendFederationContract.compatibility',
-                message: 'loaded module declares no compatibility metadata; delivery-unit identity cannot be validated'
-            }
-        ];
-    }
+    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 ('string' != typeof unitId || 0 === unitId.length) {
-        if (!allowMissing) issues.push({
-            path: 'backendFederationContract.compatibility.unitId',
-            message: `missing delivery-unit id; expected ${expected.unitId}`
-        });
-    } else if (unitId !== expected.unitId) issues.push({
+    if ('string' != typeof unitId || 0 === unitId.length) 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 ('string' != typeof build || 0 === build.length) {
-        if (!allowMissing) issues.push({
-            path: 'backendFederationContract.compatibility.build',
-            message: `missing build marker; expected ${expected.buildMarker}`
-        });
-    } else if (build !== expected.buildMarker) issues.push({
+    if ('string' != typeof build || 0 === build.length) 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}`
     });

package/dist/esm/backend-federation/index.mjs

@@ -1,4 +1,4 @@
-export { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from "@modern-js/utils/universal";
+export { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from "@modern-js/backend-federation-contracts";
 export { validateExpectedBackendFederationIdentity } from "./identity.mjs";
 export { createBackendFederationLoadEntryPlugin } from "./plugin.mjs";
 export { createBackendFederationRuntime } from "./runtime.mjs";

package/dist/esm/backend-federation/load.mjs

@@ -1,21 +1,12 @@
-import { BACKEND_FEDERATION_EFFECT_EXPOSE } from "@modern-js/utils/universal";
-import { LEGACY_LOAD_WARNING } from "./legacy-warning.mjs";
+import { BACKEND_FEDERATION_EFFECT_EXPOSE } from "@modern-js/backend-federation-contracts";
 import { collectRemotes } from "./remotes.mjs";
 import { createBackendFederationRuntime } from "./runtime.mjs";
 import { normalizeExpose } from "./utils.mjs";
 import { validateLoadedBackendFederatedEffectApi } from "./validate-loaded.mjs";
-import * as __rspack_external_effect_Effect_41060786 from "effect/Effect";
-import * as __rspack_external_effect_Logger_1691a01b from "effect/Logger";
-const legacyWarningLogger = __rspack_external_effect_Logger_1691a01b.withLeveledConsole(__rspack_external_effect_Logger_1691a01b.formatLogFmt);
-function warnLegacyLoad() {
-    __rspack_external_effect_Effect_41060786.runSync(__rspack_external_effect_Effect_41060786.provideService(__rspack_external_effect_Effect_41060786.logWarning(LEGACY_LOAD_WARNING), __rspack_external_effect_Logger_1691a01b.CurrentLoggers, new Set([
-        legacyWarningLogger
-    ])));
-}
 function loadBackendFederatedEffectApi(options) {
     const remoteName = options.remote?.name ?? options.remoteName;
     if (void 0 === remoteName || 0 === remoteName.length) return Promise.reject(new Error('[BFF][Effect] Missing backend federation remote name.'));
-    if (void 0 === options.expected) warnLegacyLoad();
+    if (!options.expected?.unitId || !options.expected.buildMarker) return Promise.reject(new Error('[BFF][Effect] Backend federation requires expected.unitId and expected.buildMarker.'));
     if (void 0 !== options.runtime) {
         const configuredRemote = collectRemotes(options).find((remote)=>remote.name === remoteName);
         if (void 0 === configuredRemote || !/^(?:binding|service|static):/u.test(configuredRemote.entry)) return Promise.reject(new Error('[BFF][Effect] A custom Module Federation runtime requires a caller-pinned static or service-binding remote and cannot execute network backend federation entries.'));
@@ -25,7 +16,6 @@ function loadBackendFederatedEffectApi(options) {
     const expose = options.expose ?? options.remote?.expose ?? BACKEND_FEDERATION_EFFECT_EXPOSE;
     const remoteRequest = `${remoteName}/${normalizeExpose(expose)}`;
     return runtime.loadRemote(remoteRequest).then((loaded)=>validateLoadedBackendFederatedEffectApi(loaded, {
-            allowMissingIdentityMetadata: options.allowMissingIdentityMetadata,
             expected: options.expected,
             remoteName,
             remoteRequest

package/dist/esm/backend-federation/validate-loaded.mjs

@@ -7,10 +7,8 @@ function validateLoadedBackendFederatedEffectApi(loaded, options) {
     if ('effect' !== backendContract.runtimeFramework) throw new Error(`[BFF][Effect] Backend federation expose ${options.remoteRequest} must expose strict Effect metadata (runtimeFramework: "effect").`);
     if ('string' == typeof backendContract.name && backendContract.name !== options.remoteName) throw new Error(`[BFF][Effect] Backend federation expose ${options.remoteRequest} metadata name mismatch: expected ${options.remoteName}, received ${backendContract.name}.`);
     if (!('runtime' in loaded)) throw new Error(`[BFF][Effect] Backend federation expose ${options.remoteRequest} must expose runtime.`);
-    if (void 0 !== options.expected) {
-        const issues = validateExpectedBackendFederationIdentity(loaded, options.expected, {
-            allowMissingIdentityMetadata: true === options.allowMissingIdentityMetadata
-        });
+    {
+        const issues = validateExpectedBackendFederationIdentity(loaded, options.expected);
         if (issues.length > 0) throw new Error(`[BFF][Effect] Backend federation expose ${options.remoteRequest} delivery-unit identity mismatch: ${formatBackendFederationIdentityIssues(issues)}.`);
     }
     return loaded;

package/dist/esm/backend-federation-manifest/load.mjs

@@ -1,9 +1,11 @@
 import { BACKEND_FEDERATION_EFFECT_EXPOSE } from "../backend-federation/index.mjs";
 import { loadBackendFederatedEffectApi } from "../backend-federation/load.mjs";
 import { BackendFederationManifestAdapterError } from "./errors.mjs";
+import { backendFederationMetadata, manifestDeliveryUnit, stringValue, versionBoundaryMetadata } from "./metadata.mjs";
 import { loadBackendFederationManifest } from "./reference.mjs";
 import { resolveBackendFederationRemoteFromManifest } from "./remote.mjs";
 import { classifyLoadError, validateBackendFederationManifest, validateLoadedBackendFederationContract } from "./validation.mjs";
+const DEFAULT_SHARED_MANIFEST_LOAD_TIMEOUT_MS = 10000;
 function createManifestLoadScope(options) {
     const controller = new AbortController();
     const policyTimeouts = [
@@ -15,7 +17,8 @@ function createManifestLoadScope(options) {
         ...policyTimeouts
     ].filter((timeout)=>void 0 !== timeout);
     for (const timeout of configuredTimeouts)if (!Number.isSafeInteger(timeout) || timeout < 0) throw new BackendFederationManifestAdapterError('manifest_invalid', '[BFF][Effect] Backend federation timeoutMs must be a non-negative safe integer.');
-    const timeoutMs = options.timeoutMs ?? (policyTimeouts.length > 0 ? Math.min(...policyTimeouts) : 0);
+    const positivePolicyTimeouts = policyTimeouts.filter((timeout)=>timeout > 0);
+    const timeoutMs = options.timeoutMs ?? (0 === policyTimeouts.length ? DEFAULT_SHARED_MANIFEST_LOAD_TIMEOUT_MS : positivePolicyTimeouts.length > 0 ? Math.min(...positivePolicyTimeouts) : 0);
     const inputSignals = [
         options.signal,
         options.manifestPolicy?.signal,
@@ -69,6 +72,27 @@ function isCallerPinnedStaticRemote(options, remote) {
 function throwIfManifestLoadAborted(signal) {
     if (signal.aborted) throw new BackendFederationManifestAdapterError('remote_unavailable', '[BFF][Effect] Backend federation load was aborted before remote execution.', signal.reason);
 }
+function settleOnSharedAbort(promise, signal) {
+    if (signal.aborted) {
+        promise.catch(()=>{});
+        throwIfManifestLoadAborted(signal);
+    }
+    let onAbort;
+    const aborted = new Promise((_resolve, reject)=>{
+        onAbort = ()=>{
+            reject(new BackendFederationManifestAdapterError('remote_unavailable', '[BFF][Effect] Backend federation load was aborted before remote execution.', signal.reason));
+        };
+        signal.addEventListener('abort', onAbort, {
+            once: true
+        });
+    });
+    return Promise.race([
+        promise,
+        aborted
+    ]).finally(()=>{
+        if (onAbort) signal.removeEventListener('abort', onAbort);
+    });
+}
 async function loadBackendFederatedEffectApiFromManifest(options) {
     let manifest;
     let remote;
@@ -76,7 +100,7 @@ async function loadBackendFederatedEffectApiFromManifest(options) {
     try {
         scope = createManifestLoadScope(options);
         throwIfManifestLoadAborted(scope.signal);
-        manifest = await loadBackendFederationManifest({
+        manifest = await settleOnSharedAbort(loadBackendFederationManifest({
             ...options,
             manifestPolicy: {
                 ...options.manifestPolicy,
@@ -85,7 +109,7 @@ async function loadBackendFederatedEffectApiFromManifest(options) {
             },
             signal: scope.signal,
             timeoutMs: 0
-        });
+        }), scope.signal);
         validateBackendFederationManifest(manifest, options.expected);
         remote = resolveBackendFederationRemoteFromManifest(manifest, options.remote);
         throwIfManifestLoadAborted(scope.signal);
@@ -95,7 +119,11 @@ async function loadBackendFederatedEffectApiFromManifest(options) {
         if (remoteManifest && /^https?:\/\//iu.test(remote.entry) && !hasPinnedRemoteEntryExpectation(options)) throw new BackendFederationManifestAdapterError('manifest_invalid', `[BFF][Effect] Backend federation remote ${remote.name} from a network manifest requires caller-pinned entryUrl, remoteName, sha256, and byteLength values.`);
         if (/^https?:\/\//iu.test(remote.entry) && void 0 === remote.verification && options.entryPolicy?.expected === void 0) throw new BackendFederationManifestAdapterError('manifest_invalid', `[BFF][Effect] Backend federation remote ${remote.name} requires entry.sha256 and entry.byteLength before network execution.`);
         if (/^https?:\/\//iu.test(remote.entry) && void 0 !== options.runtime) throw new BackendFederationManifestAdapterError('manifest_invalid', `[BFF][Effect] Backend federation remote ${remote.name} cannot use a custom runtime for network entry execution.`);
-        const loaded = await loadBackendFederatedEffectApi({
+        const deliveryUnit = manifestDeliveryUnit(backendFederationMetadata(manifest), versionBoundaryMetadata(manifest));
+        const unitId = stringValue(deliveryUnit.boundary?.unitId) ?? stringValue(deliveryUnit.top?.unitId);
+        const buildMarker = stringValue(deliveryUnit.boundary?.buildMarker);
+        if (!unitId || !buildMarker) throw new BackendFederationManifestAdapterError('manifest_invalid', 'Backend federation manifest requires delivery-unit identity.');
+        const loaded = await settleOnSharedAbort(loadBackendFederatedEffectApi({
             hostName: options.hostName,
             remote,
             ...options.plugins ? {
@@ -109,16 +137,13 @@ async function loadBackendFederatedEffectApiFromManifest(options) {
             ...options.runtime ? {
                 runtime: options.runtime
             } : {},
-            ...options.expected?.unitId && options.expected.buildMarker ? {
-                expected: {
-                    unitId: options.expected.unitId,
-                    buildMarker: options.expected.buildMarker
-                },
-                allowMissingIdentityMetadata: true
-            } : {}
+            expected: {
+                unitId,
+                buildMarker
+            }
         }).catch((error)=>{
             throw new BackendFederationManifestAdapterError(scope?.timedOut() === true ? 'timeout' : classifyLoadError(error), `[BFF][Effect] Backend federation remote ${remote?.name ?? 'unknown'} could not load ${remote?.expose ?? BACKEND_FEDERATION_EFFECT_EXPOSE}.`, error);
-        });
+        }), scope.signal);
         validateLoadedBackendFederationContract(loaded, manifest, remote);
         return loaded;
     } catch (error) {

package/dist/esm/backend-federation-manifest/metadata.mjs

@@ -1,4 +1,4 @@
-import { backendFederationMetadata, backendFederationVersionBoundary } from "@modern-js/utils/universal";
+import { backendFederationMetadata, backendFederationVersionBoundary } from "@modern-js/backend-federation-contracts";
 function stringValue(value) {
     return 'string' == typeof value && value.length > 0 ? value : void 0;
 }

package/dist/esm/backend-federation-manifest/remote.mjs

@@ -1,5 +1,5 @@
+import { backendFederationExposeNames } from "@modern-js/backend-federation-contracts";
 import { BackendFederationRemoteEntryError, resolveBackendFederationRemoteEntryVerification } from "@modern-js/server-runtime-extensions/backend-federation-security";
-import { backendFederationExposeNames } from "@modern-js/utils/universal";
 import { BACKEND_FEDERATION_EFFECT_EXPOSE } from "../backend-federation/index.mjs";
 import { BackendFederationManifestAdapterError, assertManifestAdapter } from "./errors.mjs";
 import { backendFederationMetadata, recordField, resolveRemoteEntryFromMetadata, stringValue } from "./metadata.mjs";

package/dist/esm/backend-federation-manifest/validation.mjs

@@ -1,4 +1,4 @@
-import { formatBackendFederationValidationErrors, validateBackendFederationManifest } from "@modern-js/utils/universal";
+import { formatBackendFederationValidationErrors, validateBackendFederationManifest } from "@modern-js/backend-federation-contracts";
 import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from "../backend-federation/index.mjs";
 import { BackendFederationManifestAdapterError, assertConsistentValue, assertManifestAdapter, assertVersionValue } from "./errors.mjs";
 import { backendFederationMetadata, manifestDeliveryUnit, recordField, stringValue, versionBoundaryMetadata } from "./metadata.mjs";
@@ -16,8 +16,7 @@ function validation_validateBackendFederationManifest(manifest, expected = {}) {
     assertManifestAdapter(backendFederation, 'manifest_invalid', '[BFF][Effect] Backend federation manifest must declare backendFederation metadata.');
     const manifestShape = validateBackendFederationManifest(manifest, {
         expectedContractVersion: false,
-        expectedNodeAdapterVersion: false,
-        validateDeliveryUnit: false
+        expectedNodeAdapterVersion: false
     });
     assertManifestAdapter(manifestShape.ok, 'manifest_invalid', `[BFF][Effect] Backend federation manifest schema invalid: ${formatBackendFederationValidationErrors(manifestShape.errors)}.`);
     assertManifestAdapter('effect' === backendFederation.runtimeFramework, 'strict_effect_required', '[BFF][Effect] Backend federation manifest must declare runtimeFramework: "effect".');
@@ -35,6 +34,7 @@ function validation_validateBackendFederationManifest(manifest, expected = {}) {
     assertConsistentValue(stringValue(deliveryUnit.boundary?.buildMarker), stringValue(boundary?.buildVersion), 'versionBoundary.deliveryUnit.buildMarker vs versionBoundary.buildVersion');
     assertConsistentValue(stringValue(deliveryUnit.top?.unitId), stringValue(deliveryUnit.boundary?.unitId), 'backendFederation.deliveryUnit.unitId vs versionBoundary.deliveryUnit.unitId');
     const manifestUnitId = stringValue(deliveryUnit.boundary?.unitId) ?? stringValue(deliveryUnit.top?.unitId);
+    assertManifestAdapter(manifestUnitId && stringValue(deliveryUnit.boundary?.buildMarker), 'manifest_invalid', 'Backend federation manifest requires delivery-unit unitId and buildMarker.');
     assertVersionValue(manifestUnitId, expected.unitId, 'deliveryUnit.unitId');
     assertVersionValue(stringValue(deliveryUnit.boundary?.buildMarker), expectedBuildMarker, 'deliveryUnit.buildMarker');
 }
@@ -53,8 +53,8 @@ function validateLoadedBackendFederationContract(loaded, manifest, remote) {
     const deliveryUnit = manifestDeliveryUnit(backendFederation, boundary);
     const manifestUnitId = stringValue(deliveryUnit.boundary?.unitId) ?? stringValue(deliveryUnit.top?.unitId);
     const manifestBuildMarker = stringValue(deliveryUnit.boundary?.buildMarker);
-    assertConsistentValue(manifestUnitId, stringValue(compatibility.unitId), 'deliveryUnit.unitId vs expose compatibility.unitId');
-    assertConsistentValue(manifestBuildMarker, stringValue(compatibility.build), 'deliveryUnit.buildMarker vs expose compatibility.build');
+    assertVersionValue(stringValue(compatibility.unitId), manifestUnitId, 'deliveryUnit.unitId vs expose compatibility.unitId');
+    assertVersionValue(stringValue(compatibility.build), manifestBuildMarker, 'deliveryUnit.buildMarker vs expose compatibility.build');
 }
 function classifyLoadError(error) {
     const message = error instanceof Error ? error.message : String(error);

package/dist/esm/cross-project-policy/evaluation.mjs

@@ -1,4 +1,4 @@
-import { evaluateCrossProjectPolicy, resolveCrossProjectRequestObservation } from "@modern-js/bff-core/security/cross-project-policy";
+import { evaluateCrossProjectPolicy, resolveCrossProjectRequestObservation } from "@modern-js/server-runtime-extensions/bff-policy";
 const DENIAL_HEADERS = {
     'content-type': 'application/json; charset=utf-8'
 };

package/dist/esm/cross-project-policy/node.mjs

@@ -1,6 +1,7 @@
 import { readFileSync } from "node:fs";
 import node_path from "node:path";
-import { deriveOperationVersion, resolveCrossProjectPolicy } from "@modern-js/bff-core";
+import "@modern-js/server-runtime-extensions/server-config";
+import { deriveOperationVersion, resolveCrossProjectPolicy } from "@modern-js/server-runtime-extensions/bff-policy/node";
 const readNearestPackageVersion = (startDir)=>{
     if (!startDir) return;
     let current = node_path.resolve(startDir);

package/dist/esm/cross-project-policy/producer-runtime.mjs

@@ -0,0 +1,20 @@
+function createProducerClient(configure, { requestId }) {
+    return (options)=>configure({
+            requestId,
+            requireEnvelope: true,
+            ...options,
+            identityBinding: {
+                enabled: true,
+                strict: true,
+                ...options?.identityBinding
+            },
+            operationContract: {
+                enabled: true,
+                strict: true,
+                requireSchemaHash: true,
+                requireOperationVersion: true,
+                ...options?.operationContract
+            }
+        });
+}
+export { createProducerClient };

package/dist/esm/effect-adapter/entry.mjs

@@ -1,4 +1,5 @@
 import node_path from "node:path";
+import "@modern-js/server-runtime-extensions/server-config";
 import { API_DIR, findExists, fs, isProd } from "@modern-js/utils";
 const JS_OR_TS_EXTS = [
     '.js',

package/dist/esm/effect-adapter/index.mjs

@@ -1,4 +1,5 @@
 import node_path from "node:path";
+import "@modern-js/server-runtime-extensions/server-config";
 import { dispatchEffectBffRequest, resolveEffectBffModuleHandler, useEffectContext } from "@modern-js/bff-effect/effect";
 import { createDisposableServerRuntimeHandle, registerServerRuntimeDisposer } from "@modern-js/server-runtime-extensions/runtime-lifecycle";
 import { fs, isProd, logger } from "@modern-js/utils";
@@ -136,4 +137,7 @@ class EffectAdapter {
         this.api = api;
     }
 }
-export { EffectAdapter };
+const createRuntimeAdapters = (api)=>[
+        new EffectAdapter(api)
+    ];
+export { EffectAdapter, createRuntimeAdapters };

package/dist/esm/{client-generator → effect-source-loader}/built-entry.mjs

@@ -17,7 +17,7 @@ async function bundleBuiltEffectEntryForNode(options) {
     });
     const builtEntry = resolveBuiltEffectEntry(appDir, distDir, sourceEntry);
     if (void 0 === builtEntry || 0 === builtEntry.length) throw new Error(`Effect BFF entry was not emitted into ${distDir}: ${sourceEntry ?? upath.resolve(apiDir, 'index')}`);
-    const { bundleEffectEntryForNode } = await import("../effect-source-loader/loader.mjs");
+    const { bundleEffectEntryForNode } = await import("./loader.mjs");
     return bundleEffectEntryForNode({
         appDir,
         entryPath: builtEntry,

package/dist/esm/effect-source-loader/http-api-runtime.mjs

@@ -0,0 +1,19 @@
+import { extractHttpApiFromModule } from "@modern-js/bff-effect/effect";
+import { HttpApi } from "effect/unstable/httpapi";
+import { loadEffectSourceModule } from "./loader.mjs";
+function getHttpApiRuntime() {
+    return Promise.resolve({
+        isHttpApi: HttpApi.isHttpApi,
+        reflect: (api, handlers)=>{
+            if (!HttpApi.isHttpApi(api)) throw new TypeError('[BFF][Effect] Expected an HttpApi contract.');
+            HttpApi.reflect(api, {
+                onGroup: handlers.onGroup ?? (()=>{}),
+                onEndpoint: handlers.onEndpoint
+            });
+        }
+    });
+}
+function loadEffectApi(options) {
+    return getHttpApiRuntime().then((httpApiRuntime)=>loadEffectSourceModule(options).then((mod)=>extractHttpApiFromModule(mod, httpApiRuntime.isHttpApi)));
+}
+export { getHttpApiRuntime, loadEffectApi };

package/dist/esm/effect-source-loader/index.mjs

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

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

@@ -47,16 +47,18 @@ function preserveSourceModuleSemantics() {
         name: 'modern-js-effect-source-semantics',
         setup (buildApi) {
             buildApi.onLoad({
-                filter: /\.[cm]?[jt]sx?$/
+                filter: /\.[cm]?[jt]sx?$/,
+                namespace: 'file'
             }, async (args)=>{
                 const loader = sourceLoader(args);
                 if (!loader) return;
                 const source = await node_fs.promises.readFile(args.path, 'utf8');
+                const canonicalSourcePath = await node_fs.promises.realpath(args.path);
                 const compiled = await transform(source, {
                     define: {
-                        __dirname: JSON.stringify(node_path.dirname(args.path)),
-                        __filename: JSON.stringify(args.path),
-                        'import.meta.url': JSON.stringify(pathToFileURL(args.path).href)
+                        __dirname: JSON.stringify(node_path.dirname(canonicalSourcePath)),
+                        __filename: JSON.stringify(canonicalSourcePath),
+                        'import.meta.url': JSON.stringify(pathToFileURL(canonicalSourcePath).href)
                     },
                     jsx: 'automatic',
                     loader,
@@ -99,7 +101,6 @@ function isBareSpecifier(specifier) {
     return !specifier.startsWith('.') && !specifier.startsWith('/') && !node_path.isAbsolute(specifier);
 }
 function externalizeInstalledDependencies(options) {
-    const runtimeRequire = createRequire(node_path.join(options.runtimeResolveDir, '__modern_effect_entry.cjs'));
     return {
         name: 'modern-js-effect-installed-dependencies',
         setup (buildApi) {
@@ -139,28 +140,10 @@ function externalizeInstalledDependencies(options) {
                         },
                         resolveDir: options.runtimeResolveDir
                     });
-                    if (0 === runtimeResolution.errors.length && runtimeResolution.path) {
-                        if ('cjs' === options.format) {
-                            let requiredPath;
-                            try {
-                                requiredPath = runtimeRequire.resolve(args.path);
-                            } catch  {
-                                requiredPath = runtimeResolution.path;
-                            }
-                            if (await isEsmOnlyFile(requiredPath)) return {
-                                namespace: resolution.namespace,
-                                path: resolution.path,
-                                pluginData: resolution.pluginData,
-                                sideEffects: resolution.sideEffects,
-                                suffix: resolution.suffix,
-                                warnings: resolution.warnings
-                            };
-                        }
-                        return {
-                            external: true,
-                            path: args.path
-                        };
-                    }
+                    if (0 === runtimeResolution.errors.length && runtimeResolution.path) return {
+                        external: true,
+                        path: args.path
+                    };
                 }
                 return {
                     namespace: resolution.namespace,
@@ -188,7 +171,6 @@ async function bundleEffectEntryForNode(options) {
         platform: 'node',
         plugins: [
             externalizeInstalledDependencies({
-                format: options.format,
                 runtimeResolveDir: options.appDir
             }),
             preserveSourceModuleSemantics()
@@ -262,7 +244,6 @@ async function loadEffectSourceModule(options) {
         platform: 'node',
         plugins: [
             externalizeInstalledDependencies({
-                format: 'esm',
                 runtimeResolveDir: appDir
             }),
             preserveSourceModuleSemantics()

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

@@ -0,0 +1,45 @@
+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/effect-source-loader/rspack-loader.mjs

@@ -0,0 +1,35 @@
+import { realpathSync } from "node:fs";
+import { bundleEffectWorkerRuntimeSource, generateEffectWorkerRuntimeWrapper, resolveEffectEntryFile } from "./index.mjs";
+async function loader(source) {
+    this.cacheable();
+    delete require.cache[this.resourcePath];
+    const callback = this.async();
+    try {
+        const options = this.getOptions();
+        const entry = resolveEffectEntryFile(options);
+        if (!entry || realpathSync(entry) !== realpathSync(this.resourcePath)) throw new Error(`Unexpected Effect BFF loader resource: ${this.resourcePath}`);
+        const query = new URLSearchParams(this.resourceQuery);
+        if (query.has('modern-bff-runtime-source')) {
+            const { transform } = await import("@swc/core");
+            const transformed = await transform(source, {
+                filename: this.resourcePath,
+                sourceMaps: false,
+                jsc: {
+                    parser: {
+                        syntax: "typescript",
+                        tsx: /\.[jt]sx$/.test(this.resourcePath)
+                    },
+                    target: 'es2024'
+                },
+                module: {
+                    type: 'es6'
+                }
+            });
+            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 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)));
+    }
+}
+export default loader;

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

@@ -0,0 +1,23 @@
+import node_path from "node:path";
+import { build } from "esbuild";
+async function bundleEffectWorkerRuntimeSource(source, resourcePath, loader) {
+    const result = await build({
+        absWorkingDir: node_path.dirname(resourcePath),
+        bundle: true,
+        format: 'esm',
+        metafile: true,
+        packages: 'external',
+        platform: 'neutral',
+        stdin: {
+            contents: source,
+            loader: 'js',
+            resolveDir: node_path.dirname(resourcePath),
+            sourcefile: resourcePath
+        },
+        target: 'es2024',
+        write: false
+    });
+    for (const dependency of Object.keys(result.metafile.inputs))if ('<stdin>' !== dependency) loader.addDependency(node_path.resolve(node_path.dirname(resourcePath), dependency));
+    return result.outputFiles[0].text;
+}
+export { bundleEffectWorkerRuntimeSource };

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

@@ -1,56 +1,16 @@
+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 { createEffectBffEdgeDispatcher } from '@modern-js/plugin-bff/effect-edge/dispatcher';
-
-const __generatedOperationContracts = ${JSON.stringify(operationContracts)};
-
-const __mergeGeneratedOperationContracts = policy => {
-  if (
-    !policy ||
-    !policy.expectedOperationContracts ||
-    typeof policy.expectedOperationContracts !== 'object' ||
-    Array.isArray(policy.expectedOperationContracts)
-  ) {
-    return policy;
-  }
-  return {
-    ...policy,
-    expectedOperationContracts: {
-      ...policy.expectedOperationContracts,
-      ...__generatedOperationContracts,
-    },
-  };
-};
-
-export const __modern_create_effect_bff_dispatcher = options =>
-  createEffectBffEdgeDispatcher({
-    ...options,
-    crossProjectPolicy: __mergeGeneratedOperationContracts(
-      options?.crossProjectPolicy,
-    ),
-    module: effectBffModule,
-  });
+import { createEffectBffEdgeDispatcherFactory } from '@modern-js/bff-effect/effect-edge';
+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/esm/hono/cross-project-policy.mjs

@@ -5,6 +5,7 @@ const createHonoCrossProjectPolicyMiddleware = (policy, routePath)=>async functi
             routePath
         });
         if (denial) return denial;
-        return next();
+        const result = await next();
+        return result instanceof Response ? result : void 0;
     };
 export { createHonoCrossProjectPolicyMiddleware };