@bleedingdev/modern-js-bff-effect 3.9.0-ultramodern.17 → 3.9.0-ultramodern.18

package/dist/cjs/effect/context.js

@@ -28,28 +28,52 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
+    EFFECT_BFF_CONTEXT_STORAGE_SHARE: ()=>EFFECT_BFF_CONTEXT_STORAGE_SHARE,
+    adoptEffectContextStorage: ()=>adoptEffectContextStorage,
     createEffectOperationContext: ()=>external_operation_context_js_namespaceObject.createEffectOperationContext,
+    getEffectContextStorage: ()=>getEffectContextStorage,
     runWithEffectContext: ()=>runWithEffectContext,
     useEffectContext: ()=>useEffectContext,
     useOperationContext: ()=>useOperationContext
 });
-const external_node_async_hooks_namespaceObject = require("node:async_hooks");
 const external_operation_context_js_namespaceObject = require("./operation-context.js");
 const globalStore = globalThis;
-const effectContextStorage = globalStore[external_operation_context_js_namespaceObject.kEffectContextStorage] ?? (globalStore[external_operation_context_js_namespaceObject.kEffectContextStorage] = new external_node_async_hooks_namespaceObject.AsyncLocalStorage());
-const runWithEffectContext = (context, cb)=>effectContextStorage.run(context, cb);
+const asyncHooks = globalStore.process?.getBuiltinModule?.('node:async_hooks');
+const AsyncLocalStorage = asyncHooks?.AsyncLocalStorage;
+if ('function' != typeof AsyncLocalStorage) throw new Error('[BFF][Effect] The edge runtime must provide AsyncLocalStorage. Enable Node.js compatibility or the nodejs_als compatibility flag.');
+const EFFECT_BFF_CONTEXT_STORAGE_SHARE = '@modern-js/bff-effect/context-storage';
+let effectContextStorage = new AsyncLocalStorage();
+let effectContextStorageUsed = false;
+const usedEffectContextStorage = ()=>{
+    effectContextStorageUsed = true;
+    return effectContextStorage;
+};
+const runWithEffectContext = (context, cb)=>usedEffectContextStorage().run(context, cb);
 const useEffectContext = ()=>{
-    const context = effectContextStorage.getStore();
+    const context = usedEffectContextStorage().getStore();
     if (!context) throw new Error("Can't call useEffectContext out of Effect runtime scope");
     return context;
 };
+const getEffectContextStorage = ()=>effectContextStorage;
+function adoptEffectContextStorage(storage) {
+    const candidate = storage;
+    if ('function' != typeof candidate?.run || 'function' != typeof candidate.getStore) throw new Error(`[BFF][Effect] Share ${EFFECT_BFF_CONTEXT_STORAGE_SHARE} must provide an AsyncLocalStorage.`);
+    if (effectContextStorageUsed && candidate !== effectContextStorage) throw new Error('[BFF][Effect] A backend federation container received the host request storage after an Effect API already used its own. Evaluate exposes only after container init().');
+    effectContextStorage = candidate;
+}
 const useOperationContext = ()=>useEffectContext().operationContext;
+exports.EFFECT_BFF_CONTEXT_STORAGE_SHARE = __webpack_exports__.EFFECT_BFF_CONTEXT_STORAGE_SHARE;
+exports.adoptEffectContextStorage = __webpack_exports__.adoptEffectContextStorage;
 exports.createEffectOperationContext = __webpack_exports__.createEffectOperationContext;
+exports.getEffectContextStorage = __webpack_exports__.getEffectContextStorage;
 exports.runWithEffectContext = __webpack_exports__.runWithEffectContext;
 exports.useEffectContext = __webpack_exports__.useEffectContext;
 exports.useOperationContext = __webpack_exports__.useOperationContext;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "EFFECT_BFF_CONTEXT_STORAGE_SHARE",
+    "adoptEffectContextStorage",
     "createEffectOperationContext",
+    "getEffectContextStorage",
     "runWithEffectContext",
     "useEffectContext",
     "useOperationContext"

package/dist/cjs/effect/edge-dispatcher.js

@@ -93,15 +93,15 @@ __webpack_require__.d(__webpack_exports__, {
     defineEffectBff: ()=>external_handler_js_namespaceObject.defineEffectBff,
     defineEffectRpcBff: ()=>external_handler_js_namespaceObject.defineEffectRpcBff,
     dispatchEffectBffRequest: ()=>dispatchEffectBffRequest,
-    runWithEffectContext: ()=>external_edge_context_js_namespaceObject.runWithEffectContext,
-    useEffectContext: ()=>external_edge_context_js_namespaceObject.useEffectContext,
-    useOperationContext: ()=>external_edge_context_js_namespaceObject.useOperationContext
+    runWithEffectContext: ()=>context_namespaceObject.runWithEffectContext,
+    useEffectContext: ()=>context_namespaceObject.useEffectContext,
+    useOperationContext: ()=>context_namespaceObject.useOperationContext
 });
+const context_namespaceObject = require("@modern-js/bff-effect/context");
 const bff_policy_namespaceObject = require("@modern-js/server-runtime-extensions/bff-policy");
 const Effect_namespaceObject = require("effect/Effect");
 const external_headers_js_namespaceObject = require("../headers.js");
 const external_dispatch_js_namespaceObject = require("./dispatch.js");
