@bleedingdev/modern-js-plugin-bff-extensions 3.9.3-ultramodern.1 → 3.9.3-ultramodern.2

package/dist/cjs/effect-server/index.js

@@ -90,7 +90,8 @@ const effect_server = ()=>({
                 try {
                     mod = await ((0, utils_namespaceObject.isProd)() ? (0, loader_js_namespaceObject.loadEffectBuiltModule)(entryFile) : (0, loader_js_namespaceObject.loadEffectSourceModule)({
                         resourcePath: entryFile,
-                        appDir: appDirectory || external_node_path_default().dirname(entryFile)
+                        appDir: appDirectory || external_node_path_default().dirname(entryFile),
+                        globalVars: api.getServerConfig()?.source?.globalVars
                     }));
                 } catch (error) {
                     utils_namespaceObject.logger.error(`[BFF][Effect] Failed to load Effect entry: ${entryFile}\n${String(error)}`);

package/dist/cjs/effect-source-loader/loader.js

@@ -50,6 +50,7 @@ const external_node_path_namespaceObject = require("node:path");
 var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
 const external_node_url_namespaceObject = require("node:url");
 const external_esbuild_namespaceObject = require("esbuild");
+const index_js_namespaceObject = require("../server-global-vars/index.js");
 const NODE_TARGET = 'node26.10';
 const SOURCE_LOADERS = new Map([
     [
@@ -285,6 +286,7 @@ async function loadEffectSourceModule(options) {
             js: `import { createRequire as __modernCreateEffectRequire } from 'node:module'; const require = __modernCreateEffectRequire(${JSON.stringify((0, external_node_url_namespaceObject.pathToFileURL)(resourcePath).href)});`
         },
         bundle: true,
+        define: (0, index_js_namespaceObject.serializeServerGlobalVars)(options.globalVars),
         entryPoints: [
             resourcePath
         ],

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

@@ -0,0 +1,61 @@
+"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
+});
+const utils_namespaceObject = require("@modern-js/utils");
+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 server code.`, {
+                cause: error
+            });
+        }
+        if (void 0 === serialized) throw new Error(`source.globalVars["${key}"] cannot be serialized exactly for BFF server code.`);
+        return [
+            key,
+            serialized
+        ];
+    }));
+};
+exports.serializeServerGlobalVars = __webpack_exports__.serializeServerGlobalVars;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "serializeServerGlobalVars"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

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

@@ -48,7 +48,8 @@ const effect_server = ()=>({
                 try {
                     mod = await (isProd() ? loadEffectBuiltModule(entryFile) : loadEffectSourceModule({
                         resourcePath: entryFile,
-                        appDir: appDirectory || node_path.dirname(entryFile)
+                        appDir: appDirectory || node_path.dirname(entryFile),
+                        globalVars: api.getServerConfig()?.source?.globalVars
                     }));
                 } catch (error) {
                     logger.error(`[BFF][Effect] Failed to load Effect entry: ${entryFile}\n${String(error)}`);

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

@@ -4,6 +4,7 @@ import { builtinModules, createRequire } from "node:module";
 import node_path from "node:path";
 import { pathToFileURL } from "node:url";
 import { build, transform } from "esbuild";
+import { serializeServerGlobalVars } from "../server-global-vars/index.mjs";
 const NODE_TARGET = 'node26.10';
 const SOURCE_LOADERS = new Map([
     [
@@ -239,6 +240,7 @@ async function loadEffectSourceModule(options) {
             js: `import { createRequire as __modernCreateEffectRequire } from 'node:module'; const require = __modernCreateEffectRequire(${JSON.stringify(pathToFileURL(resourcePath).href)});`
         },
         bundle: true,
+        define: serializeServerGlobalVars(options.globalVars),
         entryPoints: [
             resourcePath
         ],

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

@@ -0,0 +1,23 @@
+import { applyOptionsChain } from "@modern-js/utils";
+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 server code.`, {
+                cause: error
+            });
+        }
+        if (void 0 === serialized) throw new Error(`source.globalVars["${key}"] cannot be serialized exactly for BFF server code.`);
+        return [
+            key,
+            serialized
+        ];
+    }));
+};
+export { serializeServerGlobalVars };

