@bleedingdev/modern-js-plugin-bff-build-extensions 3.9.0-ultramodern.9 → 3.9.3-ultramodern.10

package/dist/cjs/client-artifacts.js

@@ -33,7 +33,6 @@ __webpack_require__.d(__webpack_exports__, {
 });
 const bff_core_namespaceObject = require("@modern-js/bff-core");
 const node_namespaceObject = require("@modern-js/server-runtime-extensions/bff-policy/node");
-const utils_namespaceObject = require("@modern-js/utils");
 const BFF_REQUEST_RUNTIME = '@modern-js/runtime-extensions/request-policy';
 function registerBffClientArtifacts(api, metadata) {
     api.modifyBffClientArtifacts(async (context)=>{
@@ -51,7 +50,8 @@ function registerBffClientArtifacts(api, metadata) {
                 appDir: generation.appDirectory,
                 resourcePath: sourceEffectEntry,
                 prefix: generation.prefix,
-                requestId: generation.requestId
+                requestId: generation.requestId,
+                globalVars: config.source.globalVars
             });
             if (null === operationContracts) throw new Error(`Cannot resolve exported Effect HttpApi in ${sourceEffectEntry}.`);
             metadata.set(generation, {
@@ -68,11 +68,15 @@ function registerBffClientArtifacts(api, metadata) {
                 httpMethodDecider: generation.httpMethodDecider,
                 isBuild: true
             });
-            const packageJson = await utils_namespaceObject.fs.readJSON(utils_namespaceObject.upath.join(generation.appDirectory, 'package.json'));
             const operationContracts = generation.existLambda ? (0, node_namespaceObject.buildOperationContractMap)({
                 handlers: await router.getApiHandlers(),
-                requestId: generation.requestId,
-                operationVersion: (0, node_namespaceObject.deriveOperationVersion)(packageJson.version)
+                ...(0, node_namespaceObject.resolveOperationProducer)({
+                    directories: [
+                        generation.apiDirectory,
+                        generation.appDirectory
+                    ],
+                    requestId: generation.requestId || 'default'
+                })
             }) : {};
             metadata.set(generation, {
                 runtimeFramework: 'hono',

package/dist/cjs/compile.js

@@ -30,16 +30,29 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     registerBffCompilation: ()=>registerBffCompilation
 });
+const server_global_vars_namespaceObject = require("@modern-js/plugin-bff-extensions/server-global-vars");
 const external_server_global_vars_js_namespaceObject = require("./server-global-vars.js");
 function registerBffCompilation(api) {
     const serialized = new WeakMap();
     api.onBeforeBffCompile((context)=>{
-        serialized.set(context, (0, external_server_global_vars_js_namespaceObject.serializeServerGlobalVars)(api.getNormalizedConfig().source.globalVars));
+        serialized.set(context, (0, server_global_vars_namespaceObject.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);
+        const appContext = api.getAppContext();
+        const resolveIdentity = appContext.resolveBffRuntimeBuildIdentity;
+        if (true !== appContext.apiOnly && void 0 !== resolveIdentity) {
+            if (appContext.appDirectory !== context.appDirectory) throw new Error('BFF runtime build identity provider does not belong to this application.');
+            if ('function' != typeof resolveIdentity) throw new Error('BFF runtime build identity provider is invalid.');
+            const identity = await resolveIdentity(context);
+            if (null === identity || 'object' != typeof identity || !Object.isFrozen(identity)) throw new Error('BFF runtime build identity must be immutable.');
+            const { buildMarker, sourceRevision } = identity;
+            if ('string' != typeof buildMarker || !/^[0-9a-f]{64}$/u.test(buildMarker) || 'string' != typeof sourceRevision || 0 === sourceRevision.trim().length) throw new Error('BFF runtime build identity is not finalized.');
+            globals.ULTRAMODERN_BUILD_MARKER = JSON.stringify(buildMarker);
+            globals.ULTRAMODERN_SOURCE_REVISION = JSON.stringify(sourceRevision);
+        }
         await (0, external_server_global_vars_js_namespaceObject.transformServerGlobalVars)([
             ...context.outputDirectories
         ], globals);

package/dist/cjs/hono-client-codegen.js

@@ -1,14 +1,5 @@
 "use strict";
 var __webpack_require__ = {};
-(()=>{
-    __webpack_require__.n = (module)=>{
-        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
-        __webpack_require__.d(getter, {
-            a: getter
-        });
-        return getter;
-    };
-})();
 (()=>{
     __webpack_require__.d = (exports1, getters, values)=>{
         var define = (defs, kind)=>{
@@ -39,19 +30,18 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     modifyClient: ()=>modifyClient
 });
-const external_node_path_namespaceObject = require("node:path");
-var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
 const node_namespaceObject = require("@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(external_node_path_default().resolve(appDir, 'package.json')).version;
-    } catch  {}
-    const operationVersion = (0, node_namespaceObject.deriveOperationVersion)(version);
-    const normalizedRequestId = requestId || 'default';
+    const { operationVersion, requestId: normalizedRequestId } = (0, node_namespaceObject.resolveOperationProducer)({
+        directories: [
+            context.options.apiDir,
+            appDir
+        ],
+        requestId: requestId || 'default'
+    });
     const operationContracts = (0, node_namespaceObject.buildOperationContractMap)({
         handlers: [
             ...context.handlerInfos

package/dist/cjs/index.js

@@ -70,19 +70,26 @@ const bffPlugin = ()=>({
                 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.');
+                if ('hono' !== runtimeFramework) {
+                    plugins.splice(plugins.indexOf(native), 1, {
+                        name: '@modern-js/plugin-bff-extensions/effect-server'
+                    });
+                    return {
+                        plugins
+                    };
+                }
                 native.options = {
                     ...native.options,
-                    honoRouteBinder,
-                    runtimeAdapters: {
-                        ...runtimeAdapters,
-                        effect
-                    }
+                    honoRouteBinder
                 };
+                native.includeEntries = [
+                    ...new Set([
+                        ...native.includeEntries ?? [],
+                        honoRouteBinder
+                    ])
+                ];
                 return {
                     plugins
                 };

package/dist/cjs/runtime-build-identity.js

@@ -0,0 +1,18 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __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__);
+for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

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

@@ -28,11 +28,9 @@ var __webpack_require__ = {};
 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',
@@ -47,37 +45,18 @@ const collectJavaScriptFiles = (directory)=>Promise.resolve().then(()=>utils_nam
                 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` : '';
+            const releaseIdentityBanner = RELEASE_IDENTITY_GLOBAL_NAMES.every((name)=>Object.hasOwn(globalVars, name)) ? `${RELEASE_IDENTITY_GLOBAL_NAMES.map((name)=>`${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}`, {
+                            return inputSourceMapPromise.then(async (inputSourceMap)=>{
+                                const { transform } = await import("@swc/core");
+                                return transform(`${releaseIdentityBanner}${source}`, {
                                     filename,
                                     inputSourceMap,
                                     sourceMaps: sourceMapExists,
@@ -97,15 +76,14 @@ const transformServerGlobalVars = (outputDirectories, globalVars)=>Promise.resol
                                     }
                                 }).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', {

package/dist/esm/client-artifacts.mjs

@@ -1,6 +1,5 @@
 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";
+import { buildOperationContractMap, resolveOperationProducer } from "@modern-js/server-runtime-extensions/bff-policy/node";
 const BFF_REQUEST_RUNTIME = '@modern-js/runtime-extensions/request-policy';
 function registerBffClientArtifacts(api, metadata) {
     api.modifyBffClientArtifacts(async (context)=>{
@@ -18,7 +17,8 @@ function registerBffClientArtifacts(api, metadata) {
                 appDir: generation.appDirectory,
                 resourcePath: sourceEffectEntry,
                 prefix: generation.prefix,
-                requestId: generation.requestId
+                requestId: generation.requestId,
+                globalVars: config.source.globalVars
             });
             if (null === operationContracts) throw new Error(`Cannot resolve exported Effect HttpApi in ${sourceEffectEntry}.`);
             metadata.set(generation, {
@@ -35,11 +35,15 @@ function registerBffClientArtifacts(api, metadata) {
                 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)
+                ...resolveOperationProducer({
+                    directories: [
+                        generation.apiDirectory,
+                        generation.appDirectory
+                    ],
+                    requestId: generation.requestId || 'default'
+                })
             }) : {};
             metadata.set(generation, {
                 runtimeFramework: 'hono',

package/dist/esm/compile.mjs

@@ -1,4 +1,5 @@
-import { serializeServerGlobalVars, transformServerGlobalVars } from "./server-global-vars.mjs";
+import { serializeServerGlobalVars } from "@modern-js/plugin-bff-extensions/server-global-vars";
+import { transformServerGlobalVars } from "./server-global-vars.mjs";
 function registerBffCompilation(api) {
     const serialized = new WeakMap();
     api.onBeforeBffCompile((context)=>{
@@ -8,6 +9,18 @@ function registerBffCompilation(api) {
         const globals = serialized.get(context);
         if (!globals) throw new Error('BFF compilation completed without its before hook.');
         serialized.delete(context);
+        const appContext = api.getAppContext();
+        const resolveIdentity = appContext.resolveBffRuntimeBuildIdentity;
+        if (true !== appContext.apiOnly && void 0 !== resolveIdentity) {
+            if (appContext.appDirectory !== context.appDirectory) throw new Error('BFF runtime build identity provider does not belong to this application.');
+            if ('function' != typeof resolveIdentity) throw new Error('BFF runtime build identity provider is invalid.');
+            const identity = await resolveIdentity(context);
+            if (null === identity || 'object' != typeof identity || !Object.isFrozen(identity)) throw new Error('BFF runtime build identity must be immutable.');
+            const { buildMarker, sourceRevision } = identity;
+            if ('string' != typeof buildMarker || !/^[0-9a-f]{64}$/u.test(buildMarker) || 'string' != typeof sourceRevision || 0 === sourceRevision.trim().length) throw new Error('BFF runtime build identity is not finalized.');
+            globals.ULTRAMODERN_BUILD_MARKER = JSON.stringify(buildMarker);
+            globals.ULTRAMODERN_SOURCE_REVISION = JSON.stringify(sourceRevision);
+        }
         await transformServerGlobalVars([
             ...context.outputDirectories
         ], globals);

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

@@ -1,15 +1,15 @@
-import node_path from "node:path";
-import { buildOperationContractMap, createOperationSchemaHash, deriveOperationVersion } from "@modern-js/server-runtime-extensions/bff-policy/node";
+import { buildOperationContractMap, createOperationSchemaHash, resolveOperationProducer } 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 { operationVersion, requestId: normalizedRequestId } = resolveOperationProducer({
+        directories: [
+            context.options.apiDir,
+            appDir
+        ],
+        requestId: requestId || 'default'
+    });
     const operationContracts = buildOperationContractMap({
         handlers: [
             ...context.handlerInfos

package/dist/esm/index.mjs

@@ -37,19 +37,26 @@ const src_bffPlugin = ()=>({
                 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.');
+                if ('hono' !== runtimeFramework) {
+                    plugins.splice(plugins.indexOf(native), 1, {
+                        name: '@modern-js/plugin-bff-extensions/effect-server'
+                    });
+                    return {
+                        plugins
+                    };
+                }
                 native.options = {
                     ...native.options,
-                    honoRouteBinder,
-                    runtimeAdapters: {
-                        ...runtimeAdapters,
-                        effect
-                    }
+                    honoRouteBinder
                 };
+                native.includeEntries = [
+                    ...new Set([
+                        ...native.includeEntries ?? [],
+                        honoRouteBinder
+                    ])
+                ];
                 return {
                     plugins
                 };

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

@@ -1,5 +1,4 @@
-import { applyOptionsChain, fs, upath } from "@modern-js/utils";
-import { transform } from "@swc/core";
+import { fs, upath } from "@modern-js/utils";
 const RELEASE_IDENTITY_GLOBAL_NAMES = [
     'ULTRAMODERN_BUILD_MARKER',
     'ULTRAMODERN_SOURCE_REVISION',
@@ -14,37 +13,18 @@ const collectJavaScriptFiles = (directory)=>Promise.resolve().then(()=>fs.readdi
                 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` : '';
+            const releaseIdentityBanner = RELEASE_IDENTITY_GLOBAL_NAMES.every((name)=>Object.hasOwn(globalVars, name)) ? `${RELEASE_IDENTITY_GLOBAL_NAMES.map((name)=>`${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}`, {
+                            return inputSourceMapPromise.then(async (inputSourceMap)=>{
+                                const { transform } = await import("@swc/core");
+                                return transform(`${releaseIdentityBanner}${source}`, {
                                     filename,
                                     inputSourceMap,
                                     sourceMaps: sourceMapExists,
@@ -64,9 +44,10 @@ const transformServerGlobalVars = (outputDirectories, globalVars)=>Promise.resol
                                     }
                                 }).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 };
+export { transformServerGlobalVars };

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

@@ -1,7 +1,6 @@
 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";
+import { buildOperationContractMap, resolveOperationProducer } from "@modern-js/server-runtime-extensions/bff-policy/node";
 const BFF_REQUEST_RUNTIME = '@modern-js/runtime-extensions/request-policy';
 function registerBffClientArtifacts(api, metadata) {
     api.modifyBffClientArtifacts(async (context)=>{
@@ -19,7 +18,8 @@ function registerBffClientArtifacts(api, metadata) {
                 appDir: generation.appDirectory,
                 resourcePath: sourceEffectEntry,
                 prefix: generation.prefix,
-                requestId: generation.requestId
+                requestId: generation.requestId,
+                globalVars: config.source.globalVars
             });
             if (null === operationContracts) throw new Error(`Cannot resolve exported Effect HttpApi in ${sourceEffectEntry}.`);
             metadata.set(generation, {
@@ -36,11 +36,15 @@ function registerBffClientArtifacts(api, metadata) {
                 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)
+                ...resolveOperationProducer({
+                    directories: [
+                        generation.apiDirectory,
+                        generation.appDirectory
+                    ],
+                    requestId: generation.requestId || 'default'
+                })
             }) : {};
             metadata.set(generation, {
                 runtimeFramework: 'hono',

package/dist/esm-node/compile.mjs

@@ -1,5 +1,6 @@
 import "node:module";
-import { serializeServerGlobalVars, transformServerGlobalVars } from "./server-global-vars.mjs";
+import { serializeServerGlobalVars } from "@modern-js/plugin-bff-extensions/server-global-vars";
+import { transformServerGlobalVars } from "./server-global-vars.mjs";
 function registerBffCompilation(api) {
     const serialized = new WeakMap();
     api.onBeforeBffCompile((context)=>{
@@ -9,6 +10,18 @@ function registerBffCompilation(api) {
         const globals = serialized.get(context);
         if (!globals) throw new Error('BFF compilation completed without its before hook.');
         serialized.delete(context);
+        const appContext = api.getAppContext();
+        const resolveIdentity = appContext.resolveBffRuntimeBuildIdentity;
+        if (true !== appContext.apiOnly && void 0 !== resolveIdentity) {
+            if (appContext.appDirectory !== context.appDirectory) throw new Error('BFF runtime build identity provider does not belong to this application.');
+            if ('function' != typeof resolveIdentity) throw new Error('BFF runtime build identity provider is invalid.');
+            const identity = await resolveIdentity(context);
+            if (null === identity || 'object' != typeof identity || !Object.isFrozen(identity)) throw new Error('BFF runtime build identity must be immutable.');
+            const { buildMarker, sourceRevision } = identity;
+            if ('string' != typeof buildMarker || !/^[0-9a-f]{64}$/u.test(buildMarker) || 'string' != typeof sourceRevision || 0 === sourceRevision.trim().length) throw new Error('BFF runtime build identity is not finalized.');
+            globals.ULTRAMODERN_BUILD_MARKER = JSON.stringify(buildMarker);
+            globals.ULTRAMODERN_SOURCE_REVISION = JSON.stringify(sourceRevision);
+        }
         await transformServerGlobalVars([
             ...context.outputDirectories
         ], globals);

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

@@ -1,17 +1,16 @@
-import __rslib_shim_module__ from "node:module";
-const require = /*#__PURE__*/ __rslib_shim_module__.createRequire(/*#__PURE__*/ (()=>import.meta.url)());
-import node_path from "node:path";
-import { buildOperationContractMap, createOperationSchemaHash, deriveOperationVersion } from "@modern-js/server-runtime-extensions/bff-policy/node";
+import "node:module";
+import { buildOperationContractMap, createOperationSchemaHash, resolveOperationProducer } 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 { operationVersion, requestId: normalizedRequestId } = resolveOperationProducer({
+        directories: [
+            context.options.apiDir,
+            appDir
+        ],
+        requestId: requestId || 'default'
+    });
     const operationContracts = buildOperationContractMap({
         handlers: [
             ...context.handlerInfos

package/dist/esm-node/index.mjs

@@ -39,19 +39,26 @@ const src_bffPlugin = ()=>({
                 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.');
+                if ('hono' !== runtimeFramework) {
+                    plugins.splice(plugins.indexOf(native), 1, {
+                        name: '@modern-js/plugin-bff-extensions/effect-server'
+                    });
+                    return {
+                        plugins
+                    };
+                }
                 native.options = {
                     ...native.options,
-                    honoRouteBinder,
-                    runtimeAdapters: {
-                        ...runtimeAdapters,
-                        effect
-                    }
+                    honoRouteBinder
                 };
+                native.includeEntries = [
+                    ...new Set([
+                        ...native.includeEntries ?? [],
+                        honoRouteBinder
+                    ])
+                ];
                 return {
                     plugins
                 };

package/dist/esm-node/runtime-build-identity.mjs

@@ -0,0 +1 @@
+import "node:module";

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

@@ -1,6 +1,5 @@
 import "node:module";
-import { applyOptionsChain, fs, upath } from "@modern-js/utils";
-import { transform } from "@swc/core";
+import { fs, upath } from "@modern-js/utils";
 const RELEASE_IDENTITY_GLOBAL_NAMES = [
     'ULTRAMODERN_BUILD_MARKER',
     'ULTRAMODERN_SOURCE_REVISION',
@@ -15,37 +14,18 @@ const collectJavaScriptFiles = (directory)=>Promise.resolve().then(()=>fs.readdi
                 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` : '';
+            const releaseIdentityBanner = RELEASE_IDENTITY_GLOBAL_NAMES.every((name)=>Object.hasOwn(globalVars, name)) ? `${RELEASE_IDENTITY_GLOBAL_NAMES.map((name)=>`${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}`, {
+                            return inputSourceMapPromise.then(async (inputSourceMap)=>{
+                                const { transform } = await import("@swc/core");
+                                return transform(`${releaseIdentityBanner}${source}`, {
                                     filename,
                                     inputSourceMap,
                                     sourceMaps: sourceMapExists,
@@ -65,9 +45,10 @@ const transformServerGlobalVars = (outputDirectories, globalVars)=>Promise.resol
                                     }
                                 }).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 };
+export { transformServerGlobalVars };

package/dist/types/index.d.ts

@@ -1,4 +1,5 @@
 import '@modern-js/server-runtime-extensions/server-config';
 import type { AppTools, CliPlugin } from '@modern-js/app-tools';
+export type { BffRuntimeBuildIdentity, BffRuntimeBuildIdentityProvider, WithBffRuntimeBuildIdentity, } from './runtime-build-identity.js';
 export declare const bffPlugin: () => CliPlugin<AppTools>;
 export default bffPlugin;

package/dist/types/runtime-build-identity.d.ts

@@ -0,0 +1,17 @@
+import type { BffCompilation } from '@modern-js/app-tools';
+import type { CLIPluginExtends } from '@modern-js/plugin/cli';
+export interface BffRuntimeBuildIdentity {
+    readonly buildMarker: string;
+    readonly sourceRevision: string;
+}
+export type BffRuntimeBuildIdentityProvider = (compilation: BffCompilation) => Promise<BffRuntimeBuildIdentity>;
+export type WithBffRuntimeBuildIdentity<Extends extends CLIPluginExtends> = Extends & {
+    extendContext: Extends['extendContext'] & {
+        resolveBffRuntimeBuildIdentity?: BffRuntimeBuildIdentityProvider;
+    };
+};
+declare module '@modern-js/app-tools' {
+    interface AppToolsExtendContext {
+        resolveBffRuntimeBuildIdentity?: BffRuntimeBuildIdentityProvider;
+    }
+}

package/dist/types/server-global-vars.d.ts

@@ -1,6 +1,2 @@
-import type { AppTools } from '@modern-js/app-tools';
-type SerializedGlobalVars = Record<string, string>;
-type ServerGlobalVarsOptions = NonNullable<NonNullable<AppTools['config']>['source']>['globalVars'];
-export declare const serializeServerGlobalVars: (options: ServerGlobalVarsOptions) => SerializedGlobalVars;
-export declare const transformServerGlobalVars: (outputDirectories: string[], globalVars: SerializedGlobalVars) => Promise<undefined>;
-export {};
+import type { SerializedServerGlobalVars } from '@modern-js/plugin-bff-extensions/server-global-vars';
+export declare const transformServerGlobalVars: (outputDirectories: string[], globalVars: SerializedServerGlobalVars) => Promise<undefined>;

package/package.json

@@ -1,16 +1,16 @@
 {
-  "homepage": "https://github.com/BleedingDev/ultramodern.js#readme",
+  "homepage": "https://github.com/ultramodernjs/ultramodern.js#readme",
   "bugs": {
-    "url": "https://github.com/BleedingDev/ultramodern.js/issues"
+    "url": "https://github.com/ultramodernjs/ultramodern.js/issues"
   },
   "license": "MIT",
-  "version": "3.9.0-ultramodern.9",
+  "version": "3.9.3-ultramodern.10",
   "files": [
     "dist",
     "src"
   ],
   "engines": {
-    "node": ">=26.7.0"
+    "node": ">=26.12.0"
   },
   "sideEffects": false,
   "publishConfig": {
@@ -20,7 +20,7 @@
   "description": "Fork-owned BFF build lifecycle, instrumentation, and producer SDK composition.",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/BleedingDev/ultramodern.js.git",
+    "url": "git+https://github.com/ultramodernjs/ultramodern.js.git",
     "directory": "packages/cli/plugin-bff-build-extensions"
   },
   "main": "./dist/cjs/index.js",
@@ -65,19 +65,19 @@
     }
   },
   "dependencies": {
-    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.9.0-ultramodern.9",
-    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.0-ultramodern.9",
-    "@modern-js/plugin-bff": "npm:@bleedingdev/modern-js-plugin-bff@3.9.0-ultramodern.9",
-    "@modern-js/plugin-bff-extensions": "npm:@bleedingdev/modern-js-plugin-bff-extensions@3.9.0-ultramodern.9",
-    "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.0-ultramodern.9",
-    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.0-ultramodern.9",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.9",
-    "@swc/core": "1.16.2"
+    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.9.3-ultramodern.10",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.3-ultramodern.10",
+    "@modern-js/plugin-bff": "npm:@bleedingdev/modern-js-plugin-bff@3.9.3-ultramodern.10",
+    "@modern-js/plugin-bff-extensions": "npm:@bleedingdev/modern-js-plugin-bff-extensions@3.9.3-ultramodern.10",
+    "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.3-ultramodern.10",
+    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.3-ultramodern.10",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.3-ultramodern.10",
+    "@swc/core": "1.16.18"
   },
   "peerDependencies": {
-    "@effect/opentelemetry": "4.0.0-rc.112",
-    "@modern-js/app-tools": "3.9.0-ultramodern.9",
-    "effect": "4.0.0-rc.112"
+    "@effect/opentelemetry": "4.0.5",
+    "@modern-js/app-tools": "3.9.3-ultramodern.10",
+    "effect": "4.0.5"
   },
   "peerDependenciesMeta": {
     "@effect/opentelemetry": {
@@ -88,25 +88,28 @@
     }
   },
   "devDependencies": {
-    "@effect/opentelemetry": "4.0.0-rc.112",
-    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.9.0-ultramodern.9",
-    "@modern-js/bff-effect": "npm:@bleedingdev/modern-js-bff-effect@3.9.0-ultramodern.9",
-    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.9.0-ultramodern.9",
-    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.0-ultramodern.9",
-    "@modern-js/tsconfig": "npm:@bleedingdev/modern-js-tsconfig@3.9.0-ultramodern.9",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.9",
-    "@rsbuild/core": "2.2.3",
-    "@rslib/core": "1.0.0",
+    "@effect/opentelemetry": "4.0.5",
+    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.9.3-ultramodern.10",
+    "@modern-js/bff-effect": "npm:@bleedingdev/modern-js-bff-effect@3.9.3-ultramodern.10",
+    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.9.3-ultramodern.10",
+    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.3-ultramodern.10",
+    "@modern-js/tsconfig": "npm:@bleedingdev/modern-js-tsconfig@3.9.3-ultramodern.10",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.3-ultramodern.10",
+    "@rsbuild/core": "2.2.13",
+    "@rslib/core": "1.0.3",
     "@scripts/rstest-config": "2.66.0",
-    "@types/node": "^26.4.1",
-    "@typescript/native-preview": "7.0.0-dev.20260707.2",
-    "effect": "4.0.0-rc.112",
+    "@types/node": "^26.6.5",
+    "effect": "4.0.5",
     "esbuild": "^0.28.2",
-    "zod": "^4.5.4"
+    "typescript": "7.0.2",
+    "zod": "^4.6.7"
   },
   "scripts": {
     "dev": "rslib build --watch",
     "build": "rslib build",
     "test": "rstest"
+  },
+  "ultramodern": {
+    "sourceName": "@modern-js/plugin-bff-build-extensions"
   }
 }

package/src/client-artifacts.ts

@@ -7,10 +7,9 @@ import { ApiRouter } from '@modern-js/bff-core';
 import type { CLIPluginAPI } from '@modern-js/plugin';
 import {
   buildOperationContractMap,
-  deriveOperationVersion,
   type OperationContractMap,
+  resolveOperationProducer,
 } from '@modern-js/server-runtime-extensions/bff-policy/node';
-import { fs, upath as path } from '@modern-js/utils';
 
 export const BFF_REQUEST_RUNTIME =
   '@modern-js/runtime-extensions/request-policy';
@@ -46,6 +45,7 @@ export function registerBffClientArtifacts(
         resourcePath: sourceEffectEntry,
         prefix: generation.prefix,
         requestId: generation.requestId,
+        globalVars: config.source.globalVars,
       });
       if (operationContracts === null) {
         throw new Error(
@@ -66,14 +66,13 @@ export function registerBffClientArtifacts(
         httpMethodDecider: generation.httpMethodDecider,
         isBuild: true,
       });
-      const packageJson = await fs.readJSON(
-        path.join(generation.appDirectory, 'package.json'),
-      );
       const operationContracts = generation.existLambda
         ? buildOperationContractMap({
             handlers: await router.getApiHandlers(),
-            requestId: generation.requestId,
-            operationVersion: deriveOperationVersion(packageJson.version),
+            ...resolveOperationProducer({
+              directories: [generation.apiDirectory, generation.appDirectory],
+              requestId: generation.requestId || 'default',
+            }),
           })
         : {};
       metadata.set(generation, {

package/src/compile.ts

@@ -1,15 +1,14 @@
 import type { AppTools, BffCompilation } from '@modern-js/app-tools';
 import type { CLIPluginAPI } from '@modern-js/plugin';
 import {
+  type SerializedServerGlobalVars,
   serializeServerGlobalVars,
-  transformServerGlobalVars,
-} from './server-global-vars';
+} from '@modern-js/plugin-bff-extensions/server-global-vars';
+import type { BffRuntimeBuildIdentity } from './runtime-build-identity';
+import { transformServerGlobalVars } from './server-global-vars';
 
 export function registerBffCompilation(api: CLIPluginAPI<AppTools>) {
-  const serialized = new WeakMap<
-    BffCompilation,
-    ReturnType<typeof serializeServerGlobalVars>
-  >();
+  const serialized = new WeakMap<BffCompilation, SerializedServerGlobalVars>();
   api.onBeforeBffCompile(context => {
     serialized.set(
       context,
@@ -21,6 +20,37 @@ export function registerBffCompilation(api: CLIPluginAPI<AppTools>) {
     if (!globals)
       throw new Error('BFF compilation completed without its before hook.');
     serialized.delete(context);
+    const appContext = api.getAppContext();
+    const resolveIdentity = appContext.resolveBffRuntimeBuildIdentity;
+    if (appContext.apiOnly !== true && resolveIdentity !== undefined) {
+      if (appContext.appDirectory !== context.appDirectory) {
+        throw new Error(
+          'BFF runtime build identity provider does not belong to this application.',
+        );
+      }
+      if (typeof resolveIdentity !== 'function') {
+        throw new Error('BFF runtime build identity provider is invalid.');
+      }
+      const identity: BffRuntimeBuildIdentity = await resolveIdentity(context);
+      if (
+        identity === null ||
+        typeof identity !== 'object' ||
+        !Object.isFrozen(identity)
+      ) {
+        throw new Error('BFF runtime build identity must be immutable.');
+      }
+      const { buildMarker, sourceRevision } = identity;
+      if (
+        typeof buildMarker !== 'string' ||
+        !/^[0-9a-f]{64}$/u.test(buildMarker) ||
+        typeof sourceRevision !== 'string' ||
+        sourceRevision.trim().length === 0
+      ) {
+        throw new Error('BFF runtime build identity is not finalized.');
+      }
+      globals.ULTRAMODERN_BUILD_MARKER = JSON.stringify(buildMarker);
+      globals.ULTRAMODERN_SOURCE_REVISION = JSON.stringify(sourceRevision);
+    }
     await transformServerGlobalVars([...context.outputDirectories], globals);
     if (api.getAppContext().bffRuntimeFramework !== 'effect') return;
     // Hosted APIs use the producer's compiled entry; it is not emitted by this app.

package/src/hono-client-codegen.ts

@@ -1,9 +1,8 @@
-import path from 'node:path';
 import type { ClientCodegenPlugin } from '@modern-js/bff-core';
 import {
   buildOperationContractMap,
   createOperationSchemaHash,
-  deriveOperationVersion,
+  resolveOperationProducer,
 } from '@modern-js/server-runtime-extensions/bff-policy/node';
 
 const REQUEST_RUNTIME = '@modern-js/runtime-extensions/request-policy';
@@ -11,14 +10,11 @@ const REQUEST_RUNTIME = '@modern-js/runtime-extensions/request-policy';
 export const modifyClient: ClientCodegenPlugin = (draft, context) => {
   const { appDir, requestId } = context.options;
   draft.requestCreator = context.options.requestCreator || REQUEST_RUNTIME;
-  let version: string | undefined;
-  try {
-    version = require(path.resolve(appDir, 'package.json')).version;
-  } catch {
-    // Missing or invalid package metadata uses the established version fallback.
-  }
-  const operationVersion = deriveOperationVersion(version);
-  const normalizedRequestId = requestId || 'default';
+  const { operationVersion, requestId: normalizedRequestId } =
+    resolveOperationProducer({
+      directories: [context.options.apiDir, appDir],
+      requestId: requestId || 'default',
+    });
   const operationContracts = buildOperationContractMap({
     handlers: [...context.handlerInfos],
     requestId: normalizedRequestId,

package/src/index.ts

@@ -11,6 +11,12 @@ import { registerBffCompilation } from './compile';
 import { registerBffGeneratedEntries } from './generated-entries';
 import { resolveSelfModule } from './self-module';
 
+export type {
+  BffRuntimeBuildIdentity,
+  BffRuntimeBuildIdentityProvider,
+  WithBffRuntimeBuildIdentity,
+} from './runtime-build-identity';
+
 export const bffPlugin = (): CliPlugin<AppTools> => ({
   name: '@modern-js/plugin-bff-build-extensions',
   usePlugins: [nativeBffPlugin()],
@@ -50,8 +56,6 @@ export const bffPlugin = (): CliPlugin<AppTools> => ({
         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 !== undefined &&
@@ -59,19 +63,19 @@ export const bffPlugin = (): CliPlugin<AppTools> => ({
       ) {
         throw new Error('The Hono BFF route binder is already configured.');
       }
-      if (
-        runtimeAdapters.effect !== undefined &&
-        runtimeAdapters.effect !== effect
-      ) {
-        throw new Error(
-          'The Effect BFF runtime adapter is already configured.',
-        );
+      if (runtimeFramework !== 'hono') {
+        plugins.splice(plugins.indexOf(native), 1, {
+          name: '@modern-js/plugin-bff-extensions/effect-server',
+        });
+        return { plugins };
       }
       native.options = {
         ...native.options,
         honoRouteBinder,
-        runtimeAdapters: { ...runtimeAdapters, effect },
       };
+      native.includeEntries = [
+        ...new Set([...(native.includeEntries ?? []), honoRouteBinder]),
+      ];
       return { plugins };
     });
     const metadata = new WeakMap<BffGeneration, BffGenerationMetadata>();

package/src/runtime-build-identity.ts

@@ -0,0 +1,24 @@
+import type { BffCompilation } from '@modern-js/app-tools';
+import type { CLIPluginExtends } from '@modern-js/plugin/cli';
+
+export interface BffRuntimeBuildIdentity {
+  readonly buildMarker: string;
+  readonly sourceRevision: string;
+}
+
+export type BffRuntimeBuildIdentityProvider = (
+  compilation: BffCompilation,
+) => Promise<BffRuntimeBuildIdentity>;
+
+export type WithBffRuntimeBuildIdentity<Extends extends CLIPluginExtends> =
+  Extends & {
+    extendContext: Extends['extendContext'] & {
+      resolveBffRuntimeBuildIdentity?: BffRuntimeBuildIdentityProvider;
+    };
+  };
+
+declare module '@modern-js/app-tools' {
+  interface AppToolsExtendContext {
+    resolveBffRuntimeBuildIdentity?: BffRuntimeBuildIdentityProvider;
+  }
+}

package/src/server-global-vars.ts

@@ -1,12 +1,5 @@
-import type { AppTools } from '@modern-js/app-tools';
-import type { RsbuildTarget } from '@modern-js/builder';
-import { applyOptionsChain, fs, upath as path } from '@modern-js/utils';
-import { transform } from '@swc/core';
-
-type SerializedGlobalVars = Record<string, string>;
-type ServerGlobalVarsOptions = NonNullable<
-  NonNullable<AppTools['config']>['source']
->['globalVars'];
+import type { SerializedServerGlobalVars } from '@modern-js/plugin-bff-extensions/server-global-vars';
+import { fs, upath as path } from '@modern-js/utils';
 
 const RELEASE_IDENTITY_GLOBAL_NAMES = [
   'ULTRAMODERN_BUILD_MARKER',
@@ -29,41 +22,9 @@ const collectJavaScriptFiles = (directory: string): Promise<string[]> =>
       ).then(nested => nested.flat()),
     );
 
-export const serializeServerGlobalVars = (
-  options: ServerGlobalVarsOptions,
-): SerializedGlobalVars => {
-  const globalVars = applyOptionsChain<
-    Record<string, unknown>,
-    { env: string; target: RsbuildTarget }
-  >({}, options, {
-    env: 'server',
-    target: 'node',
-  });
-
-  return Object.fromEntries(
-    Object.entries(globalVars).map(([key, value]) => {
-      let serialized: string | undefined;
-      try {
-        serialized = JSON.stringify(value);
-      } catch (error) {
-        throw new Error(
-          `source.globalVars["${key}"] cannot be serialized exactly for BFF compilation.`,
-          { cause: error },
-        );
-      }
-      if (serialized === undefined) {
-        throw new Error(
-          `source.globalVars["${key}"] cannot be serialized exactly for BFF compilation.`,
-        );
-      }
-      return [key, serialized];
-    }),
-  );
-};
-
 export const transformServerGlobalVars = (
   outputDirectories: string[],
-  globalVars: SerializedGlobalVars,
+  globalVars: SerializedServerGlobalVars,
 ) =>
   Promise.resolve().then(() => {
     if (Object.keys(globalVars).length === 0) {
@@ -87,7 +48,8 @@ export const transformServerGlobalVars = (
         const releaseIdentityBanner = RELEASE_IDENTITY_GLOBAL_NAMES.every(
           name => Object.hasOwn(globalVars, name),
         )
-          ? `${RELEASE_IDENTITY_GLOBAL_NAMES.map(name => `void ${globalVars[name]};`).join('')}\n`
+          ? // String statements, so a following "use strict" stays in the prologue.
+            `${RELEASE_IDENTITY_GLOBAL_NAMES.map(name => `${globalVars[name]};`).join('')}\n`
           : '';
 
         return filesPromise.then(files =>
@@ -103,8 +65,9 @@ export const transformServerGlobalVars = (
                         ? fs.readFile(sourceMapFilename, 'utf8')
                         : Promise.resolve(undefined);
 
-                    return inputSourceMapPromise.then(inputSourceMap =>
-                      transform(`${releaseIdentityBanner}${source}`, {
+                    return inputSourceMapPromise.then(async inputSourceMap => {
+                      const { transform } = await import('@swc/core');
+                      return transform(`${releaseIdentityBanner}${source}`, {
                         filename,
                         inputSourceMap,
                         sourceMaps: sourceMapExists,
@@ -133,8 +96,8 @@ export const transformServerGlobalVars = (
                           }
                           return undefined;
                         }),
-                      ),
-                    );
+                      );
+                    });
                   });
               }),
             ),