-const external_edge_context_js_namespaceObject = require("./edge-context.js");
 const external_module_js_namespaceObject = require("./module.js");
 const Config_namespaceObject = require("effect/Config");
 const Layer_namespaceObject = require("effect/Layer");
@@ -136,7 +136,7 @@ function restoreEffectBffMountPath(request, prefix) {
 async function dispatchEffectBffRequest(handler, request, options = {}) {
     return (0, external_dispatch_js_namespaceObject.dispatchEffectBffRequestWithContext)(handler, request, {
         ...options,
-        runWithEffectContext: external_edge_context_js_namespaceObject.runWithEffectContext
+        runWithEffectContext: context_namespaceObject.runWithEffectContext
     });
 }
 async function createEffectBffEdgeDispatcher(options) {

package/dist/cjs/effect/edge.js

@@ -3,8 +3,14 @@ var __webpack_modules__ = {
     "./edge-dispatcher" (module) {
         module.exports = require("./edge-dispatcher.js");
     },
+    "./entry-shape" (module) {
+        module.exports = require("./entry-shape.js");
+    },
     "./generated-entry" (module) {
         module.exports = require("./generated-entry.js");
+    },
+    "@modern-js/bff-effect/context" (module) {
+        module.exports = require("@modern-js/bff-effect/context");
     }
 };
 var __webpack_module_cache__ = {};
@@ -54,20 +60,34 @@ function __webpack_require__(moduleId) {
 var __webpack_exports__ = {};
 (()=>{
     __webpack_require__.r(__webpack_exports__);
-    var _edge_dispatcher__rspack_import_0 = __webpack_require__("./edge-dispatcher");
+    var _modern_js_bff_effect_context__rspack_import_0 = __webpack_require__("@modern-js/bff-effect/context");
+    var _edge_dispatcher__rspack_import_1 = __webpack_require__("./edge-dispatcher");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _edge_dispatcher__rspack_import_0)if ([
+    for(const __rspack_import_key in _edge_dispatcher__rspack_import_1)if ([
+        "EFFECT_BFF_CONTEXT_STORAGE_SHARE",
+        "default",
+        "EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE",
         "createEffectBffEdgeDispatcherFactory",
-        "default"
-    ].indexOf(__rspack_import_key) < 0) __rspack_reexport[__rspack_import_key] = ()=>_edge_dispatcher__rspack_import_0[__rspack_import_key];
+        "adoptEffectBffShareScope"
+    ].indexOf(__rspack_import_key) < 0) __rspack_reexport[__rspack_import_key] = ()=>_edge_dispatcher__rspack_import_1[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _generated_entry__rspack_import_1 = __webpack_require__("./generated-entry");
+    var _entry_shape__rspack_import_2 = __webpack_require__("./entry-shape");
+    var _generated_entry__rspack_import_3 = __webpack_require__("./generated-entry");
     __webpack_require__.d(__webpack_exports__, {
-        createEffectBffEdgeDispatcherFactory: ()=>_generated_entry__rspack_import_1.createEffectBffEdgeDispatcherFactory
+        EFFECT_BFF_CONTEXT_STORAGE_SHARE: ()=>_modern_js_bff_effect_context__rspack_import_0.EFFECT_BFF_CONTEXT_STORAGE_SHARE,
+        EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE: ()=>_entry_shape__rspack_import_2.EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE,
+        adoptEffectBffShareScope: ()=>_entry_shape__rspack_import_2.adoptEffectBffShareScope,
+        createEffectBffEdgeDispatcherFactory: ()=>_generated_entry__rspack_import_3.createEffectBffEdgeDispatcherFactory
     });
 })();
+exports.EFFECT_BFF_CONTEXT_STORAGE_SHARE = __webpack_exports__.EFFECT_BFF_CONTEXT_STORAGE_SHARE;
+exports.EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE = __webpack_exports__.EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE;
+exports.adoptEffectBffShareScope = __webpack_exports__.adoptEffectBffShareScope;
 exports.createEffectBffEdgeDispatcherFactory = __webpack_exports__.createEffectBffEdgeDispatcherFactory;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "EFFECT_BFF_CONTEXT_STORAGE_SHARE",
+    "EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE",
+    "adoptEffectBffShareScope",
     "createEffectBffEdgeDispatcherFactory"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {

package/dist/cjs/effect/entry-shape.js

@@ -30,6 +30,16 @@ var __webpack_require__ = {};
 })();
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE: ()=>EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE,
+    adoptEffectBffShareScope: ()=>adoptEffectBffShareScope,
+    classifyEffectBffEntryModule: ()=>classifyEffectBffEntryModule,
+    isValidatorAwareHandlerFactory: ()=>isValidatorAwareHandlerFactory,
+    registerValidatorAwareHandlerFactory: ()=>registerValidatorAwareHandlerFactory,
+    strictEffectApproachMessage: ()=>strictEffectApproachMessage
+});
+const context_namespaceObject = require("@modern-js/bff-effect/context");
+const EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE = '@modern-js/bff-effect/handler-factory-registry';
 function createLocalValidatorAwareHandlerFactoryRegistry() {
     const factories = new WeakSet();
     return {
@@ -44,10 +54,7 @@ function createLocalValidatorAwareHandlerFactoryRegistry() {
 }
 function loadNodeValidatorAwareHandlerFactoryRegistry() {
     const moduleUrl = __rslib_import_meta_url__;
-    if ('string' != typeof moduleUrl || !moduleUrl.startsWith('file:')) {
-        if ("u" > typeof __modernjs_backend_private_capability__) return __modernjs_backend_private_capability__;
-        return createLocalValidatorAwareHandlerFactoryRegistry();
-    }
+    if ('string' != typeof moduleUrl || !moduleUrl.startsWith('file:')) return createLocalValidatorAwareHandlerFactoryRegistry();
     const moduleBuiltin = process.getBuiltinModule('node:module');
     try {
         return moduleBuiltin.createRequire(moduleUrl)("#effect-entry-shape-registry");
@@ -56,12 +63,33 @@ function loadNodeValidatorAwareHandlerFactoryRegistry() {
         throw error;
     }
 }
-const validatorAwareHandlerFactoryRegistry = loadNodeValidatorAwareHandlerFactoryRegistry();
+let validatorAwareHandlerFactoryRegistry;
+function handlerFactoryRegistry() {
+    validatorAwareHandlerFactoryRegistry ??= loadNodeValidatorAwareHandlerFactoryRegistry();
+    return validatorAwareHandlerFactoryRegistry;
+}
+const adoptShared = (shareScope, name, adopt)=>{
+    const versions = 'object' == typeof shareScope && null !== shareScope ? shareScope[name] : void 0;
+    const shared = void 0 === versions ? void 0 : Object.values(versions)[0];
+    if ('function' != typeof shared?.get) return Promise.resolve();
+    return Promise.resolve(shared.get()).then((factory)=>adopt('function' == typeof factory ? factory() : void 0));
+};
+function adoptEffectBffShareScope(shareScope) {
+    return Promise.all([
+        adoptShared(shareScope, EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE, (registry)=>adoptHandlerFactoryRegistry(registry)),
+        adoptShared(shareScope, context_namespaceObject.EFFECT_BFF_CONTEXT_STORAGE_SHARE, context_namespaceObject.adoptEffectContextStorage)
+    ]).then(()=>void 0);
+}
+function adoptHandlerFactoryRegistry(registry) {
+    if ('function' != typeof registry?.register || 'function' != typeof registry.is) throw new Error(`[BFF][Effect] Share ${EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE} must provide a handler factory registry.`);
+    if (void 0 !== validatorAwareHandlerFactoryRegistry && validatorAwareHandlerFactoryRegistry !== registry) throw new Error('[BFF][Effect] A backend federation container received the host handler factory registry after an Effect API already used its own. Evaluate exposes only after container init().');
+    validatorAwareHandlerFactoryRegistry = registry;
+}
 function registerValidatorAwareHandlerFactory(factory) {
-    return validatorAwareHandlerFactoryRegistry.register(factory);
+    return handlerFactoryRegistry().register(factory);
 }
 function isValidatorAwareHandlerFactory(factory) {
-    return validatorAwareHandlerFactoryRegistry.is(factory);
+    return handlerFactoryRegistry().is(factory);
 }
 const strictEffectApproachMessage = '[BFF][Effect] strictEffectApproach is enforced: Effect API entries export defineEffectBff(...) or { api, layer } HttpApi module. Raw handler exports, default request handlers, unbranded custom createHandler factories not valid Effect API entries.';
 function isEffectEntryRecord(value) {
@@ -94,18 +122,15 @@ function createEntryShapeFacts(module, predicates, unsupportedShape) {
         hasRuntimeLayer
     };
 }
-__webpack_require__.d(__webpack_exports__, {
-    classifyEffectBffEntryModule: ()=>classifyEffectBffEntryModule,
-    isValidatorAwareHandlerFactory: ()=>isValidatorAwareHandlerFactory,
-    registerValidatorAwareHandlerFactory: ()=>registerValidatorAwareHandlerFactory
-}, {
-    strictEffectApproachMessage: strictEffectApproachMessage
-});
+exports.EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE = __webpack_exports__.EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE;
+exports.adoptEffectBffShareScope = __webpack_exports__.adoptEffectBffShareScope;
 exports.classifyEffectBffEntryModule = __webpack_exports__.classifyEffectBffEntryModule;
 exports.isValidatorAwareHandlerFactory = __webpack_exports__.isValidatorAwareHandlerFactory;
 exports.registerValidatorAwareHandlerFactory = __webpack_exports__.registerValidatorAwareHandlerFactory;
 exports.strictEffectApproachMessage = __webpack_exports__.strictEffectApproachMessage;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE",
+    "adoptEffectBffShareScope",
     "classifyEffectBffEntryModule",
     "isValidatorAwareHandlerFactory",
     "registerValidatorAwareHandlerFactory",

package/dist/cjs/effect/index.js

@@ -1,8 +1,5 @@
 "use strict";
 var __webpack_modules__ = {
-    "./context" (module) {
-        module.exports = require("./context.js");
-    },
     "./edge" (module) {
         module.exports = require("./edge.js");
     },
@@ -17,6 +14,9 @@ var __webpack_modules__ = {
     },
     "@effect/opentelemetry" (module) {
         module.exports = require("@effect/opentelemetry");
+    },
+    "@modern-js/bff-effect/context" (module) {
+        module.exports = require("@modern-js/bff-effect/context");
     }
 };
 var __webpack_module_cache__ = {};
@@ -67,7 +67,7 @@ var __webpack_exports__ = {};
 (()=>{
     __webpack_require__.r(__webpack_exports__);
     var _effect_opentelemetry__rspack_import_0 = __webpack_require__("@effect/opentelemetry");
-    var _context__rspack_import_1 = __webpack_require__("./context");
+    var _modern_js_bff_effect_context__rspack_import_1 = __webpack_require__("@modern-js/bff-effect/context");
     var _edge__rspack_import_2 = __webpack_require__("./edge");
     var _endpoint_contracts__rspack_import_3 = __webpack_require__("./endpoint-contracts");
     var __rspack_reexport = {};
@@ -104,12 +104,12 @@ var __webpack_exports__ = {};
         OpenTelemetry: ()=>_effect_opentelemetry__rspack_import_0,
         createEffectBffEdgeHandler: ()=>_edge__rspack_import_2.createEffectBffEdgeHandler,
         createEffectBffTestHandler: ()=>_edge__rspack_import_2.createEffectBffTestHandler,
-        createEffectOperationContext: ()=>_context__rspack_import_1.createEffectOperationContext,
+        createEffectOperationContext: ()=>_modern_js_bff_effect_context__rspack_import_1.createEffectOperationContext,
         dispatchEffectBffRequest: ()=>_edge__rspack_import_2.dispatchEffectBffRequest,
         resolveEffectBffModuleHandler: ()=>_module__rspack_import_5.resolveEffectBffModuleHandler,
-        runWithEffectContext: ()=>_context__rspack_import_1.runWithEffectContext,
-        useEffectContext: ()=>_context__rspack_import_1.useEffectContext,
-        useOperationContext: ()=>_context__rspack_import_1.useOperationContext
+        runWithEffectContext: ()=>_modern_js_bff_effect_context__rspack_import_1.runWithEffectContext,
+        useEffectContext: ()=>_modern_js_bff_effect_context__rspack_import_1.useEffectContext,
+        useOperationContext: ()=>_modern_js_bff_effect_context__rspack_import_1.useOperationContext
     });
 })();
 exports.OpenTelemetry = __webpack_exports__.OpenTelemetry;

package/dist/cjs/effect/operation-context.js

@@ -28,11 +28,9 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    createEffectOperationContext: ()=>createEffectOperationContext,
-    kEffectContextStorage: ()=>kEffectContextStorage
+    createEffectOperationContext: ()=>createEffectOperationContext
 });
 const request_context_namespaceObject = require("@modern-js/runtime-extensions/request-context");
