@bleedingdev/modern-js-plugin-bff-build-extensions 0.0.0 → 3.9.0-ultramodern.6

package/dist/cjs/server-global-vars.js

@@ -0,0 +1,113 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    serializeServerGlobalVars: ()=>serializeServerGlobalVars,
+    transformServerGlobalVars: ()=>transformServerGlobalVars
+});
+const utils_namespaceObject = require("@modern-js/utils");
+const core_namespaceObject = require("@swc/core");
+const RELEASE_IDENTITY_GLOBAL_NAMES = [
+    'ULTRAMODERN_BUILD_MARKER',
+    'ULTRAMODERN_SOURCE_REVISION',
+    'ULTRAMODERN_RELEASE_VERSION'
+];
+const collectJavaScriptFiles = (directory)=>Promise.resolve().then(()=>utils_namespaceObject.fs.readdir(directory, {
+            withFileTypes: true
+        })).then((entries)=>Promise.all(entries.map((entry)=>{
+            const absolutePath = utils_namespaceObject.upath.join(directory, entry.name);
+            if (entry.isDirectory()) return collectJavaScriptFiles(absolutePath);
+            return /\.(?:c|m)?js$/u.test(entry.name) ? [
+                absolutePath
+            ] : [];
+        })).then((nested)=>nested.flat()));
+const serializeServerGlobalVars = (options)=>{
+    const globalVars = (0, utils_namespaceObject.applyOptionsChain)({}, options, {
+        env: 'server',
+        target: 'node'
+    });
+    return Object.fromEntries(Object.entries(globalVars).map(([key, value])=>{
+        let serialized;
+        try {
+            serialized = JSON.stringify(value);
+        } catch (error) {
+            throw new Error(`source.globalVars["${key}"] cannot be serialized exactly for BFF compilation.`, {
+                cause: error
+            });
+        }
+        if (void 0 === serialized) throw new Error(`source.globalVars["${key}"] cannot be serialized exactly for BFF compilation.`);
+        return [
+            key,
+            serialized
+        ];
+    }));
+};
+const transformServerGlobalVars = (outputDirectories, globalVars)=>Promise.resolve().then(()=>{
+        if (0 === Object.keys(globalVars).length) return;
+        return Promise.all(outputDirectories.map((directory)=>utils_namespaceObject.fs.pathExists(directory).then((directoryExists)=>directoryExists ? directory : void 0))).then((existingDirectories)=>{
+            const filesPromise = Promise.all(existingDirectories.filter((directory)=>void 0 !== directory).map(collectJavaScriptFiles)).then((files)=>files.flat());
+            const releaseIdentityBanner = RELEASE_IDENTITY_GLOBAL_NAMES.every((name)=>Object.hasOwn(globalVars, name)) ? `${RELEASE_IDENTITY_GLOBAL_NAMES.map((name)=>`void ${globalVars[name]};`).join('')}\n` : '';
+            return filesPromise.then((files)=>Promise.all(files.map((filename)=>utils_namespaceObject.fs.readFile(filename, 'utf8').then((source)=>{
+                        const sourceMapFilename = `${filename}.map`;
+                        return utils_namespaceObject.fs.pathExists(sourceMapFilename).then((sourceMapExists)=>{
+                            const inputSourceMapPromise = sourceMapExists ? utils_namespaceObject.fs.readFile(sourceMapFilename, 'utf8') : Promise.resolve(void 0);
+                            return inputSourceMapPromise.then((inputSourceMap)=>(0, core_namespaceObject.transform)(`${releaseIdentityBanner}${source}`, {
+                                    filename,
+                                    inputSourceMap,
+                                    sourceMaps: sourceMapExists,
+                                    jsc: {
+                                        parser: {
+                                            syntax: "ecmascript"
+                                        },
+                                        preserveAllComments: true,
+                                        target: 'es2024',
+                                        transform: {
+                                            optimizer: {
+                                                globals: {
+                                                    vars: globalVars
+                                                }
+                                            }
+                                        }
+                                    }
+                                }).then((result)=>utils_namespaceObject.fs.writeFile(filename, result.code).then(()=>{
+                                        if (sourceMapExists && void 0 !== result.map && result.map.length > 0) return utils_namespaceObject.fs.writeFile(sourceMapFilename, result.map);
+                                    })));
+                        });
+                    }))));
+        }).then(()=>void 0);
+    });
+exports.serializeServerGlobalVars = __webpack_exports__.serializeServerGlobalVars;
+exports.transformServerGlobalVars = __webpack_exports__.transformServerGlobalVars;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "serializeServerGlobalVars",
+    "transformServerGlobalVars"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/esm/client-artifacts.mjs

