@bleedingdev/modern-js-plugin-bff 3.5.0-ultramodern.101 → 3.5.0-ultramodern.102

package/dist/cjs/cli/generator.js

@@ -130,16 +130,27 @@ const createBffGenerator = (api)=>{
         });
         const lambdaDir = apiRouter.getLambdaDir();
         const existLambda = apiRouter.isExistLambda();
+        const packageJson = utils_namespaceObject.fs.readJSONSync(external_path_default().resolve(appDirectory, 'package.json'));
+        const requestId = packageJson.name || process.env.npm_package_name;
+        const operationContracts = existLambda ? (0, bff_core_namespaceObject.buildOperationContractMap)({
+            handlers: await apiRouter.getApiHandlers(),
+            requestId,
+            operationVersion: (0, bff_core_namespaceObject.deriveOperationVersion)(packageJson.version)
+        }) : {};
         const runtime = bff?.runtimeCreateRequest || RUNTIME_CREATE_REQUEST;
         const relativeApiPath = external_path_default().relative(appDirectory, apiDirectory);
         const relativeLambdaPath = external_path_default().relative(appDirectory, lambdaDir);
+        const sourceEffectEntry = 'effect' === bffRuntimeFramework ? resolveEffectSourceEntry(appDirectory, apiDirectory, bff?.effect?.entry) : void 0;
+        const relativeEffectEntry = sourceEffectEntry ? external_path_default().relative(appDirectory, sourceEffectEntry).replace(/\.(?:[cm]?ts|tsx|jsx)$/u, '.js') : '';
         await pluginGenerator_js_default()({
             prefix,
             appDirectory,
             relativeDistPath,
             relativeApiPath,
             relativeLambdaPath,
-            runtimeFramework: 'hono' === bffRuntimeFramework ? 'hono' : 'effect'
+            runtimeFramework: 'hono' === bffRuntimeFramework ? 'hono' : 'effect',
+            relativeEffectEntry,
+            operationContracts
         });
         await clientGenerator_js_default()({
             prefix,

package/dist/cjs/cli.js

@@ -37,7 +37,8 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    bffPlugin: ()=>bffPlugin
+    bffPlugin: ()=>bffPlugin,
+    default: ()=>cli
 });
 const bff_core_namespaceObject = require("@modern-js/bff-core");
 const utils_namespaceObject = require("@modern-js/utils");
@@ -170,9 +171,12 @@ const bffPlugin = ()=>({
             });
         }
     });
+const cli = bffPlugin;
 exports.bffPlugin = __webpack_exports__.bffPlugin;