-const kEffectContextStorage = Symbol.for('modernjs.plugin-bff.effectContextStorage');
 const readHeader = (headers, header)=>{
     const value = headers.get(header);
     return value && value.length > 0 ? value : void 0;
@@ -106,10 +104,8 @@ const createEffectOperationContext = ({ request, path, method })=>{
     };
 };
 exports.createEffectOperationContext = __webpack_exports__.createEffectOperationContext;
-exports.kEffectContextStorage = __webpack_exports__.kEffectContextStorage;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
-    "createEffectOperationContext",
-    "kEffectContextStorage"
+    "createEffectOperationContext"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true

package/dist/esm/effect/context.mjs

@@ -1,12 +1,27 @@
-import { AsyncLocalStorage } from "node:async_hooks";
-import { createEffectOperationContext, kEffectContextStorage } from "./operation-context.mjs";
 const globalStore = globalThis;
-const effectContextStorage = globalStore[kEffectContextStorage] ?? (globalStore[kEffectContextStorage] = new AsyncLocalStorage());
-const runWithEffectContext = (context, cb)=>effectContextStorage.run(context, cb);
+const asyncHooks = globalStore.process?.getBuiltinModule?.('node:async_hooks');
+const AsyncLocalStorage = asyncHooks?.AsyncLocalStorage;
+if ('function' != typeof AsyncLocalStorage) throw new Error('[BFF][Effect] The edge runtime must provide AsyncLocalStorage. Enable Node.js compatibility or the nodejs_als compatibility flag.');
+const EFFECT_BFF_CONTEXT_STORAGE_SHARE = '@modern-js/bff-effect/context-storage';
+let effectContextStorage = new AsyncLocalStorage();
+let effectContextStorageUsed = false;
+const usedEffectContextStorage = ()=>{
+    effectContextStorageUsed = true;
+    return effectContextStorage;
+};
+const runWithEffectContext = (context, cb)=>usedEffectContextStorage().run(context, cb);
 const useEffectContext = ()=>{
-    const context = effectContextStorage.getStore();
+    const context = usedEffectContextStorage().getStore();
     if (!context) throw new Error("Can't call useEffectContext out of Effect runtime scope");
     return context;
 };