@@ -0,0 +1,53 @@
+import { ApiRouter } from "@modern-js/bff-core";
+import { buildOperationContractMap, deriveOperationVersion } from "@modern-js/server-runtime-extensions/bff-policy/node";
+import { fs, upath } from "@modern-js/utils";
+const BFF_REQUEST_RUNTIME = '@modern-js/runtime-extensions/request-policy';
+function registerBffClientArtifacts(api, metadata) {
+    api.modifyBffClientArtifacts(async (context)=>{
+        const { generation } = context;
+        const config = api.getNormalizedConfig();
+        if ('effect' === api.getAppContext().bffRuntimeFramework) {
+            const { resolveEffectOperationContracts, resolveEffectEntryPaths } = await import("@modern-js/plugin-bff-extensions/effect-source-loader");
+            const { sourceEffectEntry, relativeEffectEntry } = resolveEffectEntryPaths({
+                appDir: generation.appDirectory,
+                apiDir: generation.apiDirectory,
+                effectEntry: config.bff?.effect?.entry
+            });
+            if (!sourceEffectEntry) throw new Error(`Cannot resolve Effect BFF entry in ${generation.apiDirectory}.`);
+            const operationContracts = await resolveEffectOperationContracts({
+                appDir: generation.appDirectory,
+                resourcePath: sourceEffectEntry,
+                prefix: generation.prefix,
+                requestId: generation.requestId
+            });
+            if (null === operationContracts) throw new Error(`Cannot resolve exported Effect HttpApi in ${sourceEffectEntry}.`);
+            metadata.set(generation, {
+                runtimeFramework: 'effect',
+                relativeEffectEntry,
+                operationContracts
+            });
+        } else {
+            const router = new ApiRouter({
+                appDir: generation.appDirectory,
+                apiDir: generation.apiDirectory,
+                lambdaDir: generation.lambdaDirectory,
+                prefix: generation.prefix,
+                httpMethodDecider: generation.httpMethodDecider,
+                isBuild: true
+            });
+            const packageJson = await fs.readJSON(upath.join(generation.appDirectory, 'package.json'));
+            const operationContracts = generation.existLambda ? buildOperationContractMap({
+                handlers: await router.getApiHandlers(),
+                requestId: generation.requestId,
+                operationVersion: deriveOperationVersion(packageJson.version)
+            }) : {};
+            metadata.set(generation, {
+                runtimeFramework: 'hono',
+                relativeEffectEntry: '',
+                operationContracts
+            });
+        }
+        return context;
+    });
+}
+export { BFF_REQUEST_RUNTIME, registerBffClientArtifacts };

package/dist/esm/compile.mjs

@@ -0,0 +1,26 @@
+import { serializeServerGlobalVars, transformServerGlobalVars } from "./server-global-vars.mjs";
+function registerBffCompilation(api) {
+    const serialized = new WeakMap();
+    api.onBeforeBffCompile((context)=>{
+        serialized.set(context, serializeServerGlobalVars(api.getNormalizedConfig().source.globalVars));
+    });
+    api.onAfterBffCompile(async (context)=>{
+        const globals = serialized.get(context);
+        if (!globals) throw new Error('BFF compilation completed without its before hook.');
+        serialized.delete(context);
+        await transformServerGlobalVars([
+            ...context.outputDirectories
+        ], globals);
+        if ('effect' !== api.getAppContext().bffRuntimeFramework) return;
+        if (api.getNormalizedConfig().bff?.isCrossProjectServer === true) return;
+        const { bundleBuiltEffectEntryForNode } = await import("@modern-js/plugin-bff-extensions/effect-source-loader");
+        await bundleBuiltEffectEntryForNode({
+            appDir: context.appDirectory,
+            apiDir: context.apiDirectory,
+            distDir: context.distDirectory,
+            effectEntry: api.getNormalizedConfig().bff?.effect?.entry,
+            format: 'module' === context.moduleType ? 'esm' : 'cjs'
+        });
+    });
+}
+export { registerBffCompilation };