package/dist/esm-node/effect-server/index.mjs

@@ -49,7 +49,8 @@ const effect_server = ()=>({
                 try {
                     mod = await (isProd() ? loadEffectBuiltModule(entryFile) : loadEffectSourceModule({
                         resourcePath: entryFile,
-                        appDir: appDirectory || node_path.dirname(entryFile)
+                        appDir: appDirectory || node_path.dirname(entryFile),
+                        globalVars: api.getServerConfig()?.source?.globalVars
                     }));
                 } catch (error) {
                     logger.error(`[BFF][Effect] Failed to load Effect entry: ${entryFile}\n${String(error)}`);

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

@@ -5,6 +5,7 @@ import { builtinModules, createRequire } from "node:module";
 import node_path from "node:path";
 import { pathToFileURL } from "node:url";
 import { build, transform } from "esbuild";
+import { serializeServerGlobalVars } from "../server-global-vars/index.mjs";
 const NODE_TARGET = 'node26.10';
 const SOURCE_LOADERS = new Map([
     [
@@ -240,6 +241,7 @@ async function loadEffectSourceModule(options) {
             js: `import { createRequire as __modernCreateEffectRequire } from 'node:module'; const require = __modernCreateEffectRequire(${JSON.stringify(pathToFileURL(resourcePath).href)});`
         },
         bundle: true,
+        define: serializeServerGlobalVars(options.globalVars),
         entryPoints: [
             resourcePath
         ],

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

@@ -0,0 +1,24 @@
+import "node:module";
+import { applyOptionsChain } from "@modern-js/utils";
+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 server code.`, {
+                cause: error
+            });
+        }
+        if (void 0 === serialized) throw new Error(`source.globalVars["${key}"] cannot be serialized exactly for BFF server code.`);
+        return [
+            key,
+            serialized
+        ];
+    }));
+};
+export { serializeServerGlobalVars };

package/dist/types/effect-source-loader/http-api-runtime.d.ts

@@ -1,4 +1,5 @@
 import { type HttpApiLike, type HttpApiReflect } from '@modern-js/bff-effect/effect';
+import type { ServerGlobalVarsOptions } from '../server-global-vars/index.js';
 type HttpApiRuntime = {
     isHttpApi: (value: unknown) => boolean;
     reflect: HttpApiReflect;
@@ -7,6 +8,7 @@ export declare function getHttpApiRuntime(): Promise<HttpApiRuntime>;
 export declare function loadEffectApi(options: {
     appDir: string;
     resourcePath: string;
+    globalVars?: ServerGlobalVarsOptions;
     onDependency?: (dependency: string) => void;
 }): Promise<HttpApiLike | null>;
 export {};

package/dist/types/effect-source-loader/loader.d.ts

@@ -1,6 +1,9 @@
+import { type ServerGlobalVarsOptions } from '../server-global-vars/index.js';
 export type EffectSourceLoaderOptions = {
     resourcePath: string;
     appDir?: string;
+    /** `source.globalVars`, replaced in the loaded source graph. */
+    globalVars?: ServerGlobalVarsOptions;
     onDependency?: (dependency: string) => void;
 };
 export declare function bundleEffectEntryForNode(options: {

package/dist/types/effect-source-loader/operation-contracts.d.ts

@@ -1,8 +1,10 @@
+import type { ServerGlobalVarsOptions } from '../server-global-vars/index.js';
 /** Derives server policy metadata without emitting or typing a client. */
 export declare function resolveEffectOperationContracts(options: {
     appDir: string;
     resourcePath: string;
     prefix: string;
     requestId?: string;
+    globalVars?: ServerGlobalVarsOptions;
     onDependency?: (dependency: string) => void;
 }): Promise<import("@modern-js/server-runtime-extensions/bff-policy/node").OperationContractMap | null>;

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

@@ -0,0 +1,11 @@
+import type { ServerSourceConfigExtension } from '@modern-js/runtime-extensions/server-config';
+export type ServerGlobalVarsOptions = ServerSourceConfigExtension['globalVars'];
+/** Each global name mapped to the JSON source text that replaces it. */
+export type SerializedServerGlobalVars = Record<string, string>;
+/**
+ * Resolves `source.globalVars` for BFF server code and serializes every value
+ * to the JSON text that replaces it. Dev source loading and build output use
+ * this one function, so both see the same values. A value without an exact
+ * JSON form (such as `undefined`, a function or a BigInt) is rejected.
+ */
+export declare const serializeServerGlobalVars: (options: ServerGlobalVarsOptions) => SerializedServerGlobalVars;

package/package.json

@@ -18,7 +18,7 @@
     "modern.js",
     "ultramodern.js"
   ],
-  "version": "3.9.3-ultramodern.1",
+  "version": "3.9.3-ultramodern.2",
   "files": [
     "dist",
     "src"
@@ -66,6 +66,14 @@
       },
       "default": "./dist/cjs/effect-source-loader/index.js"
     },
+    "./server-global-vars": {
+      "types": "./dist/types/server-global-vars/index.d.ts",
+      "node": {
+        "import": "./dist/esm-node/server-global-vars/index.mjs",
+        "require": "./dist/cjs/server-global-vars/index.js"
+      },
+      "default": "./dist/cjs/server-global-vars/index.js"
+    },
     "./backend-federation": {
       "types": "./dist/types/backend-federation/index.d.ts",
       "node": {
@@ -155,6 +163,10 @@
         "./dist/types/effect-source-loader/index.d.ts",
         "./src/effect-source-loader/index.ts"
       ],
+      "server-global-vars": [
+        "./dist/types/server-global-vars/index.d.ts",
+        "./src/server-global-vars/index.ts"
+      ],
       "backend-federation": [
         "./dist/types/backend-federation/index.d.ts",
         "./src/backend-federation/index.ts"
@@ -193,14 +205,14 @@
     "node": ">=26.10.0"
   },
   "dependencies": {
-    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.3-ultramodern.1",
-    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.9.3-ultramodern.1",
-    "@modern-js/bff-effect": "npm:@bleedingdev/modern-js-bff-effect@3.9.3-ultramodern.1",
-    "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.3-ultramodern.1",
-    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.3-ultramodern.1",
-    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.3-ultramodern.1",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.3-ultramodern.1",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.3-ultramodern.1",
+    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.3-ultramodern.2",
+    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.9.3-ultramodern.2",
+    "@modern-js/bff-effect": "npm:@bleedingdev/modern-js-bff-effect@3.9.3-ultramodern.2",
+    "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.3-ultramodern.2",
+    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.3-ultramodern.2",
+    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.3-ultramodern.2",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.3-ultramodern.2",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.3-ultramodern.2",
     "@module-federation/runtime": "2.9.2",
     "@swc/core": "1.16.13",
     "esbuild": "^0.28.2"
@@ -219,7 +231,7 @@
   },
   "devDependencies": {
     "@effect/opentelemetry": "4.0.0",
-    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.3-ultramodern.1",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.3-ultramodern.2",
     "@rsbuild/core": "2.2.11",
     "@rslib/core": "1.0.3",
     "@scripts/rstest-config": "2.66.0",

package/src/effect-server/index.ts

@@ -78,6 +78,7 @@ export default (): ServerPlugin => ({
           : loadEffectSourceModule({
               resourcePath: entryFile,
               appDir: appDirectory || path.dirname(entryFile),
+              globalVars: api.getServerConfig()?.source?.globalVars,
             }))) as EffectApiModule;
       } catch (error) {
         logger.error(

package/src/effect-source-loader/http-api-runtime.ts

@@ -4,6 +4,7 @@ import {
   type HttpApiReflect,
 } from '@modern-js/bff-effect/effect';
 import { HttpApi } from 'effect/http-api';
+import type { ServerGlobalVarsOptions } from '../server-global-vars';
 import { loadEffectSourceModule } from './loader';
 
 type HttpApiRuntime = {
@@ -29,6 +30,7 @@ export function getHttpApiRuntime(): Promise<HttpApiRuntime> {
 export function loadEffectApi(options: {
   appDir: string;
   resourcePath: string;
+  globalVars?: ServerGlobalVarsOptions;
   onDependency?: (dependency: string) => void;
 }): Promise<HttpApiLike | null> {
   return getHttpApiRuntime().then(httpApiRuntime =>

package/src/effect-source-loader/loader.ts

@@ -12,6 +12,10 @@ import {
   type Plugin,
   transform,
 } from 'esbuild';
+import {
+  type ServerGlobalVarsOptions,
+  serializeServerGlobalVars,
+} from '../server-global-vars';
 
 const NODE_TARGET = 'node26.10';
 const SOURCE_LOADERS = new Map<string, Loader>([
@@ -28,6 +32,8 @@ const SOURCE_LOADERS = new Map<string, Loader>([
 export type EffectSourceLoaderOptions = {
   resourcePath: string;
   appDir?: string;
+  /** `source.globalVars`, replaced in the loaded source graph. */
+  globalVars?: ServerGlobalVarsOptions;
   onDependency?: (dependency: string) => void;
 };
 
@@ -352,6 +358,7 @@ export async function loadEffectSourceModule(
       js: `import { createRequire as __modernCreateEffectRequire } from 'node:module'; const require = __modernCreateEffectRequire(${JSON.stringify(pathToFileURL(resourcePath).href)});`,
     },
     bundle: true,
+    define: serializeServerGlobalVars(options.globalVars),
     entryPoints: [resourcePath],
     format: 'esm',
     jsx: 'automatic',

package/src/effect-source-loader/operation-contracts.ts

@@ -7,6 +7,7 @@ import {
   resolveOperationProducer,
 } from '@modern-js/server-runtime-extensions/bff-policy/node';
 import { upath as path } from '@modern-js/utils';
+import type { ServerGlobalVarsOptions } from '../server-global-vars';
 import { getHttpApiRuntime, loadEffectApi } from './http-api-runtime';
 
 /** Derives server policy metadata without emitting or typing a client. */
@@ -15,6 +16,7 @@ export async function resolveEffectOperationContracts(options: {
   resourcePath: string;
   prefix: string;
   requestId?: string;
+  globalVars?: ServerGlobalVarsOptions;
   onDependency?: (dependency: string) => void;
 }) {
   const api = await loadEffectApi(options);

package/src/server-global-vars/index.ts

@@ -0,0 +1,46 @@
+import type {
+  ServerGlobalVars,
+  ServerGlobalVarsContext,
+  ServerSourceConfigExtension,
+} from '@modern-js/runtime-extensions/server-config';
+import { applyOptionsChain } from '@modern-js/utils';
+
+export type ServerGlobalVarsOptions = ServerSourceConfigExtension['globalVars'];
+
+/** Each global name mapped to the JSON source text that replaces it. */
+export type SerializedServerGlobalVars = Record<string, string>;
+
+/**
+ * Resolves `source.globalVars` for BFF server code and serializes every value
+ * to the JSON text that replaces it. Dev source loading and build output use
+ * this one function, so both see the same values. A value without an exact
+ * JSON form (such as `undefined`, a function or a BigInt) is rejected.
+ */
+export const serializeServerGlobalVars = (
+  options: ServerGlobalVarsOptions,
+): SerializedServerGlobalVars => {
+  const globalVars = applyOptionsChain<
+    ServerGlobalVars,
+    ServerGlobalVarsContext
+  >({}, 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 server code.`,
+          { cause: error },
+        );
+      }
+      if (serialized === undefined) {
+        throw new Error(
+          `source.globalVars["${key}"] cannot be serialized exactly for BFF server code.`,
+        );
+      }
+      return [key, serialized];
+    }),
+  );
+};