+const getEffectContextStorage = ()=>effectContextStorage;
+function adoptEffectContextStorage(storage) {
+    const candidate = storage;
+    if ('function' != typeof candidate?.run || 'function' != typeof candidate.getStore) throw new Error(`[BFF][Effect] Share ${EFFECT_BFF_CONTEXT_STORAGE_SHARE} must provide an AsyncLocalStorage.`);
+    if (effectContextStorageUsed && candidate !== effectContextStorage) throw new Error('[BFF][Effect] A backend federation container received the host request storage after an Effect API already used its own. Evaluate exposes only after container init().');
+    effectContextStorage = candidate;
+}
 const useOperationContext = ()=>useEffectContext().operationContext;
-export { createEffectOperationContext, runWithEffectContext, useEffectContext, useOperationContext };
+export { createEffectOperationContext } from "./operation-context.mjs";
+export { EFFECT_BFF_CONTEXT_STORAGE_SHARE, adoptEffectContextStorage, getEffectContextStorage, runWithEffectContext, useEffectContext, useOperationContext };

package/dist/esm/effect/edge-dispatcher.mjs

@@ -1,8 +1,8 @@
+import { runWithEffectContext, useEffectContext, useOperationContext } from "@modern-js/bff-effect/context";
 import { evaluateCrossProjectPolicy, resolveCrossProjectRequestObservation } from "@modern-js/server-runtime-extensions/bff-policy";
 import * as __rspack_external_effect_Effect_41060786 from "effect/Effect";
 import { toHeaderRecord } from "../headers.mjs";
 import { dispatchEffectBffRequestWithContext } from "./dispatch.mjs";