package/dist/esm/cross-project.mjs

@@ -0,0 +1,44 @@
+import "@modern-js/server-runtime-extensions/server-config";
+import node_path from "node:path";
+import { createCrossProjectApiPlugin } from "@modern-js/plugin-bff/cross-project";
+function createCrossProjectBffPlugin(descriptor) {
+    return createCrossProjectApiPlugin({
+        ...descriptor.native,
+        modifyResolvedConfig: (resolvedConfig, { sdkDistDirectory, api })=>{
+            const config = api.getConfig();
+            const configuredRuntimeFramework = config?.bff?.runtimeFramework;
+            if (configuredRuntimeFramework && configuredRuntimeFramework !== descriptor.runtimeFramework) throw new Error(`[${descriptor.native.packageName}] Runtime framework mismatch for cross-project BFF. Detected "${configuredRuntimeFramework}", but producer SDK requires "${descriptor.runtimeFramework}".`);
+            const effectEntry = descriptor.relativeEffectEntry ? node_path.join(sdkDistDirectory, descriptor.relativeEffectEntry) : void 0;
+            api.updateAppContext({
+                ...effectEntry ? {
+                    apiDirectory: node_path.dirname(effectEntry)
+                } : {},
+                bffRuntimeFramework: descriptor.runtimeFramework
+            });
+            resolvedConfig.bff ??= {};
+            resolvedConfig.bff.runtimeFramework = descriptor.runtimeFramework;
+            if (effectEntry) resolvedConfig.bff.effect = {
+                ...resolvedConfig.bff.effect,
+                entry: effectEntry
+            };
+            resolvedConfig.bff.requestId = resolvedConfig.bff.requestId || config?.bff?.requestId || descriptor.requestId || descriptor.native.packageName || 'default';
+            const policy = resolvedConfig.bff.crossProjectPolicy;
+            resolvedConfig.bff.crossProjectPolicy = {
+                ...policy,
+                enabled: policy?.enabled ?? true,
+                requireEnvelope: policy?.requireEnvelope ?? true,
+                requireOperationContext: policy?.requireOperationContext ?? true,
+                requireOperationContextDetails: policy?.requireOperationContextDetails ?? true,
+                requireOperationSchemaHash: policy?.requireOperationSchemaHash ?? true,
+                requireOperationVersion: policy?.requireOperationVersion ?? true,
+                allowUnknownOperations: policy?.allowUnknownOperations ?? false,
+                expectedOperationContracts: {
+                    ...policy?.expectedOperationContracts,
+                    ...descriptor.operationContracts
+                }
+            };
+            return resolvedConfig;
+        }
+    });
+}
+export { createCrossProjectBffPlugin };

package/dist/esm/generated-entries.mjs

