@bleedingdev/modern-js-plugin-bff-extensions 3.9.0-ultramodern.10 → 3.9.0-ultramodern.12

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

@@ -5,6 +5,7 @@ import { backendFederationMetadata, manifestDeliveryUnit, stringValue, versionBo
 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 = [
@@ -16,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,
@@ -70,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;
@@ -77,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,
@@ -86,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);
@@ -100,7 +123,7 @@ async function loadBackendFederatedEffectApiFromManifest(options) {
         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 loadBackendFederatedEffectApi({
+        const loaded = await settleOnSharedAbort(loadBackendFederatedEffectApi({
             hostName: options.hostName,
             remote,
             ...options.plugins ? {
@@ -120,7 +143,7 @@ async function loadBackendFederatedEffectApiFromManifest(options) {
             }
         }).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/validation.mjs

@@ -1,7 +1,8 @@
 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 { backendFederationCompatibility, formatBackendFederationIdentityIssues, validateBackendFederationCompatibility } from "../backend-federation/identity.mjs";
 import { BackendFederationManifestAdapterError, assertConsistentValue, assertManifestAdapter, assertVersionValue } from "./errors.mjs";
-import { backendFederationMetadata, manifestDeliveryUnit, recordField, stringValue, versionBoundaryMetadata } from "./metadata.mjs";
+import { backendFederationMetadata, manifestDeliveryUnit, stringValue, versionBoundaryMetadata } from "./metadata.mjs";
 function resolveExpectedBuildMarker(expected) {
     if (void 0 !== expected.buildVersion && void 0 !== expected.buildMarker && expected.buildVersion !== expected.buildMarker) throw new BackendFederationManifestAdapterError('version_mismatch', `[BFF][Effect] Backend federation expected buildVersion/buildMarker mismatch: buildVersion ${expected.buildVersion}, buildMarker ${expected.buildMarker}.`, void 0, {
         label: 'expected.buildVersion/buildMarker',
@@ -42,19 +43,22 @@ function validateLoadedBackendFederationContract(loaded, manifest, remote) {
     const loadedContract = loaded.backendFederationContract;
     const backendFederation = backendFederationMetadata(manifest);
     const boundary = versionBoundaryMetadata(manifest);
-    const compatibility = recordField(loadedContract, 'compatibility');
+    const compatibility = backendFederationCompatibility(loaded);
     assertManifestAdapter(compatibility, 'version_mismatch', `[BFF][Effect] Backend federation expose ${remote.name}/${remote.expose?.replace(/^\.\//u, '')} must declare compatibility metadata.`);
     assertVersionValue(stringValue(loadedContract?.role), 'microvertical-server', 'expose role');
     assertVersionValue(stringValue(loadedContract?.name), remote.name, 'expose name');
-    assertVersionValue(stringValue(compatibility.contractVersion), stringValue(backendFederation?.contractVersion), 'expose contractVersion');
-    assertVersionValue(stringValue(compatibility.nodeAdapterVersion), stringValue(backendFederation?.nodeAdapterVersion), 'expose nodeAdapterVersion');
-    assertVersionValue(stringValue(compatibility.packageName), stringValue(boundary?.packageName), 'expose packageName');
-    assertVersionValue(stringValue(compatibility.build), stringValue(boundary?.buildVersion), 'expose buildVersion');
     const deliveryUnit = manifestDeliveryUnit(backendFederation, boundary);
     const manifestUnitId = stringValue(deliveryUnit.boundary?.unitId) ?? stringValue(deliveryUnit.top?.unitId);
     const manifestBuildMarker = stringValue(deliveryUnit.boundary?.buildMarker);
-    assertVersionValue(stringValue(compatibility.unitId), manifestUnitId, 'deliveryUnit.unitId vs expose compatibility.unitId');
-    assertVersionValue(stringValue(compatibility.build), manifestBuildMarker, 'deliveryUnit.buildMarker vs expose compatibility.build');
+    const issues = validateBackendFederationCompatibility(compatibility, {
+        contractVersion: stringValue(backendFederation?.contractVersion),
+        nodeAdapterVersion: stringValue(backendFederation?.nodeAdapterVersion),
+        packageName: stringValue(boundary?.packageName),
+        unitId: manifestUnitId,
+        build: manifestBuildMarker ?? stringValue(boundary?.buildVersion)
+    });
+    assertVersionValue(stringValue(compatibility.build), stringValue(boundary?.buildVersion), 'expose buildVersion');
+    assertManifestAdapter(0 === issues.length, 'version_mismatch', `[BFF][Effect] ${formatBackendFederationIdentityIssues(issues)}.`);
 }
 function classifyLoadError(error) {
     const message = error instanceof Error ? error.message : String(error);

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

@@ -1,29 +1,19 @@
-import { readFileSync } from "node:fs";
-import node_path from "node:path";
 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);
-    for(let depth = 0; depth < 10; depth += 1){
-        try {
-            const packageJson = JSON.parse(readFileSync(node_path.join(current, 'package.json'), 'utf8'));
-            if ('string' == typeof packageJson.version) return packageJson.version;
-        } catch  {}
-        const parent = node_path.dirname(current);
-        if (parent === current) break;
-        current = parent;
-    }
-};
-const resolveAdapterCrossProjectPolicy = (api, handlers)=>{
+import { resolveCrossProjectPolicy, resolveOperationProducer } from "@modern-js/server-runtime-extensions/bff-policy/node";
+const resolveAdapterCrossProjectPolicy = (api, handlers, producer)=>{
     const bff = api.getServerConfig()?.bff;
     const { apiDirectory, appDirectory } = api.getServerContext();
     return resolveCrossProjectPolicy({
         crossProjectPolicy: bff?.crossProjectPolicy,
         handlers,
-        requestId: bff?.requestId,
         isCrossProjectServer: bff?.isCrossProjectServer,
-        operationVersion: deriveOperationVersion(readNearestPackageVersion(apiDirectory) ?? readNearestPackageVersion(appDirectory))
+        ...producer ?? resolveOperationProducer({
+            directories: [
+                apiDirectory,
+                appDirectory
+            ],
+            requestId: bff?.requestId || 'default'
+        })
     });
 };
 export { resolveAdapterCrossProjectPolicy };

package/dist/esm/effect-adapter/cross-project-policy.mjs

@@ -2,7 +2,7 @@ import { collectEffectEndpoints, extractHttpApiFromModule, toOperationContractSo
 import { logger } from "@modern-js/utils";
 import { HttpApi } from "effect/unstable/httpapi";
 import { resolveAdapterCrossProjectPolicy } from "../cross-project-policy/index.mjs";
-function resolveEffectAdapterCrossProjectPolicy(api, prefix, mod) {
+function resolveEffectAdapterCrossProjectPolicy(api, prefix, mod, producer) {
     const contractSourcesPromise = null === mod ? Promise.resolve([]) : Promise.resolve().then(()=>extractHttpApiFromModule(mod, HttpApi.isHttpApi)).then((effectApi)=>{
         if (null === effectApi) return [];
         const reflect = (apiValue, handlers)=>{
@@ -18,7 +18,7 @@ function resolveEffectAdapterCrossProjectPolicy(api, prefix, mod) {
         return [];
     });
     return contractSourcesPromise.then((contractSources)=>{
-        const policy = resolveAdapterCrossProjectPolicy(api, contractSources);
+        const policy = resolveAdapterCrossProjectPolicy(api, contractSources, producer);
         if (policy?.enabled === true && 0 === contractSources.length) logger.warn('[BFF][Effect] Cross-project policy enabled but no HttpApi endpoints could be reflected; requests fail operation-contract matching unless allowUnknownOperations is enabled.');
         return policy;
     });

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

@@ -1,51 +1,15 @@
 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',
-    '.jsx',
-    '.ts',
-    '.tsx',
-    '.mjs',
-    '.mts',
-    '.cjs',
-    '.cts'
-];
-function resolveJsOrTsEntry(entryWithoutOrWithExt) {
-    const extension = node_path.extname(entryWithoutOrWithExt);
-    if (JS_OR_TS_EXTS.includes(extension)) return fs.existsSync(entryWithoutOrWithExt) ? entryWithoutOrWithExt : void 0;
-    return findExists(JS_OR_TS_EXTS.map((ext)=>`${entryWithoutOrWithExt}${ext}`)) || void 0;
-}
-function builtEntryPath(entryPath) {
-    return entryPath.replace(/\.(?:[cm]?ts|tsx|jsx)$/u, '.js');
-}
-function relativeAppPath(appDirectory, entryPath) {
-    const relativePath = node_path.relative(appDirectory, entryPath);
-    return '..' === relativePath || relativePath.startsWith(`..${node_path.sep}`) ? void 0 : relativePath;
-}
-function isDependencyPath(relativePath) {
-    return relativePath?.split(/[\\/]/u).includes('node_modules') ?? false;
-}
+import { API_DIR, isProd } from "@modern-js/utils";
+import { resolveEffectEntry } from "../effect-source-loader/paths.mjs";
 function resolveEffectAdapterEntryFile(api) {
     const { appDirectory, apiDirectory, distDirectory } = api.getServerContext();
-    const appRoot = node_path.resolve(appDirectory || process.cwd());
-    const productionRoot = isProd() && distDirectory ? node_path.resolve(distDirectory) : void 0;
-    const configuredEntry = api.getServerConfig()?.bff?.effect?.entry;
-    if (configuredEntry) {
-        const sourceEntry = node_path.isAbsolute(configuredEntry) ? configuredEntry : node_path.resolve(appRoot, configuredEntry);
-        if (productionRoot) {
-            const relativeEntry = relativeAppPath(appRoot, sourceEntry);
-            if (void 0 === relativeEntry || isDependencyPath(relativeEntry)) return resolveJsOrTsEntry(sourceEntry);
-            return relativeEntry ? resolveJsOrTsEntry(builtEntryPath(node_path.resolve(productionRoot, relativeEntry))) : void 0;
-        }
-        return resolveJsOrTsEntry(sourceEntry);
-    }
-    const resolvedApiDirectory = node_path.resolve(appRoot, apiDirectory || API_DIR);
-    const productionApiDirectory = productionRoot ? void 0 !== relativeAppPath(productionRoot, resolvedApiDirectory) ? resolvedApiDirectory : (()=>{
-        const relativeApiDirectory = relativeAppPath(appRoot, resolvedApiDirectory);
-        if (isDependencyPath(relativeApiDirectory)) return resolvedApiDirectory;
-        return relativeApiDirectory ? node_path.resolve(productionRoot, relativeApiDirectory) : void 0;
-    })() : resolvedApiDirectory;
-    return productionApiDirectory ? resolveJsOrTsEntry(node_path.resolve(productionApiDirectory, 'index')) : void 0;
+    const appDir = node_path.resolve(appDirectory || process.cwd());
+    return resolveEffectEntry({
+        appDir,
+        apiDir: node_path.resolve(appDir, apiDirectory || API_DIR),
+        effectEntry: api.getServerConfig()?.bff?.effect?.entry,
+        distDir: isProd() && distDirectory ? node_path.resolve(distDirectory) : void 0
+    }).path;
 }
 export { resolveEffectAdapterEntryFile };

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

@@ -1,6 +1,7 @@
 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 { resolveOperationProducer } from "@modern-js/server-runtime-extensions/bff-policy/node";
 import { createDisposableServerRuntimeHandle, registerServerRuntimeDisposer } from "@modern-js/server-runtime-extensions/runtime-lifecycle";
 import { fs, isProd, logger } from "@modern-js/utils";
 import { checkCrossProjectPolicyForRequest } from "../cross-project-policy/evaluation.mjs";
@@ -20,9 +21,9 @@ class EffectAdapter {
             this.handler = null;
             return;
         }
+        const { appDirectory } = this.api.getServerContext();
         let mod;
         try {
-            const { appDirectory } = this.api.getServerContext();
             mod = await (isProd() ? loadEffectBuiltModule(entryFile) : loadEffectSourceModule({
                 resourcePath: entryFile,
                 appDir: appDirectory || node_path.dirname(entryFile)
@@ -31,9 +32,16 @@ class EffectAdapter {
             logger.error(`[BFF][Effect] Failed to load Effect entry: ${entryFile}\n${String(error)}`);
             throw error;
         }
+        const producer = resolveOperationProducer({
+            directories: [
+                node_path.dirname(entryFile),
+                appDirectory
+            ],
+            requestId: this.api.getServerConfig()?.bff?.requestId
+        });
         const crossProjectPolicies = new Map(await Promise.all(this.prefixes.map(async (prefix)=>[
                 prefix,
-                await resolveEffectAdapterCrossProjectPolicy(this.api, prefix, mod)
+                await resolveEffectAdapterCrossProjectPolicy(this.api, prefix, mod, producer)
             ])));
         const effectConfig = this.api.getServerConfig()?.bff?.effect;
         const loaded = await resolveEffectBffModuleHandler(mod, {

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

@@ -1,11 +1,10 @@
 import { fs, upath } from "@modern-js/utils";
-import { resolveEffectEntryFile } from "./paths.mjs";
-const BUILT_ENTRY_EXT = /\.(?:[cm]?ts|tsx|jsx)$/u;
+import { emittedEffectEntry, relativeEffectAppPath, resolveEffectEntryFile } from "./paths.mjs";
 function resolveBuiltEffectEntry(appDirectory, distDirectory, sourceEntry) {
     if (void 0 === sourceEntry || 0 === sourceEntry.length) return;
-    const relativeEntry = upath.relative(appDirectory, sourceEntry);
-    if ('..' === relativeEntry || relativeEntry.startsWith(`..${upath.sep}`)) throw new Error(`Effect BFF entry must be inside the application directory: ${sourceEntry}`);
-    const builtEntry = upath.resolve(distDirectory, relativeEntry).replace(BUILT_ENTRY_EXT, '.js');
+    const relativeEntry = relativeEffectAppPath(appDirectory, sourceEntry);
+    if (void 0 === relativeEntry) throw new Error(`Effect BFF entry must be inside the application directory: ${sourceEntry}`);
+    const builtEntry = emittedEffectEntry(upath.resolve(distDirectory, relativeEntry));
     return fs.existsSync(builtEntry) ? builtEntry : void 0;
 }
 async function bundleBuiltEffectEntryForNode(options) {
@@ -31,7 +30,7 @@ function resolveEffectEntryPaths(options) {
         apiDir,
         effectEntry
     });
-    const relativeEffectEntry = void 0 !== sourceEffectEntry && sourceEffectEntry.length > 0 ? upath.relative(appDir, sourceEffectEntry).replace(BUILT_ENTRY_EXT, '.js') : '';
+    const relativeEffectEntry = void 0 !== sourceEffectEntry && sourceEffectEntry.length > 0 ? emittedEffectEntry(upath.relative(appDir, sourceEffectEntry)) : '';
     return {
         sourceEffectEntry,
         relativeEffectEntry

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

@@ -130,7 +130,8 @@ function externalizeInstalledDependencies(options) {
                     path: args.path
                 };
                 const realPath = await node_fs.promises.realpath(resolution.path).catch(()=>resolution.path);
-                if (realPath.includes(`${node_path.sep}node_modules${node_path.sep}`)) {
+                const loader = SOURCE_LOADERS.get(node_path.extname(realPath).toLowerCase());
+                if (realPath.includes(`${node_path.sep}node_modules${node_path.sep}`) && 'ts' !== loader && 'tsx' !== loader && 'jsx' !== loader) {
                     const runtimeResolution = await buildApi.resolve(args.path, {
                         importer: '',
                         kind: args.kind,

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

@@ -1,45 +1,22 @@
 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 { buildOperationContractMap, resolveOperationProducer } from "@modern-js/server-runtime-extensions/bff-policy/node";
+import { 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)
+        ...resolveOperationProducer({
+            directories: [
+                upath.dirname(options.resourcePath),
+                options.appDir
+            ],
+            requestId: options.requestId,
+            onDependency: options.onDependency
+        })
     });
 }
 export { resolveEffectOperationContracts };

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

@@ -9,16 +9,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/esm-node/backend-federation/identity.mjs

@@ -1,36 +1,31 @@
 import "node:module";
 import { isRecord } from "./utils.mjs";
-function validateExpectedBackendFederationIdentity(loaded, expected) {
-    const issues = [];
+function backendFederationCompatibility(loaded) {
     const contract = isRecord(loaded) ? loaded.backendFederationContract : void 0;
     const compatibility = isRecord(contract) ? contract.compatibility : void 0;
-    if (!isRecord(compatibility)) return [
+    return isRecord(compatibility) ? compatibility : void 0;
+}
+function validateBackendFederationCompatibility(compatibility, expected) {
+    return Object.entries(expected).flatMap(([field, value])=>void 0 === value || 'string' == typeof compatibility[field] && compatibility[field].length > 0 && compatibility[field] === value ? [] : [
+            {
+                path: `backendFederationContract.compatibility.${field}`,
+                message: `expected ${value}, received ${'string' == typeof compatibility[field] ? compatibility[field] : typeof compatibility[field]}`
+            }
+        ]);
+}
+function validateExpectedBackendFederationIdentity(loaded, expected) {
+    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'
         }
     ];
-    const unitId = compatibility.unitId;
-    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) 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}`
-    });
-    return issues;
 }
 function formatBackendFederationIdentityIssues(issues) {
     return issues.map((issue)=>`${issue.path}: ${issue.message}`).join('; ');
 }
-export { formatBackendFederationIdentityIssues, validateExpectedBackendFederationIdentity };
+export { backendFederationCompatibility, formatBackendFederationIdentityIssues, validateBackendFederationCompatibility, validateExpectedBackendFederationIdentity };

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

@@ -6,6 +6,7 @@ import { backendFederationMetadata, manifestDeliveryUnit, stringValue, versionBo
 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 = [
@@ -17,7 +18,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,
@@ -71,6 +73,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;
@@ -78,7 +101,7 @@ async function loadBackendFederatedEffectApiFromManifest(options) {
     try {
         scope = createManifestLoadScope(options);
         throwIfManifestLoadAborted(scope.signal);
-        manifest = await loadBackendFederationManifest({
+        manifest = await settleOnSharedAbort(loadBackendFederationManifest({
             ...options,
             manifestPolicy: {
                 ...options.manifestPolicy,
@@ -87,7 +110,7 @@ async function loadBackendFederatedEffectApiFromManifest(options) {
             },
             signal: scope.signal,
             timeoutMs: 0
-        });
+        }), scope.signal);
         validateBackendFederationManifest(manifest, options.expected);
         remote = resolveBackendFederationRemoteFromManifest(manifest, options.remote);
         throwIfManifestLoadAborted(scope.signal);
@@ -101,7 +124,7 @@ async function loadBackendFederatedEffectApiFromManifest(options) {
         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 loadBackendFederatedEffectApi({
+        const loaded = await settleOnSharedAbort(loadBackendFederatedEffectApi({
             hostName: options.hostName,
             remote,
             ...options.plugins ? {
@@ -121,7 +144,7 @@ async function loadBackendFederatedEffectApiFromManifest(options) {
             }
         }).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-node/backend-federation-manifest/validation.mjs

@@ -1,8 +1,9 @@
 import "node:module";
 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 { backendFederationCompatibility, formatBackendFederationIdentityIssues, validateBackendFederationCompatibility } from "../backend-federation/identity.mjs";
 import { BackendFederationManifestAdapterError, assertConsistentValue, assertManifestAdapter, assertVersionValue } from "./errors.mjs";
-import { backendFederationMetadata, manifestDeliveryUnit, recordField, stringValue, versionBoundaryMetadata } from "./metadata.mjs";
+import { backendFederationMetadata, manifestDeliveryUnit, stringValue, versionBoundaryMetadata } from "./metadata.mjs";
 function resolveExpectedBuildMarker(expected) {
     if (void 0 !== expected.buildVersion && void 0 !== expected.buildMarker && expected.buildVersion !== expected.buildMarker) throw new BackendFederationManifestAdapterError('version_mismatch', `[BFF][Effect] Backend federation expected buildVersion/buildMarker mismatch: buildVersion ${expected.buildVersion}, buildMarker ${expected.buildMarker}.`, void 0, {
         label: 'expected.buildVersion/buildMarker',
@@ -43,19 +44,22 @@ function validateLoadedBackendFederationContract(loaded, manifest, remote) {
     const loadedContract = loaded.backendFederationContract;
     const backendFederation = backendFederationMetadata(manifest);
     const boundary = versionBoundaryMetadata(manifest);
-    const compatibility = recordField(loadedContract, 'compatibility');
+    const compatibility = backendFederationCompatibility(loaded);
     assertManifestAdapter(compatibility, 'version_mismatch', `[BFF][Effect] Backend federation expose ${remote.name}/${remote.expose?.replace(/^\.\//u, '')} must declare compatibility metadata.`);
     assertVersionValue(stringValue(loadedContract?.role), 'microvertical-server', 'expose role');
     assertVersionValue(stringValue(loadedContract?.name), remote.name, 'expose name');
-    assertVersionValue(stringValue(compatibility.contractVersion), stringValue(backendFederation?.contractVersion), 'expose contractVersion');
-    assertVersionValue(stringValue(compatibility.nodeAdapterVersion), stringValue(backendFederation?.nodeAdapterVersion), 'expose nodeAdapterVersion');
-    assertVersionValue(stringValue(compatibility.packageName), stringValue(boundary?.packageName), 'expose packageName');
-    assertVersionValue(stringValue(compatibility.build), stringValue(boundary?.buildVersion), 'expose buildVersion');
     const deliveryUnit = manifestDeliveryUnit(backendFederation, boundary);
     const manifestUnitId = stringValue(deliveryUnit.boundary?.unitId) ?? stringValue(deliveryUnit.top?.unitId);
     const manifestBuildMarker = stringValue(deliveryUnit.boundary?.buildMarker);
-    assertVersionValue(stringValue(compatibility.unitId), manifestUnitId, 'deliveryUnit.unitId vs expose compatibility.unitId');
-    assertVersionValue(stringValue(compatibility.build), manifestBuildMarker, 'deliveryUnit.buildMarker vs expose compatibility.build');
+    const issues = validateBackendFederationCompatibility(compatibility, {
+        contractVersion: stringValue(backendFederation?.contractVersion),
+        nodeAdapterVersion: stringValue(backendFederation?.nodeAdapterVersion),
+        packageName: stringValue(boundary?.packageName),
+        unitId: manifestUnitId,
+        build: manifestBuildMarker ?? stringValue(boundary?.buildVersion)
+    });
+    assertVersionValue(stringValue(compatibility.build), stringValue(boundary?.buildVersion), 'expose buildVersion');
+    assertManifestAdapter(0 === issues.length, 'version_mismatch', `[BFF][Effect] ${formatBackendFederationIdentityIssues(issues)}.`);
 }
 function classifyLoadError(error) {
     const message = error instanceof Error ? error.message : String(error);

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

@@ -1,30 +1,20 @@
 import "node:module";
-import { readFileSync } from "node:fs";
-import node_path from "node:path";
 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);
-    for(let depth = 0; depth < 10; depth += 1){
-        try {
-            const packageJson = JSON.parse(readFileSync(node_path.join(current, 'package.json'), 'utf8'));
-            if ('string' == typeof packageJson.version) return packageJson.version;
-        } catch  {}
-        const parent = node_path.dirname(current);
-        if (parent === current) break;
-        current = parent;
-    }
-};
-const resolveAdapterCrossProjectPolicy = (api, handlers)=>{
+import { resolveCrossProjectPolicy, resolveOperationProducer } from "@modern-js/server-runtime-extensions/bff-policy/node";
+const resolveAdapterCrossProjectPolicy = (api, handlers, producer)=>{
     const bff = api.getServerConfig()?.bff;
     const { apiDirectory, appDirectory } = api.getServerContext();
     return resolveCrossProjectPolicy({
         crossProjectPolicy: bff?.crossProjectPolicy,
         handlers,
-        requestId: bff?.requestId,
         isCrossProjectServer: bff?.isCrossProjectServer,
-        operationVersion: deriveOperationVersion(readNearestPackageVersion(apiDirectory) ?? readNearestPackageVersion(appDirectory))
+        ...producer ?? resolveOperationProducer({
+            directories: [
+                apiDirectory,
+                appDirectory
+            ],
+            requestId: bff?.requestId || 'default'
+        })
     });
 };
 export { resolveAdapterCrossProjectPolicy };