-import { runWithEffectContext, useEffectContext, useOperationContext } from "./edge-context.mjs";
 import { resolveEffectBffModuleHandler } from "./module.mjs";
 import * as __rspack_external_effect_Config_76cfa59d from "effect/Config";
 import * as __rspack_external_effect_Layer_69c46453 from "effect/Layer";

package/dist/esm/effect/edge.mjs

@@ -1,2 +1,4 @@
 export * from "./edge-dispatcher.mjs";
+export { EFFECT_BFF_CONTEXT_STORAGE_SHARE } from "@modern-js/bff-effect/context";
+export { EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE, adoptEffectBffShareScope } from "./entry-shape.mjs";
 export { createEffectBffEdgeDispatcherFactory } from "./generated-entry.mjs";

package/dist/esm/effect/entry-shape.mjs

@@ -1,3 +1,5 @@
+import { EFFECT_BFF_CONTEXT_STORAGE_SHARE, adoptEffectContextStorage } from "@modern-js/bff-effect/context";
+const EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE = '@modern-js/bff-effect/handler-factory-registry';
 function createLocalValidatorAwareHandlerFactoryRegistry() {
     const factories = new WeakSet();
     return {
@@ -10,12 +12,33 @@ function createLocalValidatorAwareHandlerFactoryRegistry() {
         }
     };
 }
-const validatorAwareHandlerFactoryRegistry = createLocalValidatorAwareHandlerFactoryRegistry();
+let validatorAwareHandlerFactoryRegistry;
+function handlerFactoryRegistry() {
+    validatorAwareHandlerFactoryRegistry ??= createLocalValidatorAwareHandlerFactoryRegistry();
+    return validatorAwareHandlerFactoryRegistry;
+}
+const adoptShared = (shareScope, name, adopt)=>{
+    const versions = 'object' == typeof shareScope && null !== shareScope ? shareScope[name] : void 0;
+    const shared = void 0 === versions ? void 0 : Object.values(versions)[0];
+    if ('function' != typeof shared?.get) return Promise.resolve();
+    return Promise.resolve(shared.get()).then((factory)=>adopt('function' == typeof factory ? factory() : void 0));
+};
+function adoptEffectBffShareScope(shareScope) {
+    return Promise.all([
+        adoptShared(shareScope, EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE, (registry)=>adoptHandlerFactoryRegistry(registry)),
+        adoptShared(shareScope, EFFECT_BFF_CONTEXT_STORAGE_SHARE, adoptEffectContextStorage)
+    ]).then(()=>void 0);
+}
+function adoptHandlerFactoryRegistry(registry) {
+    if ('function' != typeof registry?.register || 'function' != typeof registry.is) throw new Error(`[BFF][Effect] Share ${EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE} must provide a handler factory registry.`);
+    if (void 0 !== validatorAwareHandlerFactoryRegistry && validatorAwareHandlerFactoryRegistry !== registry) throw new Error('[BFF][Effect] A backend federation container received the host handler factory registry after an Effect API already used its own. Evaluate exposes only after container init().');
+    validatorAwareHandlerFactoryRegistry = registry;
+}
 function registerValidatorAwareHandlerFactory(factory) {
-    return validatorAwareHandlerFactoryRegistry.register(factory);
+    return handlerFactoryRegistry().register(factory);
 }
 function isValidatorAwareHandlerFactory(factory) {
-    return validatorAwareHandlerFactoryRegistry.is(factory);
+    return handlerFactoryRegistry().is(factory);
 }
 const strictEffectApproachMessage = '[BFF][Effect] strictEffectApproach is enforced: Effect API entries export defineEffectBff(...) or { api, layer } HttpApi module. Raw handler exports, default request handlers, unbranded custom createHandler factories not valid Effect API entries.';
 function isEffectEntryRecord(value) {
@@ -48,4 +71,4 @@ function createEntryShapeFacts(module, predicates, unsupportedShape) {
         hasRuntimeLayer
     };
 }
-export { classifyEffectBffEntryModule, isValidatorAwareHandlerFactory, registerValidatorAwareHandlerFactory, strictEffectApproachMessage };
+export { EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE, adoptEffectBffShareScope, classifyEffectBffEntryModule, isValidatorAwareHandlerFactory, registerValidatorAwareHandlerFactory, strictEffectApproachMessage };