@@ -0,0 +1,58 @@
+import { pathToFileURL } from "node:url";
+import { fs, upath } from "@modern-js/utils";
+import { BFF_REQUEST_RUNTIME } from "./client-artifacts.mjs";
+function registerBffGeneratedEntries(api, metadata) {
+    api.modifyBffGeneratedEntries(async (entries)=>{
+        const { generation } = entries;
+        const details = metadata.get(generation);
+        if (!details) throw new Error('BFF entries require completed operation contract collection.');
+        metadata.delete(generation);
+        const packageJson = await fs.readJSON(upath.join(generation.appDirectory, 'package.json'));
+        const runtimeSpecifier = api.getNormalizedConfig().bff?.runtimeCreateRequest || BFF_REQUEST_RUNTIME;
+        const dependencies = [
+            '@modern-js/plugin-bff-build-extensions',
+            '@modern-js/plugin-bff-extensions'
+        ];
+        const emitsClient = 'hono' === details.runtimeFramework && generation.apiFiles.length > 0;
+        if ('hono' === details.runtimeFramework && (runtimeSpecifier === BFF_REQUEST_RUNTIME || emitsClient && (generation.requestCreator || BFF_REQUEST_RUNTIME) === BFF_REQUEST_RUNTIME)) dependencies.push('@modern-js/runtime-extensions');
+        for (const name of dependencies){
+            const specifier = packageJson.dependencies?.[name] || packageJson.devDependencies?.[name] || fs.readJSONSync(require.resolve(`${name}/package.json`)).version;
+            entries.packageDependencies[name] = specifier;
+        }
+        const descriptor = {
+            native: {
+                packageName: packageJson.name,
+                prefix: generation.prefix,
+                relativeDistPath: upath.normalize(generation.relativeDistPath),
+                relativeApiPath: upath.relative(generation.appDirectory, generation.apiDirectory),
+                relativeLambdaPath: upath.relative(generation.appDirectory, generation.lambdaDirectory)
+            },
+            runtimeFramework: details.runtimeFramework,
+            relativeEffectEntry: details.relativeEffectEntry,
+            requestId: generation.requestId,
+            operationContracts: details.operationContracts
+        };
+        const isModule = 'module' === api.getAppContext().moduleType || 'module' === packageJson.type;
+        entries.plugin = {
+            code: isModule ? `import { createCrossProjectBffPlugin } from '@modern-js/plugin-bff-build-extensions/cross-project';\nexport const crossProjectApiPlugin = () => createCrossProjectBffPlugin(${JSON.stringify(descriptor)});\n` : `'use strict';\nconst { createCrossProjectBffPlugin } = require('@modern-js/plugin-bff-build-extensions/cross-project');\nexports.crossProjectApiPlugin = () => createCrossProjectBffPlugin(${JSON.stringify(descriptor)});\n`,
+            declaration: `import type { AppTools, CliPlugin } from '@modern-js/app-tools';
+export declare const crossProjectApiPlugin: () => CliPlugin<AppTools>;
+`
+        };
+        if ('effect' === details.runtimeFramework) {
+            entries.runtime = null;
+            return entries;
+        }
+        const runtime = JSON.stringify(runtimeSpecifier);
+        const esmRuntime = JSON.stringify(upath.isAbsolute(runtimeSpecifier) ? pathToFileURL(runtimeSpecifier).href : runtimeSpecifier);
+        entries.runtime = {
+            code: isModule ? `import { configure as _configure } from ${esmRuntime};\nimport { createProducerClient } from '@modern-js/plugin-bff-extensions/producer-runtime';\nexport const configure = createProducerClient(_configure, { requestId: ${JSON.stringify(generation.requestId)} });\nexport const initProducerClient = configure;\n` : `'use strict';\nconst { configure: _configure } = require(${runtime});\nconst { createProducerClient } = require('@modern-js/plugin-bff-extensions/producer-runtime');\nconst configure = createProducerClient(_configure, { requestId: ${JSON.stringify(generation.requestId)} });\nexports.configure = configure;\nexports.initProducerClient = configure;\n`,
+            declaration: `type Runtime = typeof import(${runtime});
+export declare const initProducerClient: (options?: Parameters<Runtime['configure']>[0]) => ReturnType<Runtime['configure']>;
+export declare const configure: typeof initProducerClient;
+`
+        };
+        return entries;
+    });
+}
+export { registerBffGeneratedEntries };

package/dist/esm/hono-client-codegen.mjs