+exports["default"] = __webpack_exports__["default"];
 for(var __rspack_i in __webpack_exports__)if (-1 === [
-    "bffPlugin"
+    "bffPlugin",
+    "default"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true

package/dist/cjs/loader.js

@@ -46,6 +46,7 @@ var external_path_default = /*#__PURE__*/ __webpack_require__.n(external_path_na
 const effectClientGenerator_js_namespaceObject = require("./utils/effectClientGenerator.js");
 const EFFECT_BFF_WORKER_RUNTIME_QUERY = 'modern-bff-runtime';
 const EFFECT_BFF_WORKER_RUNTIME_SOURCE_QUERY = 'modern-bff-runtime-source';
+const createErrorModule = (message)=>`throw new Error(${JSON.stringify(message)});`;
 async function transformEffectRuntimeSource(source, filename) {
     const swc = await import("@swc/core");
     const result = await swc.transform(source, {
@@ -108,13 +109,13 @@ async function loader(source) {
             onDependency: (dependency)=>this.addDependency(dependency)
         });
         if (code) return void callback(void 0, code);
-        callback(void 0, `throw new Error('Failed to generate Effect client for ${resourcePath}')`);
+        callback(void 0, createErrorModule(`Failed to generate Effect client for ${resourcePath}`));
         return;
     }
     const warning = `The file ${resourcePath} is not allowed to be imported in src directory, only API definition files are allowed.`;
     if (!draftOptions.existLambda) {
         utils_namespaceObject.logger.warn(warning);
-        callback(null, `throw new Error('${warning}')`);
+        callback(null, createErrorModule(warning));
         return;
     }
     const options = {
@@ -131,14 +132,14 @@ async function loader(source) {
     const { lambdaDir } = draftOptions;
     if (!resourcePath.startsWith(lambdaDir)) {
         utils_namespaceObject.logger.warn(warning);
-        callback(null, `throw new Error('${warning}')`);
+        callback(null, createErrorModule(warning));
         return;
     }
     if (draftOptions.fetcher) options.fetcher = draftOptions.fetcher;
     if (draftOptions.requestCreator) options.requestCreator = draftOptions.requestCreator;
     options.requireResolve = require.resolve;
     const result = await (0, bff_core_namespaceObject.generateClient)(options);
-    callback(void 0, result.isOk ? result.value : `throw new Error('${result.value}')`);
+    callback(void 0, result.isOk ? result.value : createErrorModule(result.value));
 }
 const src_loader = loader;
 exports["default"] = __webpack_exports__["default"];

package/dist/cjs/runtime/effect/adapter/entry.js

@@ -64,24 +64,32 @@ function relativeAppPath(appDirectory, entryPath) {
     const relativePath = external_path_default().relative(appDirectory, entryPath);
     return '..' === relativePath || relativePath.startsWith(`..${external_path_default().sep}`) ? void 0 : relativePath;
 }
+function isDependencyPath(relativePath) {
+    return relativePath?.split(/[\\/]/u).includes('node_modules') ?? false;
+}
 function resolveEffectAdapterEntryFile(api) {
     const { appDirectory, apiDirectory, distDirectory } = api.getServerContext();
     const appRoot = external_path_default().resolve(appDirectory || process.cwd());
-    const productionRoot = (0, utils_namespaceObject.isProd)() && distDirectory ? distDirectory : void 0;
+    const productionRoot = (0, utils_namespaceObject.isProd)() && distDirectory ? external_path_default().resolve(distDirectory) : void 0;
     const bffConfig = api.getServerConfig()?.bff;
     const configuredEntry = bffConfig?.effect?.entry;
     if (configuredEntry) {
         const sourceEntry = external_path_default().isAbsolute(configuredEntry) ? configuredEntry : external_path_default().resolve(appRoot, configuredEntry);
         if (productionRoot) {
             const relativeEntry = relativeAppPath(appRoot, sourceEntry);
+            if (void 0 === relativeEntry || isDependencyPath(relativeEntry)) return resolveJsOrTsEntry(sourceEntry);
             return relativeEntry ? resolveJsOrTsEntry(builtEntryPath(external_path_default().resolve(productionRoot, relativeEntry))) : void 0;
         }
         return resolveJsOrTsEntry(sourceEntry);
     }
-    const relativeApiDirectory = apiDirectory ? external_path_default().isAbsolute(apiDirectory) ? relativeAppPath(appRoot, apiDirectory) : apiDirectory : utils_namespaceObject.API_DIR;
-    if (!relativeApiDirectory) return;
-    const apiRoot = external_path_default().resolve(productionRoot || appRoot, relativeApiDirectory);
-    return resolveJsOrTsEntry(external_path_default().resolve(apiRoot, 'index'));
+    const resolvedApiDirectory = external_path_default().resolve(appRoot, apiDirectory || utils_namespaceObject.API_DIR);
+    const productionApiDirectory = productionRoot ? void 0 !== relativeAppPath(productionRoot, resolvedApiDirectory) ? resolvedApiDirectory : (()=>{
+        const relativeApiDirectory = relativeAppPath(appRoot, resolvedApiDirectory);
+        if (isDependencyPath(relativeApiDirectory)) return resolvedApiDirectory;
+        return relativeApiDirectory ? external_path_default().resolve(productionRoot, relativeApiDirectory) : void 0;
+    })() : resolvedApiDirectory;
+    if (!productionApiDirectory) return;
+    return resolveJsOrTsEntry(external_path_default().resolve(productionApiDirectory, 'index'));
 }
 exports.resolveEffectAdapterEntryFile = __webpack_exports__.resolveEffectAdapterEntryFile;
 for(var __rspack_i in __webpack_exports__)if (-1 === [

package/dist/cjs/runtime/effect/handler/definition.js

@@ -49,6 +49,7 @@ function defineEffectBff(definition) {
             openapi: options?.openapi,
             rpc: mergedRpcOptions,
             dataPlatform: (0, external_envelope_js_namespaceObject.mergeDataPlatformOptions)(definition.dataPlatform, options?.dataPlatform),
+            interceptRequest: definition.interceptRequest,
             validateRequest: options?.validateRequest
         });
     };

package/dist/cjs/runtime/effect/handler/http.js

@@ -44,23 +44,30 @@ function createHttpApiHandler(options) {
     const openApiLayer = (0, external_openapi_js_namespaceObject.createOpenApiLayer)(options.api, options.openapi);
     const mergedLayer = openApiLayer ? Layer_namespaceObject.mergeAll(apiLayer, openApiLayer) : apiLayer;
     const httpApiHandler = http_namespaceObject.HttpRouter.toWebHandler(mergedLayer);
-    const withDataPlatformValidation = async (request, context)=>{
-        const policyDenial = options.validateRequest?.(request);
-        if (policyDenial) return policyDenial;
+    const dispatchHttpApiRequest = async (request, context)=>{
         const preparedRequest = await (0, external_batch_js_namespaceObject.prepareJsonRequestBody)(request);
         if (preparedRequest instanceof Response) return preparedRequest;
         const validationError = (0, external_envelope_js_namespaceObject.validateDataPlatformRequestEnvelope)(preparedRequest, options.dataPlatform);
         if (validationError) return validationError;
         return httpApiHandler.handler(preparedRequest, (0, external_types_js_namespaceObject.toEffectServiceContext)(context));
     };
+    const withRequestPolicy = async (request, context)=>{
+        const policyDenial = options.validateRequest?.(request);
+        if (policyDenial) return policyDenial;
+        const next = ()=>dispatchHttpApiRequest(request, context);
+        return options.interceptRequest ? options.interceptRequest({
+            request,
+            next
+        }) : next();
+    };
     const batchHandler = (0, external_batch_handler_js_namespaceObject.createDataPlatformBatchRequestHandler)({
         dataPlatform: options.dataPlatform,
-        handleItem: withDataPlatformValidation
+        handleItem: withRequestPolicy
     });
     const handleHttpApiRequest = async (request, context)=>{
         const pathname = (0, external_routing_js_namespaceObject.getRequestPathname)(request);
         if (batchHandler.enabled && pathname === batchHandler.path) return batchHandler.handle(request, context);
-        return withDataPlatformValidation(request, context);
+        return withRequestPolicy(request, context);
     };
     if (!options.rpc) return {
         handler: handleHttpApiRequest,
@@ -75,7 +82,11 @@ function createHttpApiHandler(options) {
             if ((0, external_routing_js_namespaceObject.isRpcRequest)(request, rpcPath)) {
                 const policyDenial = options.validateRequest?.(request);
                 if (policyDenial) return policyDenial;
-                return rpcHandler.handler(request, (0, external_types_js_namespaceObject.toEffectServiceContext)(context));
+                const next = ()=>rpcHandler.handler(request, (0, external_types_js_namespaceObject.toEffectServiceContext)(context));
+                return options.interceptRequest ? options.interceptRequest({
+                    request,
+                    next
+                }) : next();
             }
             return handleHttpApiRequest(request, context);
         },

package/dist/cjs/utils/crossProjectApiPlugin.js

@@ -39,7 +39,9 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     API_DIR: ()=>API_DIR,
     DIST_DIR: ()=>DIST_DIR,
+    EFFECT_ENTRY: ()=>EFFECT_ENTRY,
     LAMBDA_DIR: ()=>LAMBDA_DIR,
+    OPERATION_CONTRACTS_JSON: ()=>OPERATION_CONTRACTS_JSON,
     PACKAGE_NAME: ()=>PACKAGE_NAME,
     PREFIX: ()=>PREFIX,
     RUNTIME_FRAMEWORK: ()=>RUNTIME_FRAMEWORK,
@@ -54,6 +56,8 @@ const API_DIR = '{apiDirectory}';
 const LAMBDA_DIR = '{lambdaDirectory}';
 const DIST_DIR = '{distDirectory}';
 const RUNTIME_FRAMEWORK = '{runtimeFramework}';
+const EFFECT_ENTRY = '{effectEntry}';
+const OPERATION_CONTRACTS_JSON = '{operationContracts}';
 const NODE_MODULES = 'node_modules';
 const crossProjectApiPlugin = ()=>({
         name: '@modern-js/plugin-independent-bff',
@@ -65,7 +69,8 @@ const crossProjectApiPlugin = ()=>({
                 const { appDirectory: originAppDirectory } = api.getAppContext();
                 const sdkPath = external_path_default().join(originAppDirectory, NODE_MODULES, PACKAGE_NAME);
                 const sdkDistPath = external_path_default().join(sdkPath, DIST_DIR);
-                const apiDirectory = external_path_default().join(sdkDistPath, API_DIR);
+                const effectEntry = EFFECT_ENTRY ? external_path_default().join(sdkDistPath, EFFECT_ENTRY) : void 0;
+                const apiDirectory = effectEntry ? external_path_default().dirname(effectEntry) : external_path_default().join(sdkDistPath, API_DIR);
                 const lambdaDirectory = external_path_default().resolve(sdkDistPath, LAMBDA_DIR);
                 api.updateAppContext({
                     apiDirectory,
@@ -80,10 +85,16 @@ const crossProjectApiPlugin = ()=>({
                 }
                 const configuredRuntimeFramework = config?.bff?.runtimeFramework;
                 if (configuredRuntimeFramework && configuredRuntimeFramework !== RUNTIME_FRAMEWORK) throw new Error(`[${PACKAGE_NAME}] Runtime framework mismatch for cross-project BFF. Detected "${configuredRuntimeFramework}", but producer SDK requires "${RUNTIME_FRAMEWORK}".`);
+                resolvedConfig.bff ??= {};
                 resolvedConfig.bff.prefix = PREFIX;
                 resolvedConfig.bff.runtimeFramework = RUNTIME_FRAMEWORK;
+                if (EFFECT_ENTRY) resolvedConfig.bff.effect = {
+                    ...resolvedConfig.bff.effect,
+                    entry: effectEntry
+                };
                 resolvedConfig.bff.isCrossProjectServer = true;
                 resolvedConfig.bff.requestId = resolvedConfig.bff.requestId || config?.bff?.requestId || PACKAGE_NAME || 'default';
+                const generatedOperationContracts = "{operationContracts}" === OPERATION_CONTRACTS_JSON ? {} : JSON.parse(OPERATION_CONTRACTS_JSON);
                 resolvedConfig.bff.crossProjectPolicy = {
                     ...resolvedConfig.bff.crossProjectPolicy || {},
                     enabled: resolvedConfig.bff.crossProjectPolicy?.enabled ?? true,
@@ -92,7 +103,11 @@ const crossProjectApiPlugin = ()=>({
                     requireOperationContextDetails: resolvedConfig.bff.crossProjectPolicy?.requireOperationContextDetails ?? true,
                     requireOperationSchemaHash: resolvedConfig.bff.crossProjectPolicy?.requireOperationSchemaHash ?? true,
                     requireOperationVersion: resolvedConfig.bff.crossProjectPolicy?.requireOperationVersion ?? true,
-                    allowUnknownOperations: resolvedConfig.bff.crossProjectPolicy?.allowUnknownOperations ?? false
+                    allowUnknownOperations: resolvedConfig.bff.crossProjectPolicy?.allowUnknownOperations ?? false,
+                    expectedOperationContracts: {
+                        ...resolvedConfig.bff.crossProjectPolicy?.expectedOperationContracts || {},
+                        ...generatedOperationContracts
+                    }
                 };
                 return resolvedConfig;
             });
@@ -101,7 +116,9 @@ const crossProjectApiPlugin = ()=>({
 const utils_crossProjectApiPlugin = crossProjectApiPlugin;
 exports.API_DIR = __webpack_exports__.API_DIR;
 exports.DIST_DIR = __webpack_exports__.DIST_DIR;
+exports.EFFECT_ENTRY = __webpack_exports__.EFFECT_ENTRY;
 exports.LAMBDA_DIR = __webpack_exports__.LAMBDA_DIR;
+exports.OPERATION_CONTRACTS_JSON = __webpack_exports__.OPERATION_CONTRACTS_JSON;
 exports.PACKAGE_NAME = __webpack_exports__.PACKAGE_NAME;
 exports.PREFIX = __webpack_exports__.PREFIX;
 exports.RUNTIME_FRAMEWORK = __webpack_exports__.RUNTIME_FRAMEWORK;
@@ -110,7 +127,9 @@ exports["default"] = __webpack_exports__["default"];
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "API_DIR",
     "DIST_DIR",
+    "EFFECT_ENTRY",
     "LAMBDA_DIR",
+    "OPERATION_CONTRACTS_JSON",
     "PACKAGE_NAME",
     "PREFIX",
     "RUNTIME_FRAMEWORK",

package/dist/cjs/utils/effectSourceLoader.js

@@ -120,10 +120,29 @@ const nodeBuiltins = new Set([
     ...external_node_module_namespaceObject.builtinModules.map((name)=>`node:${name}`)
 ]);
 const dependencyResolutionMarker = 'modern-js-effect-dependency-resolution';
+async function isEsmOnlyFile(filename) {
+    const extension = external_node_path_default().extname(filename).toLowerCase();
+    if ('.mjs' === extension || '.mts' === extension) return true;
+    if ('.cjs' === extension || '.cts' === extension) return false;
+    let directory = external_node_path_default().dirname(filename);
+    while(true){
+        const packagePath = external_node_path_default().join(directory, 'package.json');
+        try {
+            const packageJson = JSON.parse(await external_node_fs_default().promises.readFile(packagePath, 'utf8'));
+            return 'module' === packageJson.type;
+        } catch (error) {
+            if (!error || 'object' != typeof error || !('code' in error) || 'ENOENT' !== error.code) throw error;
+        }
+        const parent = external_node_path_default().dirname(directory);
+        if (parent === directory) return false;
+        directory = parent;
+    }
+}
 function isBareSpecifier(specifier) {
     return !specifier.startsWith('.') && !specifier.startsWith('/') && !external_node_path_default().isAbsolute(specifier);
 }
-function externalizeInstalledDependencies() {
+function externalizeInstalledDependencies(options) {
+    const runtimeRequire = (0, external_node_module_namespaceObject.createRequire)(external_node_path_default().join(options.runtimeResolveDir, '__modern_effect_entry.cjs'));
     return {
         name: 'modern-js-effect-installed-dependencies',
         setup (buildApi) {
@@ -153,10 +172,41 @@ function externalizeInstalledDependencies() {
                     path: args.path
                 };
                 const realPath = await external_node_fs_default().promises.realpath(resolution.path).catch(()=>resolution.path);
-                if (realPath.includes(`${external_node_path_default().sep}node_modules${external_node_path_default().sep}`)) return {
-                    external: true,
-                    path: args.path
-                };
+                if (realPath.includes(`${external_node_path_default().sep}node_modules${external_node_path_default().sep}`)) {
+                    const runtimeResolution = await buildApi.resolve(args.path, {
+                        importer: '',
+                        kind: args.kind,
+                        namespace: 'file',
+                        pluginData: {
+                            [dependencyResolutionMarker]: true
+                        },
+                        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,
+                                watchDirs: resolution.watchDirs,
+                                watchFiles: resolution.watchFiles
+                            };
+                        }
+                        return {
+                            external: true,
+                            path: args.path
+                        };
+                    }
+                }
                 return {
                     namespace: resolution.namespace,
                     path: resolution.path,
@@ -184,7 +234,10 @@ async function bundleEffectEntryForNode(options) {
         outfile: options.entryPath,
         platform: 'node',
         plugins: [
-            externalizeInstalledDependencies(),
+            externalizeInstalledDependencies({
+                format: options.format,
+                runtimeResolveDir: options.appDir
+            }),
             preserveSourceModuleSemantics()
         ],
         target: 'node20'
@@ -226,7 +279,10 @@ async function loadEffectSourceModule(options) {
         outfile: outputPath,
         platform: 'node',
         plugins: [
-            externalizeInstalledDependencies(),
+            externalizeInstalledDependencies({
+                format: 'esm',
+                runtimeResolveDir: appDir
+            }),
             preserveSourceModuleSemantics()
         ],
         sourcemap: 'inline',

package/dist/cjs/utils/pluginGenerator.js

@@ -43,18 +43,18 @@ const utils_namespaceObject = require("@modern-js/utils");
 const external_path_namespaceObject = require("path");
 var external_path_default = /*#__PURE__*/ __webpack_require__.n(external_path_namespaceObject);
 const external_crossProjectApiPlugin_js_namespaceObject = require("./crossProjectApiPlugin.js");
-function replaceContent(source, packageName, prefix, relativeDistPath, relativeApiPath, relativeLambdaPath, runtimeFramework) {
-    const updatedSource = source.replace(new RegExp(external_crossProjectApiPlugin_js_namespaceObject.PACKAGE_NAME, 'g'), packageName).replace(new RegExp(external_crossProjectApiPlugin_js_namespaceObject.PREFIX, 'g'), prefix).replace(new RegExp(external_crossProjectApiPlugin_js_namespaceObject.DIST_DIR, 'g'), (0, utils_namespaceObject.normalizeToPosixPath)(relativeDistPath)).replace(new RegExp(external_crossProjectApiPlugin_js_namespaceObject.API_DIR, 'g'), (0, utils_namespaceObject.normalizeToPosixPath)(relativeApiPath)).replace(new RegExp(external_crossProjectApiPlugin_js_namespaceObject.LAMBDA_DIR, 'g'), (0, utils_namespaceObject.normalizeToPosixPath)(relativeLambdaPath)).replace(new RegExp(external_crossProjectApiPlugin_js_namespaceObject.RUNTIME_FRAMEWORK, 'g'), runtimeFramework);
+function replaceContent(source, packageName, prefix, relativeDistPath, relativeApiPath, relativeLambdaPath, runtimeFramework, relativeEffectEntry, operationContracts) {
+    const updatedSource = source.replace(new RegExp(external_crossProjectApiPlugin_js_namespaceObject.PACKAGE_NAME, 'g'), packageName).replace(new RegExp(external_crossProjectApiPlugin_js_namespaceObject.PREFIX, 'g'), prefix).replace(new RegExp(external_crossProjectApiPlugin_js_namespaceObject.DIST_DIR, 'g'), (0, utils_namespaceObject.normalizeToPosixPath)(relativeDistPath)).replace(new RegExp(external_crossProjectApiPlugin_js_namespaceObject.API_DIR, 'g'), (0, utils_namespaceObject.normalizeToPosixPath)(relativeApiPath)).replace(new RegExp(external_crossProjectApiPlugin_js_namespaceObject.LAMBDA_DIR, 'g'), (0, utils_namespaceObject.normalizeToPosixPath)(relativeLambdaPath)).replace(new RegExp(external_crossProjectApiPlugin_js_namespaceObject.RUNTIME_FRAMEWORK, 'g'), runtimeFramework).replace(new RegExp(external_crossProjectApiPlugin_js_namespaceObject.EFFECT_ENTRY, 'g'), (0, utils_namespaceObject.normalizeToPosixPath)(relativeEffectEntry)).replace(`'${external_crossProjectApiPlugin_js_namespaceObject.OPERATION_CONTRACTS_JSON}'`, ()=>JSON.stringify(JSON.stringify(operationContracts)));
     return updatedSource;
 }
-async function pluginGenerator({ prefix, appDirectory, relativeDistPath, relativeApiPath, relativeLambdaPath, runtimeFramework }) {
+async function pluginGenerator({ prefix, appDirectory, relativeDistPath, relativeApiPath, relativeLambdaPath, runtimeFramework, relativeEffectEntry, operationContracts }) {
     try {
         const packageContent = await utils_namespaceObject.fs.readFile(external_path_default().resolve(appDirectory, './package.json'), 'utf8');
         const packageJson = JSON.parse(packageContent);
         const pluginDir = external_path_default().resolve(appDirectory, `./${relativeDistPath}`, 'plugin');
         const pluginPath = external_path_default().join(pluginDir, 'index.js');
         const pluginTemplate = await utils_namespaceObject.fs.readFile(external_path_default().resolve(__dirname, 'crossProjectApiPlugin.js'), 'utf8');
-        const updatedPlugin = replaceContent(pluginTemplate, packageJson.name, prefix, relativeDistPath, relativeApiPath, relativeLambdaPath, runtimeFramework);
+        const updatedPlugin = replaceContent(pluginTemplate, packageJson.name, prefix, relativeDistPath, relativeApiPath, relativeLambdaPath, runtimeFramework, relativeEffectEntry, operationContracts);
         await utils_namespaceObject.fs.ensureFile(pluginPath);
         await utils_namespaceObject.fs.writeFile(pluginPath, updatedPlugin);
         const typeContent = `import type { AppTools, CliPlugin } from '@modern-js/app-tools';

package/dist/esm/cli/generator.mjs

@@ -1,4 +1,4 @@
-import { ApiRouter } from "@modern-js/bff-core";
+import { ApiRouter, buildOperationContractMap, deriveOperationVersion } from "@modern-js/bff-core";
 import { compile } from "@modern-js/server-utils";
 import { API_DIR, SHARED_DIR, fs, resolveServerTsconfig } from "@modern-js/utils";
 import path from "path";
@@ -85,16 +85,27 @@ const createBffGenerator = (api)=>{
         });
         const lambdaDir = apiRouter.getLambdaDir();
         const existLambda = apiRouter.isExistLambda();
+        const packageJson = fs.readJSONSync(path.resolve(appDirectory, 'package.json'));
+        const requestId = packageJson.name || process.env.npm_package_name;
+        const operationContracts = existLambda ? buildOperationContractMap({
+            handlers: await apiRouter.getApiHandlers(),
+            requestId,
+            operationVersion: deriveOperationVersion(packageJson.version)
+        }) : {};
         const runtime = bff?.runtimeCreateRequest || RUNTIME_CREATE_REQUEST;
         const relativeApiPath = path.relative(appDirectory, apiDirectory);
         const relativeLambdaPath = path.relative(appDirectory, lambdaDir);
+        const sourceEffectEntry = 'effect' === bffRuntimeFramework ? resolveEffectSourceEntry(appDirectory, apiDirectory, bff?.effect?.entry) : void 0;
+        const relativeEffectEntry = sourceEffectEntry ? path.relative(appDirectory, sourceEffectEntry).replace(/\.(?:[cm]?ts|tsx|jsx)$/u, '.js') : '';
         await pluginGenerator({
             prefix,
             appDirectory,
             relativeDistPath,
             relativeApiPath,
             relativeLambdaPath,
-            runtimeFramework: 'hono' === bffRuntimeFramework ? 'hono' : 'effect'
+            runtimeFramework: 'hono' === bffRuntimeFramework ? 'hono' : 'effect',
+            relativeEffectEntry,
+            operationContracts
         });
         await clientGenerator({
             prefix,

package/dist/esm/cli.mjs

@@ -128,4 +128,6 @@ const bffPlugin = ()=>({
             });
         }
     });
+const cli = bffPlugin;
+export default cli;
 export { bffPlugin };

package/dist/esm/loader.mjs

@@ -4,6 +4,7 @@ import path from "path";
 import { generateEffectClientCode, resolveEffectEntryFile } from "./utils/effectClientGenerator.mjs";
 const EFFECT_BFF_WORKER_RUNTIME_QUERY = 'modern-bff-runtime';
 const EFFECT_BFF_WORKER_RUNTIME_SOURCE_QUERY = 'modern-bff-runtime-source';
+const createErrorModule = (message)=>`throw new Error(${JSON.stringify(message)});`;
 async function transformEffectRuntimeSource(source, filename) {
     const swc = await import("@swc/core");
     const result = await swc.transform(source, {
@@ -66,13 +67,13 @@ async function loader(source) {
             onDependency: (dependency)=>this.addDependency(dependency)
         });
         if (code) return void callback(void 0, code);
-        callback(void 0, `throw new Error('Failed to generate Effect client for ${resourcePath}')`);
+        callback(void 0, createErrorModule(`Failed to generate Effect client for ${resourcePath}`));
         return;
     }
     const warning = `The file ${resourcePath} is not allowed to be imported in src directory, only API definition files are allowed.`;
     if (!draftOptions.existLambda) {
         logger.warn(warning);
-        callback(null, `throw new Error('${warning}')`);
+        callback(null, createErrorModule(warning));
         return;
     }
     const options = {
@@ -89,14 +90,14 @@ async function loader(source) {
     const { lambdaDir } = draftOptions;
     if (!resourcePath.startsWith(lambdaDir)) {
         logger.warn(warning);
-        callback(null, `throw new Error('${warning}')`);
+        callback(null, createErrorModule(warning));
         return;
     }
     if (draftOptions.fetcher) options.fetcher = draftOptions.fetcher;
     if (draftOptions.requestCreator) options.requestCreator = draftOptions.requestCreator;
     options.requireResolve = require.resolve;
     const result = await generateClient(options);
-    callback(void 0, result.isOk ? result.value : `throw new Error('${result.value}')`);
+    callback(void 0, result.isOk ? result.value : createErrorModule(result.value));
 }
 const src_loader = loader;
 export default src_loader;

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

@@ -22,23 +22,31 @@ function relativeAppPath(appDirectory, entryPath) {
     const relativePath = path.relative(appDirectory, entryPath);
     return '..' === relativePath || relativePath.startsWith(`..${path.sep}`) ? void 0 : relativePath;
 }
+function isDependencyPath(relativePath) {
+    return relativePath?.split(/[\\/]/u).includes('node_modules') ?? false;
+}
 function resolveEffectAdapterEntryFile(api) {
     const { appDirectory, apiDirectory, distDirectory } = api.getServerContext();
     const appRoot = path.resolve(appDirectory || process.cwd());
-    const productionRoot = isProd() && distDirectory ? distDirectory : void 0;
+    const productionRoot = isProd() && distDirectory ? path.resolve(distDirectory) : void 0;
     const bffConfig = api.getServerConfig()?.bff;
     const configuredEntry = bffConfig?.effect?.entry;
     if (configuredEntry) {
         const sourceEntry = path.isAbsolute(configuredEntry) ? configuredEntry : path.resolve(appRoot, configuredEntry);
         if (productionRoot) {
             const relativeEntry = relativeAppPath(appRoot, sourceEntry);
+            if (void 0 === relativeEntry || isDependencyPath(relativeEntry)) return resolveJsOrTsEntry(sourceEntry);
             return relativeEntry ? resolveJsOrTsEntry(builtEntryPath(path.resolve(productionRoot, relativeEntry))) : void 0;
         }
         return resolveJsOrTsEntry(sourceEntry);
     }
-    const relativeApiDirectory = apiDirectory ? path.isAbsolute(apiDirectory) ? relativeAppPath(appRoot, apiDirectory) : apiDirectory : API_DIR;
-    if (!relativeApiDirectory) return;
-    const apiRoot = path.resolve(productionRoot || appRoot, relativeApiDirectory);
-    return resolveJsOrTsEntry(path.resolve(apiRoot, 'index'));
+    const resolvedApiDirectory = 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 ? path.resolve(productionRoot, relativeApiDirectory) : void 0;
+    })() : resolvedApiDirectory;
+    if (!productionApiDirectory) return;
+    return resolveJsOrTsEntry(path.resolve(productionApiDirectory, 'index'));
 }
 export { resolveEffectAdapterEntryFile };

package/dist/esm/runtime/effect/handler/definition.mjs

@@ -16,6 +16,7 @@ function defineEffectBff(definition) {
             openapi: options?.openapi,
             rpc: mergedRpcOptions,
             dataPlatform: mergeDataPlatformOptions(definition.dataPlatform, options?.dataPlatform),
+            interceptRequest: definition.interceptRequest,
             validateRequest: options?.validateRequest
         });
     };

package/dist/esm/runtime/effect/handler/http.mjs

@@ -12,23 +12,30 @@ function createHttpApiHandler(options) {
     const openApiLayer = createOpenApiLayer(options.api, options.openapi);
     const mergedLayer = openApiLayer ? __rspack_external_effect_Layer_69c46453.mergeAll(apiLayer, openApiLayer) : apiLayer;
     const httpApiHandler = HttpRouter.toWebHandler(mergedLayer);
-    const withDataPlatformValidation = async (request, context)=>{
-        const policyDenial = options.validateRequest?.(request);
-        if (policyDenial) return policyDenial;
+    const dispatchHttpApiRequest = async (request, context)=>{
         const preparedRequest = await prepareJsonRequestBody(request);
         if (preparedRequest instanceof Response) return preparedRequest;
         const validationError = validateDataPlatformRequestEnvelope(preparedRequest, options.dataPlatform);
         if (validationError) return validationError;
         return httpApiHandler.handler(preparedRequest, toEffectServiceContext(context));
     };
+    const withRequestPolicy = async (request, context)=>{
+        const policyDenial = options.validateRequest?.(request);
+        if (policyDenial) return policyDenial;
+        const next = ()=>dispatchHttpApiRequest(request, context);
+        return options.interceptRequest ? options.interceptRequest({
+            request,
+            next
+        }) : next();
+    };
     const batchHandler = createDataPlatformBatchRequestHandler({
         dataPlatform: options.dataPlatform,
-        handleItem: withDataPlatformValidation
+        handleItem: withRequestPolicy
     });
     const handleHttpApiRequest = async (request, context)=>{
         const pathname = getRequestPathname(request);
         if (batchHandler.enabled && pathname === batchHandler.path) return batchHandler.handle(request, context);
-        return withDataPlatformValidation(request, context);
+        return withRequestPolicy(request, context);
     };
     if (!options.rpc) return {
         handler: handleHttpApiRequest,
@@ -43,7 +50,11 @@ function createHttpApiHandler(options) {
             if (isRpcRequest(request, rpcPath)) {
                 const policyDenial = options.validateRequest?.(request);
                 if (policyDenial) return policyDenial;
-                return rpcHandler.handler(request, toEffectServiceContext(context));
+                const next = ()=>rpcHandler.handler(request, toEffectServiceContext(context));
+                return options.interceptRequest ? options.interceptRequest({
+                    request,
+                    next
+                }) : next();
             }
             return handleHttpApiRequest(request, context);
         },

package/dist/esm/utils/crossProjectApiPlugin.mjs

@@ -5,6 +5,8 @@ const API_DIR = '{apiDirectory}';
 const LAMBDA_DIR = '{lambdaDirectory}';
 const DIST_DIR = '{distDirectory}';
 const RUNTIME_FRAMEWORK = '{runtimeFramework}';
+const EFFECT_ENTRY = '{effectEntry}';
+const OPERATION_CONTRACTS_JSON = '{operationContracts}';
 const NODE_MODULES = 'node_modules';
 const crossProjectApiPlugin = ()=>({
         name: '@modern-js/plugin-independent-bff',
@@ -16,7 +18,8 @@ const crossProjectApiPlugin = ()=>({
                 const { appDirectory: originAppDirectory } = api.getAppContext();
                 const sdkPath = path.join(originAppDirectory, NODE_MODULES, PACKAGE_NAME);
                 const sdkDistPath = path.join(sdkPath, DIST_DIR);
-                const apiDirectory = path.join(sdkDistPath, API_DIR);
+                const effectEntry = EFFECT_ENTRY ? path.join(sdkDistPath, EFFECT_ENTRY) : void 0;
+                const apiDirectory = effectEntry ? path.dirname(effectEntry) : path.join(sdkDistPath, API_DIR);
                 const lambdaDirectory = path.resolve(sdkDistPath, LAMBDA_DIR);
                 api.updateAppContext({
                     apiDirectory,
@@ -31,10 +34,16 @@ const crossProjectApiPlugin = ()=>({
                 }
                 const configuredRuntimeFramework = config?.bff?.runtimeFramework;
                 if (configuredRuntimeFramework && configuredRuntimeFramework !== RUNTIME_FRAMEWORK) throw new Error(`[${PACKAGE_NAME}] Runtime framework mismatch for cross-project BFF. Detected "${configuredRuntimeFramework}", but producer SDK requires "${RUNTIME_FRAMEWORK}".`);
+                resolvedConfig.bff ??= {};
                 resolvedConfig.bff.prefix = PREFIX;
                 resolvedConfig.bff.runtimeFramework = RUNTIME_FRAMEWORK;
+                if (EFFECT_ENTRY) resolvedConfig.bff.effect = {
+                    ...resolvedConfig.bff.effect,
+                    entry: effectEntry
+                };
                 resolvedConfig.bff.isCrossProjectServer = true;
                 resolvedConfig.bff.requestId = resolvedConfig.bff.requestId || config?.bff?.requestId || PACKAGE_NAME || 'default';
+                const generatedOperationContracts = "{operationContracts}" === OPERATION_CONTRACTS_JSON ? {} : JSON.parse(OPERATION_CONTRACTS_JSON);
                 resolvedConfig.bff.crossProjectPolicy = {
                     ...resolvedConfig.bff.crossProjectPolicy || {},
                     enabled: resolvedConfig.bff.crossProjectPolicy?.enabled ?? true,
@@ -43,7 +52,11 @@ const crossProjectApiPlugin = ()=>({
                     requireOperationContextDetails: resolvedConfig.bff.crossProjectPolicy?.requireOperationContextDetails ?? true,
                     requireOperationSchemaHash: resolvedConfig.bff.crossProjectPolicy?.requireOperationSchemaHash ?? true,
                     requireOperationVersion: resolvedConfig.bff.crossProjectPolicy?.requireOperationVersion ?? true,
-                    allowUnknownOperations: resolvedConfig.bff.crossProjectPolicy?.allowUnknownOperations ?? false
+                    allowUnknownOperations: resolvedConfig.bff.crossProjectPolicy?.allowUnknownOperations ?? false,
+                    expectedOperationContracts: {
+                        ...resolvedConfig.bff.crossProjectPolicy?.expectedOperationContracts || {},
+                        ...generatedOperationContracts
+                    }
                 };
                 return resolvedConfig;
             });
@@ -51,4 +64,4 @@ const crossProjectApiPlugin = ()=>({
     });
 const utils_crossProjectApiPlugin = crossProjectApiPlugin;
 export default utils_crossProjectApiPlugin;
-export { API_DIR, DIST_DIR, LAMBDA_DIR, PACKAGE_NAME, PREFIX, RUNTIME_FRAMEWORK, crossProjectApiPlugin };
+export { API_DIR, DIST_DIR, EFFECT_ENTRY, LAMBDA_DIR, OPERATION_CONTRACTS_JSON, PACKAGE_NAME, PREFIX, RUNTIME_FRAMEWORK, crossProjectApiPlugin };