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

package/dist/esm/utils/effectSourceLoader.mjs

@@ -1,6 +1,6 @@
 import node_crypto from "node:crypto";
 import node_fs from "node:fs";
-import { builtinModules } from "node:module";
+import { builtinModules, createRequire } from "node:module";
 import node_path from "node:path";
 import { pathToFileURL } from "node:url";
 import { build, transform } from "esbuild";
@@ -75,10 +75,29 @@ const nodeBuiltins = new Set([
     ...builtinModules.map((name)=>`node:${name}`)
 ]);
 const dependencyResolutionMarker = 'modern-js-effect-dependency-resolution';
+async function isEsmOnlyFile(filename) {
+    const extension = node_path.extname(filename).toLowerCase();
+    if ('.mjs' === extension || '.mts' === extension) return true;
+    if ('.cjs' === extension || '.cts' === extension) return false;
+    let directory = node_path.dirname(filename);
+    while(true){
+        const packagePath = node_path.join(directory, 'package.json');
+        try {
+            const packageJson = JSON.parse(await node_fs.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 = node_path.dirname(directory);
+        if (parent === directory) return false;
+        directory = parent;
+    }
+}
 function isBareSpecifier(specifier) {
     return !specifier.startsWith('.') && !specifier.startsWith('/') && !node_path.isAbsolute(specifier);
 }
-function externalizeInstalledDependencies() {
+function externalizeInstalledDependencies(options) {
+    const runtimeRequire = createRequire(node_path.join(options.runtimeResolveDir, '__modern_effect_entry.cjs'));
     return {
         name: 'modern-js-effect-installed-dependencies',
         setup (buildApi) {
@@ -108,10 +127,41 @@ function externalizeInstalledDependencies() {
                     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}`)) return {
-                    external: true,
-                    path: args.path
-                };
+                if (realPath.includes(`${node_path.sep}node_modules${node_path.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,
@@ -139,7 +189,10 @@ async function bundleEffectEntryForNode(options) {
         outfile: options.entryPath,
         platform: 'node',
         plugins: [
-            externalizeInstalledDependencies(),
+            externalizeInstalledDependencies({
+                format: options.format,
+                runtimeResolveDir: options.appDir
+            }),
             preserveSourceModuleSemantics()
         ],
         target: 'node20'
@@ -181,7 +234,10 @@ async function loadEffectSourceModule(options) {
         outfile: outputPath,
         platform: 'node',
         plugins: [
-            externalizeInstalledDependencies(),
+            externalizeInstalledDependencies({
+                format: 'esm',
+                runtimeResolveDir: appDir
+            }),
             preserveSourceModuleSemantics()
         ],
         sourcemap: 'inline',

package/dist/esm/utils/pluginGenerator.mjs

@@ -1,18 +1,18 @@
 import { fs, logger, normalizeToPosixPath } from "@modern-js/utils";
 import path from "path";
-import { API_DIR, DIST_DIR, LAMBDA_DIR, PACKAGE_NAME, PREFIX, RUNTIME_FRAMEWORK } from "./crossProjectApiPlugin.mjs";
-function replaceContent(source, packageName, prefix, relativeDistPath, relativeApiPath, relativeLambdaPath, runtimeFramework) {
-    const updatedSource = source.replace(new RegExp(PACKAGE_NAME, 'g'), packageName).replace(new RegExp(PREFIX, 'g'), prefix).replace(new RegExp(DIST_DIR, 'g'), normalizeToPosixPath(relativeDistPath)).replace(new RegExp(API_DIR, 'g'), normalizeToPosixPath(relativeApiPath)).replace(new RegExp(LAMBDA_DIR, 'g'), normalizeToPosixPath(relativeLambdaPath)).replace(new RegExp(RUNTIME_FRAMEWORK, 'g'), runtimeFramework);
+import { API_DIR, DIST_DIR, EFFECT_ENTRY, LAMBDA_DIR, OPERATION_CONTRACTS_JSON, PACKAGE_NAME, PREFIX, RUNTIME_FRAMEWORK } from "./crossProjectApiPlugin.mjs";
+function replaceContent(source, packageName, prefix, relativeDistPath, relativeApiPath, relativeLambdaPath, runtimeFramework, relativeEffectEntry, operationContracts) {
+    const updatedSource = source.replace(new RegExp(PACKAGE_NAME, 'g'), packageName).replace(new RegExp(PREFIX, 'g'), prefix).replace(new RegExp(DIST_DIR, 'g'), normalizeToPosixPath(relativeDistPath)).replace(new RegExp(API_DIR, 'g'), normalizeToPosixPath(relativeApiPath)).replace(new RegExp(LAMBDA_DIR, 'g'), normalizeToPosixPath(relativeLambdaPath)).replace(new RegExp(RUNTIME_FRAMEWORK, 'g'), runtimeFramework).replace(new RegExp(EFFECT_ENTRY, 'g'), normalizeToPosixPath(relativeEffectEntry)).replace(`'${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 fs.readFile(path.resolve(appDirectory, './package.json'), 'utf8');
         const packageJson = JSON.parse(packageContent);
         const pluginDir = path.resolve(appDirectory, `./${relativeDistPath}`, 'plugin');
         const pluginPath = path.join(pluginDir, 'index.js');
         const pluginTemplate = await fs.readFile(path.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 fs.ensureFile(pluginPath);
         await fs.writeFile(pluginPath, updatedPlugin);
         const typeContent = `import type { AppTools, CliPlugin } from '@modern-js/app-tools';

package/dist/esm-node/cli/generator.mjs

@@ -1,5 +1,5 @@
 import "node:module";
-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";
@@ -86,16 +86,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-node/cli.mjs

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

package/dist/esm-node/loader.mjs

@@ -6,6 +6,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, {
@@ -68,13 +69,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 = {
@@ -91,14 +92,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-node/runtime/effect/adapter/entry.mjs

@@ -23,23 +23,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-node/runtime/effect/handler/definition.mjs

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

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

@@ -13,23 +13,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,
@@ -44,7 +51,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-node/utils/crossProjectApiPlugin.mjs

@@ -6,6 +6,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',
@@ -17,7 +19,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,
@@ -32,10 +35,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,
@@ -44,7 +53,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;
             });
@@ -52,4 +65,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 };

package/dist/esm-node/utils/effectSourceLoader.mjs

@@ -1,7 +1,7 @@
 import "node:module";
 import node_crypto from "node:crypto";
 import node_fs from "node:fs";
-import { builtinModules } from "node:module";
+import { builtinModules, createRequire } from "node:module";
 import node_path from "node:path";
 import { pathToFileURL } from "node:url";
 import { build, transform } from "esbuild";
@@ -76,10 +76,29 @@ const nodeBuiltins = new Set([
     ...builtinModules.map((name)=>`node:${name}`)
 ]);
 const dependencyResolutionMarker = 'modern-js-effect-dependency-resolution';
+async function isEsmOnlyFile(filename) {
+    const extension = node_path.extname(filename).toLowerCase();
+    if ('.mjs' === extension || '.mts' === extension) return true;
+    if ('.cjs' === extension || '.cts' === extension) return false;
+    let directory = node_path.dirname(filename);
+    while(true){
+        const packagePath = node_path.join(directory, 'package.json');
+        try {
+            const packageJson = JSON.parse(await node_fs.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 = node_path.dirname(directory);
+        if (parent === directory) return false;
+        directory = parent;
+    }
+}
 function isBareSpecifier(specifier) {
     return !specifier.startsWith('.') && !specifier.startsWith('/') && !node_path.isAbsolute(specifier);
 }
-function externalizeInstalledDependencies() {
+function externalizeInstalledDependencies(options) {
+    const runtimeRequire = createRequire(node_path.join(options.runtimeResolveDir, '__modern_effect_entry.cjs'));
     return {
         name: 'modern-js-effect-installed-dependencies',
         setup (buildApi) {
@@ -109,10 +128,41 @@ function externalizeInstalledDependencies() {
                     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}`)) return {
-                    external: true,
-                    path: args.path
-                };
+                if (realPath.includes(`${node_path.sep}node_modules${node_path.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,
@@ -140,7 +190,10 @@ async function bundleEffectEntryForNode(options) {
         outfile: options.entryPath,
         platform: 'node',
         plugins: [
-            externalizeInstalledDependencies(),
+            externalizeInstalledDependencies({
+                format: options.format,
+                runtimeResolveDir: options.appDir
+            }),
             preserveSourceModuleSemantics()
         ],
         target: 'node20'
@@ -182,7 +235,10 @@ async function loadEffectSourceModule(options) {
         outfile: outputPath,
         platform: 'node',
         plugins: [
-            externalizeInstalledDependencies(),
+            externalizeInstalledDependencies({
+                format: 'esm',
+                runtimeResolveDir: appDir
+            }),
             preserveSourceModuleSemantics()
         ],
         sourcemap: 'inline',

package/dist/esm-node/utils/pluginGenerator.mjs

@@ -1,22 +1,22 @@
 import "node:module";
 import { fs, logger, normalizeToPosixPath } from "@modern-js/utils";
 import path from "path";
-import { API_DIR, DIST_DIR, LAMBDA_DIR, PACKAGE_NAME, PREFIX, RUNTIME_FRAMEWORK } from "./crossProjectApiPlugin.mjs";
+import { API_DIR, DIST_DIR, EFFECT_ENTRY, LAMBDA_DIR, OPERATION_CONTRACTS_JSON, PACKAGE_NAME, PREFIX, RUNTIME_FRAMEWORK } from "./crossProjectApiPlugin.mjs";
 import { fileURLToPath as __rspack_fileURLToPath } from "node:url";
 import { dirname as __rspack_dirname } from "node:path";
 var __rspack_import_meta_dirname__ = __rspack_dirname(__rspack_fileURLToPath(import.meta.url));
-function replaceContent(source, packageName, prefix, relativeDistPath, relativeApiPath, relativeLambdaPath, runtimeFramework) {
-    const updatedSource = source.replace(new RegExp(PACKAGE_NAME, 'g'), packageName).replace(new RegExp(PREFIX, 'g'), prefix).replace(new RegExp(DIST_DIR, 'g'), normalizeToPosixPath(relativeDistPath)).replace(new RegExp(API_DIR, 'g'), normalizeToPosixPath(relativeApiPath)).replace(new RegExp(LAMBDA_DIR, 'g'), normalizeToPosixPath(relativeLambdaPath)).replace(new RegExp(RUNTIME_FRAMEWORK, 'g'), runtimeFramework);
+function replaceContent(source, packageName, prefix, relativeDistPath, relativeApiPath, relativeLambdaPath, runtimeFramework, relativeEffectEntry, operationContracts) {
+    const updatedSource = source.replace(new RegExp(PACKAGE_NAME, 'g'), packageName).replace(new RegExp(PREFIX, 'g'), prefix).replace(new RegExp(DIST_DIR, 'g'), normalizeToPosixPath(relativeDistPath)).replace(new RegExp(API_DIR, 'g'), normalizeToPosixPath(relativeApiPath)).replace(new RegExp(LAMBDA_DIR, 'g'), normalizeToPosixPath(relativeLambdaPath)).replace(new RegExp(RUNTIME_FRAMEWORK, 'g'), runtimeFramework).replace(new RegExp(EFFECT_ENTRY, 'g'), normalizeToPosixPath(relativeEffectEntry)).replace(`'${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 fs.readFile(path.resolve(appDirectory, './package.json'), 'utf8');
         const packageJson = JSON.parse(packageContent);
         const pluginDir = path.resolve(appDirectory, `./${relativeDistPath}`, 'plugin');
         const pluginPath = path.join(pluginDir, 'index.js');
         const pluginTemplate = await fs.readFile(path.resolve(__rspack_import_meta_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 fs.ensureFile(pluginPath);
         await fs.writeFile(pluginPath, updatedPlugin);
         const typeContent = `import type { AppTools, CliPlugin } from '@modern-js/app-tools';

package/dist/types/cli.d.ts

@@ -1,2 +1,3 @@
 import type { AppTools, CliPlugin } from '@modern-js/app-tools';
 export declare const bffPlugin: () => CliPlugin<AppTools>;
+export default bffPlugin;

package/dist/types/runtime/effect/handler/definition.d.ts

@@ -1,17 +1,7 @@
 import type { HttpApi } from 'effect/unstable/httpapi';
 import type { Rpc } from 'effect/unstable/rpc';
-import type { EffectBffRuntime, EffectDataPlatformValidationOptions, EffectRpcBffDefinition, EffectRpcBffHandlerFactory, EffectRpcRuntimeLayer, EffectRuntimeLayer } from './types';
-export declare function defineEffectBff<TApi extends HttpApi.Constraint, TLayer extends EffectRuntimeLayer, TRpcs extends Rpc.Any = Rpc.Any>(definition: {
-    api: TApi;
-    layer: TLayer;
-    rpc?: EffectRpcBffDefinition<TRpcs>;
-    dataPlatform?: EffectDataPlatformValidationOptions;
-}): {
-    api: TApi;
-    layer: TLayer;
-    rpc?: EffectRpcBffDefinition<TRpcs>;
-    dataPlatform?: EffectDataPlatformValidationOptions;
-} & EffectBffRuntime<TApi, TLayer>;
+import type { EffectBffDefinition, EffectBffRuntime, EffectRpcBffDefinition, EffectRpcBffHandlerFactory, EffectRpcRuntimeLayer, EffectRuntimeLayer } from './types';
+export declare function defineEffectBff<TApi extends HttpApi.Constraint, TLayer extends EffectRuntimeLayer, TRpcs extends Rpc.Any = Rpc.Any>(definition: EffectBffDefinition<TApi, TLayer, TRpcs>): EffectBffDefinition<TApi, TLayer, TRpcs> & EffectBffRuntime<TApi, TLayer>;
 export declare function defineEffectRpcBff<TRpcs extends Rpc.Any = Rpc.Any, TLayer extends EffectRpcRuntimeLayer<TRpcs> = EffectRpcRuntimeLayer<TRpcs>>(definition: EffectRpcBffDefinition<TRpcs, TLayer>): EffectRpcBffDefinition<TRpcs, TLayer> & {
     createHandler: EffectRpcBffHandlerFactory<TRpcs>;
 };

package/dist/types/runtime/effect/handler/http.d.ts

@@ -1,12 +1,13 @@
 import type { HttpApi } from 'effect/unstable/httpapi';
 import type { Rpc } from 'effect/unstable/rpc';
-import type { EffectBffOpenApiConfig, EffectDataPlatformValidationOptions, EffectRequestValidator, EffectRpcBffDefinition, EffectRuntimeLayer } from './types';
+import type { EffectBffOpenApiConfig, EffectDataPlatformValidationOptions, EffectRequestInterceptor, EffectRequestValidator, EffectRpcBffDefinition, EffectRuntimeLayer } from './types';
 export declare function createHttpApiHandler<TApi extends HttpApi.Constraint = HttpApi.Top, TRpcs extends Rpc.Any = Rpc.Any>(options: {
     api: TApi;
     layer: EffectRuntimeLayer;
     openapi?: EffectBffOpenApiConfig;
     rpc?: EffectRpcBffDefinition<TRpcs>;
     dataPlatform?: EffectDataPlatformValidationOptions;
+    interceptRequest?: EffectRequestInterceptor;
     validateRequest?: EffectRequestValidator;
 }): {
     handler: (request: Request, context?: Parameters<(request: globalThis.Request, context: import("effect/Context").Context<unknown>) => Promise<Response>>[1]) => Promise<Response>;

package/dist/types/runtime/effect/handler/types.d.ts

@@ -35,6 +35,7 @@ export type EffectBffDefinition<TApi extends HttpApi.Constraint = HttpApi.Top, T
     layer: TLayer;
     rpc?: EffectRpcBffDefinition<TRpcs>;
     dataPlatform?: EffectDataPlatformValidationOptions;
+    interceptRequest?: EffectRequestInterceptor;
 };
 export type EffectDataPlatformSelectionValidationOptions = {
     maxDepth?: number;
@@ -131,6 +132,10 @@ export type EffectDataPlatformValidationOptions = {
  * cannot bypass it.
  */
 export type EffectRequestValidator = (request: Request) => Response | null | undefined;
+export type EffectRequestInterceptor = (options: {
+    request: Request;
+    next: () => Promise<Response>;
+}) => Response | Promise<Response>;
 export type EffectBffHandlerFactory<TApi extends HttpApi.Constraint = HttpApi.Top, TLayer extends EffectRuntimeLayer = EffectRuntimeLayer> = (options?: {
     openapi?: EffectBffOpenApiConfig;
     rpc?: Partial<EffectRpcBffHandlerOptions>;

package/dist/types/utils/crossProjectApiPlugin.d.ts

@@ -5,5 +5,7 @@ export declare const API_DIR = "{apiDirectory}";
 export declare const LAMBDA_DIR = "{lambdaDirectory}";
 export declare const DIST_DIR = "{distDirectory}";
 export declare const RUNTIME_FRAMEWORK: string;
+export declare const EFFECT_ENTRY = "{effectEntry}";
+export declare const OPERATION_CONTRACTS_JSON = "{operationContracts}";
 export declare const crossProjectApiPlugin: () => CliPlugin<AppTools>;
 export default crossProjectApiPlugin;

package/dist/types/utils/pluginGenerator.d.ts

@@ -1,9 +1,11 @@
-declare function pluginGenerator({ prefix, appDirectory, relativeDistPath, relativeApiPath, relativeLambdaPath, runtimeFramework, }: {
+declare function pluginGenerator({ prefix, appDirectory, relativeDistPath, relativeApiPath, relativeLambdaPath, runtimeFramework, relativeEffectEntry, operationContracts, }: {
     prefix: string;
     appDirectory: string;
     relativeDistPath: string;
     relativeApiPath: string;
     relativeLambdaPath: string;
     runtimeFramework: 'hono' | 'effect';
+    relativeEffectEntry: string;
+    operationContracts: Record<string, unknown>;
 }): Promise<void>;
 export default pluginGenerator;