@@ -0,0 +1,59 @@
+import node_path from "node:path";
+import { buildOperationContractMap, createOperationSchemaHash, deriveOperationVersion } from "@modern-js/server-runtime-extensions/bff-policy/node";
+const REQUEST_RUNTIME = '@modern-js/runtime-extensions/request-policy';
+const modifyClient = (draft, context)=>{
+    const { appDir, requestId } = context.options;
+    draft.requestCreator = context.options.requestCreator || REQUEST_RUNTIME;
+    let version;
+    try {
+        version = require(node_path.resolve(appDir, 'package.json')).version;
+    } catch  {}
+    const operationVersion = deriveOperationVersion(version);
+    const normalizedRequestId = requestId || 'default';
+    const operationContracts = buildOperationContractMap({
+        handlers: [
+            ...context.handlerInfos
+        ],
+        requestId: normalizedRequestId,
+        operationVersion
+    });
+    const operationEntries = context.handlerInfos.map((handlerInfo)=>{
+        const httpMethod = handlerInfo.httpMethod.toUpperCase();
+        return {
+            name: handlerInfo.name,
+            httpMethod,
+            routePath: handlerInfo.routePath,
+            schemaHash: operationContracts[`${httpMethod}:${handlerInfo.routePath}`]?.schemaHash ?? ''
+        };
+    }).sort((a, b)=>`${a.routePath}:${a.httpMethod}:${a.name}`.localeCompare(`${b.routePath}:${b.httpMethod}:${b.name}`));
+    const schemaHash = createOperationSchemaHash(operationEntries, normalizedRequestId);
+    for (const { handlerInfo, optionProperties } of draft.handlers){
+        if ('upload' === handlerInfo.action && !requestId) continue;
+        const method = handlerInfo.httpMethod.toUpperCase();
+        const operationContext = {
+            operationId: handlerInfo.name,
+            routePath: handlerInfo.routePath,
+            method,
+            schemaHash: operationContracts[`${method}:${handlerInfo.routePath}`]?.schemaHash ?? '',
+            operationVersion
+        };
+        optionProperties.push(`operationContext: ${JSON.stringify(operationContext)}`);
+    }
+    if (requestId) {
+        draft.imports.push(`import * as requestRuntime from ${JSON.stringify(draft.requestCreator)};`, 'import { createProducerClient } from "@modern-js/plugin-bff-extensions/producer-runtime";');
+        draft.statements.push(`export const initProducerClient = (options = {}) => {
+  const configure = requestRuntime.configure;
+  if (typeof configure !== 'function') {
+    console.warn('[modernjs] Compatibility request creator path does not expose configure(); use default @modern-js/create-request or migrate the compatibility path.');
+    return undefined;
+  }
+  return createProducerClient(configure, { requestId: ${JSON.stringify(requestId)} })(options);
+};`);
+    }
+    draft.statements.push(`export const operationVersion = ${String(operationVersion)};`, `export const operationSchemaHash = ${JSON.stringify(schemaHash)};`, `export const operationManifest = ${JSON.stringify({
+        operationVersion,
+        schemaHash,
+        operations: operationEntries
+    }, null, 2)};`);
+};
+export { modifyClient };

package/dist/esm/index.mjs

@@ -0,0 +1,89 @@
+import "@modern-js/server-runtime-extensions/server-config";
+import { bffPlugin } from "@modern-js/plugin-bff";
+import { fs, upath } from "@modern-js/utils";
+import { BFF_REQUEST_RUNTIME, registerBffClientArtifacts } from "./client-artifacts.mjs";
+import { registerBffCompilation } from "./compile.mjs";
+import { registerBffGeneratedEntries } from "./generated-entries.mjs";
+const src_bffPlugin = ()=>({
+        name: '@modern-js/plugin-bff-build-extensions',
+        usePlugins: [
+            bffPlugin()
+        ],
+        pre: [
+            '@modern-js/plugin-bff'
+        ],
+        setup: (api)=>{
+            const hooks = api.getHooks();
+            for (const name of [
+                'onBeforeBffCompile',
+                'onAfterBffCompile',
+                'modifyBffClientArtifacts',
+                'modifyBffGeneratedEntries'
+            ])if ('function' != typeof hooks[name]?.tap) throw new Error(`Native BFF build hook ${name} is unavailable.`);
+            api.config(()=>({
+                    bff: {
+                        requestCreator: BFF_REQUEST_RUNTIME,
+                        runtimeCreateRequest: BFF_REQUEST_RUNTIME,
+                        clientCodegenPlugin: require.resolve('@modern-js/plugin-bff-build-extensions/hono-client-codegen')
+                    }
+                }));
+            const runtimeFramework = api.getConfig()?.bff?.runtimeFramework;
+            if (void 0 !== runtimeFramework && 'hono' !== runtimeFramework && 'effect' !== runtimeFramework) throw new Error(`Unsupported Effect BFF runtime "${runtimeFramework}".`);
+            api.updateAppContext({
+                bffRuntimeFramework: runtimeFramework ?? 'effect'
+            });
+            api._internalServerPlugins(({ plugins })=>{
+                const nativePlugins = plugins.filter((plugin)=>'@modern-js/plugin-bff/server-plugin' === plugin.name);
+                if (1 !== nativePlugins.length) throw new Error('Expected exactly one native BFF server plugin.');
+                const native = nativePlugins[0];
+                const runtimeAdapters = native.options?.runtimeAdapters ?? {};
+                const effect = '@modern-js/plugin-bff-extensions/effect-adapter';
+                const honoRouteBinder = '@modern-js/plugin-bff-extensions/hono/node';
+                if (native.options?.honoRouteBinder !== void 0 && native.options.honoRouteBinder !== honoRouteBinder) throw new Error('The Hono BFF route binder is already configured.');
+                if (void 0 !== runtimeAdapters.effect && runtimeAdapters.effect !== effect) throw new Error('The Effect BFF runtime adapter is already configured.');
+                native.options = {
+                    ...native.options,
+                    honoRouteBinder,
+                    runtimeAdapters: {
+                        ...runtimeAdapters,
+                        effect
+                    }
+                };
+                return {
+                    plugins
+                };
+            });
+            const metadata = new WeakMap();
+            registerBffCompilation(api);
+            registerBffClientArtifacts(api, metadata);
+            registerBffGeneratedEntries(api, metadata);
+            api.modifyBundlerChain(async (chain, { CHAIN_ID })=>{
+                if ('effect' !== api.getAppContext().bffRuntimeFramework) return;
+                const { appDirectory, apiDirectory } = api.getAppContext();
+                const bff = api.getNormalizedConfig().bff;
+                if (!fs.existsSync(apiDirectory) && bff?.effect?.entry === void 0) return;
+                const { resolveEffectEntryFile } = await import("@modern-js/plugin-bff-extensions/effect-source-loader");
+                const entry = resolveEffectEntryFile({
+                    appDir: appDirectory,
+                    apiDir: apiDirectory,
+                    effectEntry: bff?.effect?.entry
+                });
+                if (!entry) throw new Error(`Cannot resolve Effect BFF entry in ${apiDirectory}.`);
+                const canonical = (file)=>upath.normalize(fs.existsSync(file) ? fs.realpathSync(file) : upath.resolve(file));
+                const entryPath = canonical(entry);
+                const isEntry = (resource)=>canonical(resource) === entryPath;
+                chain.module.rule(CHAIN_ID.RULE.JS).exclude.add(isEntry);
+                chain.module.rule('js-bff-api').exclude.add(isEntry);
+                chain.module.rule('js-bff-effect-entry').test(isEntry).use('effect-bff-loader').loader(require.resolve('@modern-js/plugin-bff-extensions/effect-source-loader/rspack-loader')).options({
+                    appDir: appDirectory,
+                    apiDir: apiDirectory,
+                    effectEntry: entry,
+                    prefix: Array.isArray(bff?.prefix) ? bff.prefix[0] : bff?.prefix || '/api',
+                    requestId: bff?.requestId
+                });
+            });
+        }
+    });
+const src = src_bffPlugin;
+export default src;
+export { src_bffPlugin as bffPlugin };