package/dist/esm/effect/index.mjs

@@ -1,7 +1,7 @@
 import * as __rspack_external__effect_opentelemetry_66324c75 from "@effect/opentelemetry";
 export * from "./endpoint-contracts.mjs";
 export * from "./handler.mjs";
-export { createEffectOperationContext, runWithEffectContext, useEffectContext, useOperationContext } from "./context.mjs";
+export { createEffectOperationContext, runWithEffectContext, useEffectContext, useOperationContext } from "@modern-js/bff-effect/context";
 export { createEffectBffEdgeHandler, createEffectBffTestHandler, dispatchEffectBffRequest } from "./edge.mjs";
 export { resolveEffectBffModuleHandler } from "./module.mjs";
 export { __rspack_external__effect_opentelemetry_66324c75 as OpenTelemetry };

package/dist/esm/effect/operation-context.mjs

@@ -1,5 +1,4 @@
 import { BFF_LOCALE_HEADER, BFF_OPERATION_CONTEXT_DETAIL_HEADER, BFF_OPERATION_CONTEXT_HEADER, BFF_TRACEPARENT_HEADER, parseTraceparent } from "@modern-js/runtime-extensions/request-context";
-const kEffectContextStorage = Symbol.for('modernjs.plugin-bff.effectContextStorage');
 const readHeader = (headers, header)=>{
     const value = headers.get(header);
     return value && value.length > 0 ? value : void 0;
@@ -72,4 +71,4 @@ const createEffectOperationContext = ({ request, path, method })=>{
         } : {}
     };
 };
-export { createEffectOperationContext, kEffectContextStorage };
+export { createEffectOperationContext };

package/dist/esm-node/effect/context.mjs

@@ -1,13 +1,28 @@
 import "node:module";
-import { AsyncLocalStorage } from "node:async_hooks";
-import { createEffectOperationContext, kEffectContextStorage } from "./operation-context.mjs";
 const globalStore = globalThis;
-const effectContextStorage = globalStore[kEffectContextStorage] ?? (globalStore[kEffectContextStorage] = new AsyncLocalStorage());
-const runWithEffectContext = (context, cb)=>effectContextStorage.run(context, cb);
+const asyncHooks = globalStore.process?.getBuiltinModule?.('node:async_hooks');
+const AsyncLocalStorage = asyncHooks?.AsyncLocalStorage;
+if ('function' != typeof AsyncLocalStorage) throw new Error('[BFF][Effect] The edge runtime must provide AsyncLocalStorage. Enable Node.js compatibility or the nodejs_als compatibility flag.');
+const EFFECT_BFF_CONTEXT_STORAGE_SHARE = '@modern-js/bff-effect/context-storage';
+let effectContextStorage = new AsyncLocalStorage();
+let effectContextStorageUsed = false;
+const usedEffectContextStorage = ()=>{
+    effectContextStorageUsed = true;
+    return effectContextStorage;
+};
+const runWithEffectContext = (context, cb)=>usedEffectContextStorage().run(context, cb);
 const useEffectContext = ()=>{
-    const context = effectContextStorage.getStore();
+    const context = usedEffectContextStorage().getStore();
     if (!context) throw new Error("Can't call useEffectContext out of Effect runtime scope");
     return context;
 };
+const getEffectContextStorage = ()=>effectContextStorage;
+function adoptEffectContextStorage(storage) {
+    const candidate = storage;
+    if ('function' != typeof candidate?.run || 'function' != typeof candidate.getStore) throw new Error(`[BFF][Effect] Share ${EFFECT_BFF_CONTEXT_STORAGE_SHARE} must provide an AsyncLocalStorage.`);
+    if (effectContextStorageUsed && candidate !== effectContextStorage) throw new Error('[BFF][Effect] A backend federation container received the host request storage after an Effect API already used its own. Evaluate exposes only after container init().');
+    effectContextStorage = candidate;
+}
 const useOperationContext = ()=>useEffectContext().operationContext;
-export { createEffectOperationContext, runWithEffectContext, useEffectContext, useOperationContext };
+export { createEffectOperationContext } from "./operation-context.mjs";
+export { EFFECT_BFF_CONTEXT_STORAGE_SHARE, adoptEffectContextStorage, getEffectContextStorage, runWithEffectContext, useEffectContext, useOperationContext };

package/dist/esm-node/effect/edge-dispatcher.mjs

@@ -1,9 +1,9 @@
 import "node:module";
+import { runWithEffectContext, useEffectContext, useOperationContext } from "@modern-js/bff-effect/context";
 import { evaluateCrossProjectPolicy, resolveCrossProjectRequestObservation } from "@modern-js/server-runtime-extensions/bff-policy";
 import * as __rspack_external_effect_Effect_41060786 from "effect/Effect";
 import { toHeaderRecord } from "../headers.mjs";
 import { dispatchEffectBffRequestWithContext } from "./dispatch.mjs";
-import { runWithEffectContext, useEffectContext, useOperationContext } from "./edge-context.mjs";
 import { resolveEffectBffModuleHandler } from "./module.mjs";
 import * as __rspack_external_effect_Config_76cfa59d from "effect/Config";
 import * as __rspack_external_effect_Layer_69c46453 from "effect/Layer";

package/dist/esm-node/effect/edge.mjs

@@ -1,3 +1,5 @@
 import "node:module";
 export * from "./edge-dispatcher.mjs";