package/dist/esm/server-global-vars.mjs

@@ -0,0 +1,72 @@
+import { applyOptionsChain, fs, upath } from "@modern-js/utils";
+import { transform } from "@swc/core";
+const RELEASE_IDENTITY_GLOBAL_NAMES = [
+    'ULTRAMODERN_BUILD_MARKER',
+    'ULTRAMODERN_SOURCE_REVISION',
+    'ULTRAMODERN_RELEASE_VERSION'
+];
+const collectJavaScriptFiles = (directory)=>Promise.resolve().then(()=>fs.readdir(directory, {
+            withFileTypes: true
+        })).then((entries)=>Promise.all(entries.map((entry)=>{
+            const absolutePath = upath.join(directory, entry.name);
+            if (entry.isDirectory()) return collectJavaScriptFiles(absolutePath);
+            return /\.(?:c|m)?js$/u.test(entry.name) ? [
+                absolutePath
+            ] : [];
+        })).then((nested)=>nested.flat()));
+const serializeServerGlobalVars = (options)=>{
+    const globalVars = applyOptionsChain({}, options, {
+        env: 'server',
+        target: 'node'
+    });
+    return Object.fromEntries(Object.entries(globalVars).map(([key, value])=>{
+        let serialized;
+        try {
+            serialized = JSON.stringify(value);
+        } catch (error) {
+            throw new Error(`source.globalVars["${key}"] cannot be serialized exactly for BFF compilation.`, {
+                cause: error
+            });
+        }
+        if (void 0 === serialized) throw new Error(`source.globalVars["${key}"] cannot be serialized exactly for BFF compilation.`);
+        return [
+            key,
+            serialized
+        ];
+    }));
+};
+const transformServerGlobalVars = (outputDirectories, globalVars)=>Promise.resolve().then(()=>{
+        if (0 === Object.keys(globalVars).length) return;
+        return Promise.all(outputDirectories.map((directory)=>fs.pathExists(directory).then((directoryExists)=>directoryExists ? directory : void 0))).then((existingDirectories)=>{
+            const filesPromise = Promise.all(existingDirectories.filter((directory)=>void 0 !== directory).map(collectJavaScriptFiles)).then((files)=>files.flat());
+            const releaseIdentityBanner = RELEASE_IDENTITY_GLOBAL_NAMES.every((name)=>Object.hasOwn(globalVars, name)) ? `${RELEASE_IDENTITY_GLOBAL_NAMES.map((name)=>`void ${globalVars[name]};`).join('')}\n` : '';
+            return filesPromise.then((files)=>Promise.all(files.map((filename)=>fs.readFile(filename, 'utf8').then((source)=>{
+                        const sourceMapFilename = `${filename}.map`;
+                        return fs.pathExists(sourceMapFilename).then((sourceMapExists)=>{
+                            const inputSourceMapPromise = sourceMapExists ? fs.readFile(sourceMapFilename, 'utf8') : Promise.resolve(void 0);
+                            return inputSourceMapPromise.then((inputSourceMap)=>transform(`${releaseIdentityBanner}${source}`, {
+                                    filename,
+                                    inputSourceMap,
+                                    sourceMaps: sourceMapExists,
+                                    jsc: {
+                                        parser: {
+                                            syntax: "ecmascript"
+                                        },
+                                        preserveAllComments: true,
+                                        target: 'es2024',
+                                        transform: {
+                                            optimizer: {
+                                                globals: {
+                                                    vars: globalVars
+                                                }
+                                            }
+                                        }
+                                    }
+                                }).then((result)=>fs.writeFile(filename, result.code).then(()=>{
+                                        if (sourceMapExists && void 0 !== result.map && result.map.length > 0) return fs.writeFile(sourceMapFilename, result.map);
+                                    })));
+                        });
+                    }))));
+        }).then(()=>void 0);
+    });
+export { serializeServerGlobalVars, transformServerGlobalVars };

package/dist/esm-node/client-artifacts.mjs

@@ -0,0 +1,54 @@
+import "node:module";
+import { ApiRouter } from "@modern-js/bff-core";
+import { buildOperationContractMap, deriveOperationVersion } from "@modern-js/server-runtime-extensions/bff-policy/node";
+import { fs, upath } from "@modern-js/utils";
+const BFF_REQUEST_RUNTIME = '@modern-js/runtime-extensions/request-policy';
+function registerBffClientArtifacts(api, metadata) {
+    api.modifyBffClientArtifacts(async (context)=>{
+        const { generation } = context;
+        const config = api.getNormalizedConfig();
+        if ('effect' === api.getAppContext().bffRuntimeFramework) {
+            const { resolveEffectOperationContracts, resolveEffectEntryPaths } = await import("@modern-js/plugin-bff-extensions/effect-source-loader");
+            const { sourceEffectEntry, relativeEffectEntry } = resolveEffectEntryPaths({
+                appDir: generation.appDirectory,
+                apiDir: generation.apiDirectory,
+                effectEntry: config.bff?.effect?.entry
+            });
+            if (!sourceEffectEntry) throw new Error(`Cannot resolve Effect BFF entry in ${generation.apiDirectory}.`);
+            const operationContracts = await resolveEffectOperationContracts({
+                appDir: generation.appDirectory,
+                resourcePath: sourceEffectEntry,
+                prefix: generation.prefix,
+                requestId: generation.requestId
+            });
+            if (null === operationContracts) throw new Error(`Cannot resolve exported Effect HttpApi in ${sourceEffectEntry}.`);
+            metadata.set(generation, {
+                runtimeFramework: 'effect',
+                relativeEffectEntry,
+                operationContracts
+            });
+        } else {
+            const router = new ApiRouter({
+                appDir: generation.appDirectory,
+                apiDir: generation.apiDirectory,
+                lambdaDir: generation.lambdaDirectory,
+                prefix: generation.prefix,
+                httpMethodDecider: generation.httpMethodDecider,
+                isBuild: true
+            });
+            const packageJson = await fs.readJSON(upath.join(generation.appDirectory, 'package.json'));
+            const operationContracts = generation.existLambda ? buildOperationContractMap({
+                handlers: await router.getApiHandlers(),
+                requestId: generation.requestId,
+                operationVersion: deriveOperationVersion(packageJson.version)
+            }) : {};
+            metadata.set(generation, {
+                runtimeFramework: 'hono',
+                relativeEffectEntry: '',
+                operationContracts
+            });
+        }
+        return context;
+    });
+}
+export { BFF_REQUEST_RUNTIME, registerBffClientArtifacts };