+export { EFFECT_BFF_CONTEXT_STORAGE_SHARE } from "@modern-js/bff-effect/context";
+export { EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE, adoptEffectBffShareScope } from "./entry-shape.mjs";
 export { createEffectBffEdgeDispatcherFactory } from "./generated-entry.mjs";

package/dist/esm-node/effect/entry-shape.mjs

@@ -1,4 +1,6 @@
 import "node:module";
+import { EFFECT_BFF_CONTEXT_STORAGE_SHARE, adoptEffectContextStorage } from "@modern-js/bff-effect/context";
+const EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE = '@modern-js/bff-effect/handler-factory-registry';
 function createLocalValidatorAwareHandlerFactoryRegistry() {
     const factories = new WeakSet();
     return {
@@ -13,10 +15,7 @@ function createLocalValidatorAwareHandlerFactoryRegistry() {
 }
 function loadNodeValidatorAwareHandlerFactoryRegistry() {
     const moduleUrl = import.meta.url;
-    if ('string' != typeof moduleUrl || !moduleUrl.startsWith('file:')) {
-        if ("u" > typeof __modernjs_backend_private_capability__) return __modernjs_backend_private_capability__;
-        return createLocalValidatorAwareHandlerFactoryRegistry();
-    }
+    if ('string' != typeof moduleUrl || !moduleUrl.startsWith('file:')) return createLocalValidatorAwareHandlerFactoryRegistry();
     const moduleBuiltin = process.getBuiltinModule('node:module');
     try {
         return moduleBuiltin.createRequire(moduleUrl)("#effect-entry-shape-registry");
@@ -25,12 +24,33 @@ function loadNodeValidatorAwareHandlerFactoryRegistry() {
         throw error;
     }
 }
-const validatorAwareHandlerFactoryRegistry = loadNodeValidatorAwareHandlerFactoryRegistry();
+let validatorAwareHandlerFactoryRegistry;
+function handlerFactoryRegistry() {
+    validatorAwareHandlerFactoryRegistry ??= loadNodeValidatorAwareHandlerFactoryRegistry();
+    return validatorAwareHandlerFactoryRegistry;
+}
+const adoptShared = (shareScope, name, adopt)=>{
+    const versions = 'object' == typeof shareScope && null !== shareScope ? shareScope[name] : void 0;
+    const shared = void 0 === versions ? void 0 : Object.values(versions)[0];
+    if ('function' != typeof shared?.get) return Promise.resolve();
+    return Promise.resolve(shared.get()).then((factory)=>adopt('function' == typeof factory ? factory() : void 0));
+};
+function adoptEffectBffShareScope(shareScope) {
+    return Promise.all([
+        adoptShared(shareScope, EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE, (registry)=>adoptHandlerFactoryRegistry(registry)),
+        adoptShared(shareScope, EFFECT_BFF_CONTEXT_STORAGE_SHARE, adoptEffectContextStorage)
+    ]).then(()=>void 0);
+}
+function adoptHandlerFactoryRegistry(registry) {
+    if ('function' != typeof registry?.register || 'function' != typeof registry.is) throw new Error(`[BFF][Effect] Share ${EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE} must provide a handler factory registry.`);
+    if (void 0 !== validatorAwareHandlerFactoryRegistry && validatorAwareHandlerFactoryRegistry !== registry) throw new Error('[BFF][Effect] A backend federation container received the host handler factory registry after an Effect API already used its own. Evaluate exposes only after container init().');
+    validatorAwareHandlerFactoryRegistry = registry;
+}
 function registerValidatorAwareHandlerFactory(factory) {
-    return validatorAwareHandlerFactoryRegistry.register(factory);
+    return handlerFactoryRegistry().register(factory);
 }
 function isValidatorAwareHandlerFactory(factory) {
-    return validatorAwareHandlerFactoryRegistry.is(factory);
+    return handlerFactoryRegistry().is(factory);
 }
 const strictEffectApproachMessage = '[BFF][Effect] strictEffectApproach is enforced: Effect API entries export defineEffectBff(...) or { api, layer } HttpApi module. Raw handler exports, default request handlers, unbranded custom createHandler factories not valid Effect API entries.';
 function isEffectEntryRecord(value) {
@@ -63,4 +83,4 @@ function createEntryShapeFacts(module, predicates, unsupportedShape) {
         hasRuntimeLayer
     };
 }
-export { classifyEffectBffEntryModule, isValidatorAwareHandlerFactory, registerValidatorAwareHandlerFactory, strictEffectApproachMessage };
+export { EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE, adoptEffectBffShareScope, classifyEffectBffEntryModule, isValidatorAwareHandlerFactory, registerValidatorAwareHandlerFactory, strictEffectApproachMessage };

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

@@ -2,7 +2,7 @@ import "node:module";
 import * as __rspack_external__effect_opentelemetry_66324c75 from "@effect/opentelemetry";
 export * from "./endpoint-contracts.mjs";
 export * from "./handler.mjs";
-export { createEffectOperationContext, runWithEffectContext, useEffectContext, useOperationContext } from "./context.mjs";
+export { createEffectOperationContext, runWithEffectContext, useEffectContext, useOperationContext } from "@modern-js/bff-effect/context";
 export { createEffectBffEdgeHandler, createEffectBffTestHandler, dispatchEffectBffRequest } from "./edge.mjs";
 export { resolveEffectBffModuleHandler } from "./module.mjs";
 export { __rspack_external__effect_opentelemetry_66324c75 as OpenTelemetry };

package/dist/esm-node/effect/operation-context.mjs

@@ -1,6 +1,5 @@
 import "node:module";
 import { BFF_LOCALE_HEADER, BFF_OPERATION_CONTEXT_DETAIL_HEADER, BFF_OPERATION_CONTEXT_HEADER, BFF_TRACEPARENT_HEADER, parseTraceparent } from "@modern-js/runtime-extensions/request-context";
-const kEffectContextStorage = Symbol.for('modernjs.plugin-bff.effectContextStorage');
 const readHeader = (headers, header)=>{
     const value = headers.get(header);
     return value && value.length > 0 ? value : void 0;
@@ -73,4 +72,4 @@ const createEffectOperationContext = ({ request, path, method })=>{
         } : {}
     };
 };
-export { createEffectOperationContext, kEffectContextStorage };
+export { createEffectOperationContext };

package/dist/types/effect/context.d.ts

@@ -1,5 +1,18 @@
-import { type EffectContext } from './operation-context.js';
+import type { EffectContext, EffectContextStorage } from './operation-context.js';
 export { type CreateEffectOperationContextOptions, createEffectOperationContext, type EffectContext, } from './operation-context.js';
+/**
+ * Module Federation share through which a backend federation host hands its
+ * request storage to the containers it initializes.
+ */
+export declare const EFFECT_BFF_CONTEXT_STORAGE_SHARE = "@modern-js/bff-effect/context-storage";
 export declare const runWithEffectContext: <T>(context: EffectContext, cb: () => T) => T;
 export declare const useEffectContext: () => EffectContext;
+/** @internal The storage a backend federation host shares with containers. */
+export declare const getEffectContextStorage: () => EffectContextStorage;
+/**
+ * @internal Called through `adoptEffectBffShareScope()` from a backend
+ * federation container's `init()`, so its endpoints read the context the
+ * host dispatcher enters.
+ */
+export declare function adoptEffectContextStorage(storage: unknown): void;
 export declare const useOperationContext: () => import("@modern-js/runtime-extensions/request-context").OperationContext;

package/dist/types/effect/edge-dispatcher.d.ts

@@ -3,6 +3,7 @@ import { type DispatchEffectBffRequestOptions } from './dispatch.js';
 import type { EffectBffOpenApiConfig, EffectDataPlatformValidationOptions } from './handler.js';
 import { type EffectApiModule, type EffectBffRequestHandler } from './module.js';
 import type { EffectContext } from './operation-context.js';
+export { runWithEffectContext, useEffectContext, useOperationContext, } from './context.js';
 export * as Config from 'effect/Config';
 export * as Effect from 'effect/Effect';
 export * as Layer from 'effect/Layer';
@@ -11,7 +12,6 @@ export * as Schema from 'effect/Schema';
 export { Cookies, Etag, FetchHttpClient, FindMyWay, Headers, HttpBody, HttpClient, HttpClientError, HttpClientRequest, HttpClientResponse, HttpEffect, HttpIncomingMessage, HttpMethod, HttpMiddleware, HttpPlatform, HttpRouter, HttpServer, HttpServerError, HttpServerRequest, HttpServerRespondable, HttpServerResponse, HttpStaticServer, HttpStatus, HttpTraceContext, Multipart, MultipartParser, Template, Url, UrlParams, } from 'effect/unstable/http';
 export { HttpApi, HttpApiBuilder, HttpApiClient, HttpApiEndpoint, HttpApiError, HttpApiGroup, HttpApiMiddleware, HttpApiSchema, HttpApiSecurity, HttpApiTest, OpenApi, } from 'effect/unstable/httpapi';
 export { Rpc, RpcClient, RpcClientError, RpcGroup, RpcMessage, RpcMiddleware, RpcSchema, RpcSerialization, RpcServer, RpcTest, RpcWorker, Utils, } from 'effect/unstable/rpc';
-export { runWithEffectContext, useEffectContext, useOperationContext, } from './edge-context.js';
 export type { EffectApiClientFromApi, EffectBffDefinition, EffectBffHandlerFactory, EffectBffOpenApiConfig, EffectBffRuntime, EffectDataPlatformBatchOptions, EffectDataPlatformSelectionValidationOptions, EffectDataPlatformValidationOptions, EffectRequestValidator, EffectRpcBffDefinition, EffectRpcBffHandlerFactory, EffectRpcBffHandlerOptions, EffectRpcRuntimeLayer, EffectRpcSerialization, EffectRuntimeLayer, EffectRuntimeRequirements, } from './handler.js';
 export { createHttpApiHandler, defineEffectBff, defineEffectRpcBff, } from './handler.js';
 export { type CreateEffectOperationContextOptions, createEffectOperationContext, type EffectContext, } from './operation-context.js';

package/dist/types/effect/edge.d.ts

@@ -1,2 +1,4 @@
+export { EFFECT_BFF_CONTEXT_STORAGE_SHARE } from './context.js';
 export * from './edge-dispatcher.js';
+export { adoptEffectBffShareScope, EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE, } from './entry-shape.js';
 export { createEffectBffEdgeDispatcherFactory } from './generated-entry.js';