package/dist/esm-node/compile.mjs

@@ -0,0 +1,27 @@
+import "node:module";
+import { serializeServerGlobalVars, transformServerGlobalVars } from "./server-global-vars.mjs";
+function registerBffCompilation(api) {
+    const serialized = new WeakMap();
+    api.onBeforeBffCompile((context)=>{
+        serialized.set(context, serializeServerGlobalVars(api.getNormalizedConfig().source.globalVars));
+    });
+    api.onAfterBffCompile(async (context)=>{
+        const globals = serialized.get(context);
+        if (!globals) throw new Error('BFF compilation completed without its before hook.');
+        serialized.delete(context);
+        await transformServerGlobalVars([
+            ...context.outputDirectories
+        ], globals);
+        if ('effect' !== api.getAppContext().bffRuntimeFramework) return;
+        if (api.getNormalizedConfig().bff?.isCrossProjectServer === true) return;
+        const { bundleBuiltEffectEntryForNode } = await import("@modern-js/plugin-bff-extensions/effect-source-loader");
+        await bundleBuiltEffectEntryForNode({
+            appDir: context.appDirectory,
+            apiDir: context.apiDirectory,
+            distDir: context.distDirectory,
+            effectEntry: api.getNormalizedConfig().bff?.effect?.entry,
+            format: 'module' === context.moduleType ? 'esm' : 'cjs'
+        });
+    });
+}
+export { registerBffCompilation };

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

@@ -0,0 +1,45 @@
+import "node:module";
+import "@modern-js/server-runtime-extensions/server-config";
+import node_path from "node:path";
+import { createCrossProjectApiPlugin } from "@modern-js/plugin-bff/cross-project";
+function createCrossProjectBffPlugin(descriptor) {
+    return createCrossProjectApiPlugin({
+        ...descriptor.native,
+        modifyResolvedConfig: (resolvedConfig, { sdkDistDirectory, api })=>{
+            const config = api.getConfig();
+            const configuredRuntimeFramework = config?.bff?.runtimeFramework;
+            if (configuredRuntimeFramework && configuredRuntimeFramework !== descriptor.runtimeFramework) throw new Error(`[${descriptor.native.packageName}] Runtime framework mismatch for cross-project BFF. Detected "${configuredRuntimeFramework}", but producer SDK requires "${descriptor.runtimeFramework}".`);
+            const effectEntry = descriptor.relativeEffectEntry ? node_path.join(sdkDistDirectory, descriptor.relativeEffectEntry) : void 0;
+            api.updateAppContext({
+                ...effectEntry ? {
+                    apiDirectory: node_path.dirname(effectEntry)
+                } : {},
+                bffRuntimeFramework: descriptor.runtimeFramework
+            });
+            resolvedConfig.bff ??= {};
+            resolvedConfig.bff.runtimeFramework = descriptor.runtimeFramework;
+            if (effectEntry) resolvedConfig.bff.effect = {
+                ...resolvedConfig.bff.effect,
+                entry: effectEntry
+            };
+            resolvedConfig.bff.requestId = resolvedConfig.bff.requestId || config?.bff?.requestId || descriptor.requestId || descriptor.native.packageName || 'default';
+            const policy = resolvedConfig.bff.crossProjectPolicy;
+            resolvedConfig.bff.crossProjectPolicy = {
+                ...policy,
+                enabled: policy?.enabled ?? true,
+                requireEnvelope: policy?.requireEnvelope ?? true,
+                requireOperationContext: policy?.requireOperationContext ?? true,
+                requireOperationContextDetails: policy?.requireOperationContextDetails ?? true,
+                requireOperationSchemaHash: policy?.requireOperationSchemaHash ?? true,
+                requireOperationVersion: policy?.requireOperationVersion ?? true,
+                allowUnknownOperations: policy?.allowUnknownOperations ?? false,
+                expectedOperationContracts: {
+                    ...policy?.expectedOperationContracts,
+                    ...descriptor.operationContracts
+                }
+            };
+            return resolvedConfig;
+        }
+    });
+}
+export { createCrossProjectBffPlugin };