@bleedingdev/modern-js-bff-effect 3.9.0-ultramodern.2 → 3.9.0-ultramodern.21

package/dist/esm-node/effect/endpoint-contracts.mjs

@@ -1,9 +1,8 @@
 import "node:module";
-import { createOperationContractHash } from "@modern-js/bff-core";
+import { createOperationContractHash } from "@modern-js/server-runtime-extensions/bff-policy/node";
 import { classifyEffectBffEntryModule, isValidatorAwareHandlerFactory } from "./entry-shape.mjs";
 function resolveEffectEndpointName(endpoint) {
     if ('string' == typeof endpoint.identifier && endpoint.identifier) return endpoint.identifier;
-    if ('string' == typeof endpoint.name && endpoint.name) return endpoint.name;
     return '';
 }
 function ensureLeadingSlash(pathname) {
@@ -61,7 +60,7 @@ async function extractHttpApiFromModule(mod, isHttpApi) {
         isValidatorAwareHandlerFactory: isValidatorAwareHandlerFactory,
         isHttpApi
     });
-    return !facts?.legacyShape && facts?.api !== void 0 && facts.hasRuntimeLayer && (void 0 === facts.createHandler || facts.createHandlerValidatorAware) ? facts.api : null;
+    return !facts?.unsupportedShape && facts?.api !== void 0 && facts.hasRuntimeLayer && (void 0 === facts.createHandler || facts.createHandlerValidatorAware) ? facts.api : null;
 }
 function createEffectEndpointContractHash(endpoint, requestId) {
     return createOperationContractHash(createEffectOperationContractSource(endpoint), requestId);

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 {
@@ -22,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) {
@@ -46,13 +69,13 @@ function classifyEffectBffEntryModule(value, predicates) {
     if (predicates.isRequestHandler(module.handler)) return createEntryShapeFacts(module, predicates, '`handler` export');
     return createEntryShapeFacts(module, predicates);
 }
-function createEntryShapeFacts(module, predicates, legacyShape) {
+function createEntryShapeFacts(module, predicates, unsupportedShape) {
     const createHandler = 'function' == typeof module.createHandler ? module.createHandler : void 0;
     const api = predicates.isHttpApi(module.api) ? module.api : void 0;
     const hasRuntimeLayer = void 0 !== module.layer;
     return {
         module,
-        legacyShape,
+        unsupportedShape,
         createHandler,
         createHandlerValidatorAware: void 0 !== createHandler && predicates.isValidatorAwareHandlerFactory(createHandler),
         api,
@@ -60,4 +83,4 @@ function createEntryShapeFacts(module, predicates, legacyShape) {
         hasRuntimeLayer
     };
 }
-export { classifyEffectBffEntryModule, isValidatorAwareHandlerFactory, registerValidatorAwareHandlerFactory, strictEffectApproachMessage };
+export { EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE, adoptEffectBffShareScope, classifyEffectBffEntryModule, isValidatorAwareHandlerFactory, registerValidatorAwareHandlerFactory, strictEffectApproachMessage };

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

@@ -0,0 +1,20 @@
+import "node:module";
+import { createEffectBffEdgeDispatcher } from "./edge-dispatcher.mjs";
+function createEffectBffEdgeDispatcherFactory(module, generatedOperationContracts) {
+    return (options)=>{
+        const policy = options?.crossProjectPolicy;
+        const crossProjectPolicy = null == policy || null === policy.expectedOperationContracts || 'object' != typeof policy.expectedOperationContracts || Array.isArray(policy.expectedOperationContracts) ? policy : {
+            ...policy,
+            expectedOperationContracts: {
+                ...policy.expectedOperationContracts,
+                ...generatedOperationContracts
+            }
+        };
+        return createEffectBffEdgeDispatcher({
+            ...options,
+            crossProjectPolicy,
+            module
+        });
+    };
+}
+export { createEffectBffEdgeDispatcherFactory };

package/dist/esm-node/effect/handler/batch-handler.mjs

@@ -1,8 +1,10 @@
 import "node:module";
 import { DEFAULT_DATA_BATCH_HEADER, DEFAULT_DATA_ENVELOPE_HEADER, decodeRequestEnvelopeHeader, isPlainObject, normalizeMethod } from "../../data-platform/index.mjs";
+import { normalizeBatchLimits } from "../../data-platform/batch/options.mjs";
 import { decodeBatchBody, isBatchBody, toBatchResponseItem } from "../../data-platform/batch/protocol.mjs";
-import { BatchItemTimeoutError, createBatchValidationResponse, isBatchRequestPayload, mapWithConcurrency, normalizeBatchAllowedMethods, normalizeBatchPath, promiseWithTimeout, toBatchItemError } from "./batch.mjs";
+import { BatchItemTimeoutError, createBatchValidationResponse, isBatchRequestPayload, mapWithConcurrency, normalizeBatchPath, promiseWithTimeout, toBatchItemError } from "./batch.mjs";
 import { getMountedPrefixFromContext, removeMountedPrefixFromBatchPath } from "./routing.mjs";
+import * as __rspack_external_effect_Effect_41060786 from "effect/Effect";
 const HOP_BY_HOP_BATCH_ITEM_HEADERS = new Set([
     'connection',
     'keep-alive',
@@ -91,11 +93,9 @@ function createDataPlatformBatchRequestHandler(options) {
     const dataPlatformBatchOptions = options.dataPlatform?.batch;
     const batchEnabled = dataPlatformBatchOptions?.enabled !== false;
     const batchPath = normalizeBatchPath(dataPlatformBatchOptions?.endpoint);
-    const batchMaxSize = Math.max(1, dataPlatformBatchOptions?.maxBatchSize ?? 16);
-    const batchMaxBytes = Math.max(1024, dataPlatformBatchOptions?.maxBatchBytes ?? 65536);
+    const { maxBatchSize: batchMaxSize, maxBatchBytes: batchMaxBytes, allowedMethods: batchAllowedMethods } = normalizeBatchLimits(dataPlatformBatchOptions);
     const batchConcurrency = Math.max(1, dataPlatformBatchOptions?.maxConcurrency ?? 4);
     const batchItemTimeoutMs = Math.max(0, dataPlatformBatchOptions?.requestTimeoutMs ?? 10000);
-    const batchAllowedMethods = normalizeBatchAllowedMethods(dataPlatformBatchOptions?.allowedMethods);
     const envelopeHeader = options.dataPlatform?.envelopeHeader || DEFAULT_DATA_ENVELOPE_HEADER;
     const normalizedEnvelopeHeader = envelopeHeader.toLowerCase();
     const handle = async (request, context)=>{
@@ -185,25 +185,25 @@ function createDataPlatformBatchRequestHandler(options) {
                 return toBatchResponseItem(itemId, itemResponse, 'HEAD' === itemMethod);
             } catch (error) {
                 if (error instanceof BatchItemTimeoutError) {
-                    console.error({
+                    __rspack_external_effect_Effect_41060786.runSync(__rspack_external_effect_Effect_41060786.logError({
                         event: 'bff.batch.item.timeout',
                         batchId: payload.batchId,
                         itemId,
                         method: itemMethod,
                         path: itemPathname,
                         errorName: error.name
-                    });
+                    }));
                     return toBatchItemError(itemId, 504, 'Batch item request timed out');
                 }
                 if (error instanceof Response) return toBatchResponseItem(itemId, error, 'HEAD' === itemMethod);
-                console.error({
+                __rspack_external_effect_Effect_41060786.runSync(__rspack_external_effect_Effect_41060786.logError({
                     event: 'bff.batch.item.failure',
                     batchId: payload.batchId,
                     itemId,
                     method: itemMethod,
                     path: itemPathname,
                     errorName: error instanceof Error ? error.name : 'UnknownError'
-                });
+                }));
                 return toBatchItemError(itemId, 500, 'Internal Server Error');
             } finally{
                 request.signal.removeEventListener('abort', abortFromBatchRequest);

package/dist/esm-node/effect/handler/batch.mjs

@@ -1,17 +1,12 @@
 import "node:module";
 import { DEFAULT_DATA_BATCH_ENDPOINT, isPlainObject, normalizeMethod } from "../../data-platform/index.mjs";
 import { encodeBatchText } from "../../data-platform/batch/protocol.mjs";
+import * as __rspack_external_effect_Data_2b3f4efb from "effect/Data";
 function normalizeBatchPath(pathname) {
     if (!pathname || '/' === pathname) return DEFAULT_DATA_BATCH_ENDPOINT;
     if (!pathname.startsWith('/')) return `/${pathname}`;
     return pathname;
 }
-function normalizeBatchAllowedMethods(allowedMethods) {
-    const source = Array.isArray(allowedMethods) && allowedMethods.length > 0 ? allowedMethods : [
-        'GET'
-    ];
-    return new Set(source.map((method)=>method.toUpperCase()));
-}
 function isBatchRequestPayload(value) {
     return isPlainObject(value) && 2 === value.protocolVersion && 'string' == typeof value.batchId && 'number' == typeof value.sentAt && Array.isArray(value.items);
 }
@@ -65,7 +60,13 @@ function toBatchItemError(id, status, message) {
         }))
     };
 }
-class BatchItemTimeoutError extends Error {
+class BatchItemTimeoutError extends __rspack_external_effect_Data_2b3f4efb.TaggedError('BatchItemTimeoutError') {
+    constructor(message){
+        super({
+            message
+        });
+        this.name = 'Error';
+    }
 }
 function promiseWithTimeout(effect, timeoutMs, onTimeout) {
     if (timeoutMs <= 0) return effect;
@@ -103,4 +104,4 @@ async function mapWithConcurrency(items, concurrency, mapper) {
     return output;
 }
 export { toHeaderRecord } from "../../headers.mjs";
-export { BatchItemTimeoutError, createBatchValidationResponse, isBatchRequestPayload, mapWithConcurrency, normalizeBatchAllowedMethods, normalizeBatchPath, prepareJsonRequestBody, promiseWithTimeout, toBatchItemError };
+export { BatchItemTimeoutError, createBatchValidationResponse, isBatchRequestPayload, mapWithConcurrency, normalizeBatchPath, prepareJsonRequestBody, promiseWithTimeout, toBatchItemError };

package/dist/esm-node/effect/handler/definition.mjs

@@ -21,30 +21,10 @@ function defineEffectBff(definition) {
             validateRequest: options?.validateRequest
         });
     });
-    const client = createLoaderMaterializedClientPlaceholder();
     return {
         ...definition,
-        createHandler,
-        client
-    };
-}
-const LOADER_CLIENT_IGNORED_KEYS = new Set([
-    'then',
-    'catch',
-    'finally',
-    'toJSON',
-    '$$typeof'
-]);
-function createLoaderMaterializedClientPlaceholder() {
-    const explain = (property)=>{
-        throw new Error(`[BFF][Effect] client.${String(property)} is not available here: the typed client only exists when the API entry is imported through the "@api/index" transformed path (the BFF loader replaces it with generated client code). On the server, use HttpApiClient or call the Effect layer directly.`);
+        createHandler
     };
-    return new Proxy(Object.create(null), {
-        get (_target, property) {
-            if ('symbol' == typeof property || LOADER_CLIENT_IGNORED_KEYS.has(property)) return;
-            return explain(property);
-        }
-    });
 }
 function defineEffectRpcBff(definition) {
     const createHandler = (options)=>createRpcApiHandler({

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/module.mjs

@@ -12,7 +12,7 @@ function shareDispose(dispose) {
         return disposePromise;
     };
 }
-function rejectLegacyEffectModuleShape(options, shape) {
+function rejectUnsupportedEffectModuleShape(options, shape) {
     options.onWarning?.(`${strictEffectApproachMessage} Rejected ${shape}.`);
     return true;
 }
@@ -40,8 +40,12 @@ function classifyEffectBffRuntimeEntryShape(module) {
 }
 function resolveClassifiedEffectBffModuleHandler(facts, options = {}) {
     if (!facts) return null;
-    if (facts.legacyShape) {
-        if (rejectLegacyEffectModuleShape(options, facts.legacyShape)) return null;
+    if (facts.unsupportedShape) {
+        if (rejectUnsupportedEffectModuleShape(options, facts.unsupportedShape)) return null;
+    }
+    if (void 0 !== facts.module.rpc && !facts.createHandlerValidatorAware) {
+        rejectUnsupportedEffectModuleShape(options, 'unbranded RPC runtime');
+        return null;
     }
     if ('function' == typeof facts.createHandler) {
         if (facts.createHandlerValidatorAware) {
@@ -54,7 +58,7 @@ function resolveClassifiedEffectBffModuleHandler(facts, options = {}) {
             return createLoadedHandler(webHandler);
         }
         if (void 0 === facts.api || !facts.hasRuntimeLayer) {
-            rejectLegacyEffectModuleShape(options, 'unbranded `createHandler` export');
+            rejectUnsupportedEffectModuleShape(options, 'unbranded `createHandler` export');
             return null;
         }
         options.onWarning?.(`${strictEffectApproachMessage} Ignored unbranded \`createHandler\` export and rebuilt the handler from its { api, layer } exports.`);

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/create-request";
-const kEffectContextStorage = Symbol.for('modernjs.plugin-bff.effectContextStorage');
+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 readHeader = (headers, header)=>{
     const value = headers.get(header);
     return value && value.length > 0 ? value : void 0;
@@ -55,7 +54,7 @@ const createEffectOperationContext = ({ request, path, method })=>{
         } : {},
         routePath: servicePath,
         method: (method || request.method || 'GET').toUpperCase(),
-        source: 'effect-adapter',
+        source: 'effect-server',
         ...path && path !== servicePath ? {
             attributes: {
                 mountedPath: path
@@ -73,4 +72,4 @@ const createEffectOperationContext = ({ request, path, method })=>{
         } : {}
     };
 };
-export { createEffectOperationContext, kEffectContextStorage };
+export { createEffectOperationContext };

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

@@ -8,8 +8,6 @@ function getRpcSerializationLayer(serialization) {
             return RpcSerialization.layerJsonRpc();
         case 'ndJsonRpc':
             return RpcSerialization.layerNdJsonRpc();
-        case 'msgPack':
-            return RpcSerialization.layerMsgPack;
         default:
             return RpcSerialization.layerJsonRpc();
     }

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

@@ -0,0 +1,52 @@
+import "node:module";
+import { BFF_ENVELOPE_HEADER, BFF_OPERATION_CONTEXT_DETAIL_HEADER, BFF_OPERATION_CONTEXT_HEADER, digestOperationContract, resolveCrossProjectRequestObservation } from "@modern-js/server-runtime-extensions/bff-policy";
+import { HttpClient, HttpClientRequest } from "effect/unstable/http";
+import { HttpApi } from "effect/unstable/httpapi";
+import * as __rspack_external_effect_Effect_41060786 from "effect/Effect";
+import * as __rspack_external_effect_Schema_6065f72d from "effect/Schema";
+const encodeJson = __rspack_external_effect_Schema_6065f72d.encodeSync(__rspack_external_effect_Schema_6065f72d.fromJsonString(__rspack_external_effect_Schema_6065f72d.Unknown));
+function withCrossProjectPolicy(api, options, client) {
+    const contracts = {};
+    const prefix = options.prefix.replace(/\/$/, '');
+    HttpApi.reflect(api, {
+        onGroup: ()=>{},
+        onEndpoint: ({ endpoint })=>{
+            const routePath = `${prefix}${'/' === endpoint.path ? '' : endpoint.path}` || '/';
+            const name = endpoint.identifier;
+            contracts[`${endpoint.method}:${routePath}`] = {
+                operationId: `${options.requestId}:${name}`,
+                name,
+                method: endpoint.method,
+                routePath
+            };
+        }
+    });
+    return client.pipe(HttpClient.mapRequestEffect((request)=>{
+        const observed = resolveCrossProjectRequestObservation({
+            method: request.method,
+            pathname: new URL(request.url, 'http://effect.invalid').pathname
+        }, {
+            expectedOperationContracts: contracts
+        });
+        const contract = observed && contracts[`${observed.method}:${observed.routePath}`];
+        if (void 0 === contract) return __rspack_external_effect_Effect_41060786.die(new Error('[BFF][Effect] Request has no matching shared operation contract.'));
+        return __rspack_external_effect_Effect_41060786.gen(function*() {
+            const schemaHash = yield* __rspack_external_effect_Effect_41060786.promise(()=>digestOperationContract({
+                    httpMethod: contract.method,
+                    name: contract.name,
+                    routePath: contract.routePath
+                }, options.requestId));
+            return request.pipe(HttpClientRequest.setHeader(BFF_ENVELOPE_HEADER, encodeJson({
+                requestId: options.requestId
+            })), HttpClientRequest.setHeader(BFF_OPERATION_CONTEXT_HEADER, contract.operationId), HttpClientRequest.setHeader(BFF_OPERATION_CONTEXT_DETAIL_HEADER, encodeJson({
+                requestId: options.requestId,
+                operationId: contract.operationId,
+                method: contract.method,
+                routePath: contract.routePath,
+                schemaHash,
+                operationVersion: options.operationVersion
+            })));
+        });
+    }));
+}
+export { withCrossProjectPolicy };

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

@@ -1,11 +1,12 @@
 import "node:module";
-import { createRequestContextHeaders } from "@modern-js/create-request";
+import { createRequestContextHeaders } from "@modern-js/runtime-extensions/request-context";
 import * as __rspack_external_effect_Effect_41060786 from "effect/Effect";
 import * as __rspack_external_effect_Layer_69c46453 from "effect/Layer";
 import { FetchHttpClient, HttpClient, HttpClientRequest } from "effect/unstable/http";
 import { HttpApi, HttpApiClient, HttpApiEndpoint, HttpApiGroup, HttpApiSchema } from "effect/unstable/httpapi";
 import { Rpc, RpcClient, RpcGroup, RpcSchema, RpcSerialization } from "effect/unstable/rpc";
 import { getRpcSerializationLayer } from "../effect/rpcSerialization.mjs";
+import { withCrossProjectPolicy } from "./cross-project.mjs";
 import * as __rspack_external_effect_Schema_6065f72d from "effect/Schema";
 import * as __rspack_external_effect_unstable_http_HttpClientError_4b9eaee6 from "effect/unstable/http/HttpClientError";
 import * as __rspack_external_effect_Data_2b3f4efb from "effect/Data";
@@ -47,7 +48,8 @@ function makeEffectHttpApiClient(api, options) {
             for (const [header, value] of Object.entries(requestContextHeaders))if (void 0 === nextRequest.headers[header.toLowerCase()]) nextRequest = HttpClientRequest.setHeader(nextRequest, header, value);
             return nextRequest;
         }));
-        return 'function' == typeof options?.transformClient ? options.transformClient(contextClient) : contextClient;
+        const policyClient = options?.crossProject !== void 0 ? withCrossProjectPolicy(api, options.crossProject, contextClient) : contextClient;
+        return 'function' == typeof options?.transformClient ? options.transformClient(policyClient) : policyClient;
     };
     return HttpApiClient.make(api, {
         baseUrl: options?.baseUrl,

package/dist/esm-node/microvertical-api.mjs

@@ -0,0 +1,68 @@
+import "node:module";
+import { Schema } from "effect";
+const MicroVerticalAppIdSchema = Schema.String.pipe(Schema.brand('MicroVerticalAppId'), Schema.decodeTo(Schema.String));
+const MicroVerticalUnitIdSchema = Schema.String.pipe(Schema.brand('MicroVerticalUnitId'), Schema.decodeTo(Schema.String));
+const MicroVerticalOperationIdSchema = Schema.String.pipe(Schema.brand('MicroVerticalOperationId'), Schema.decodeTo(Schema.String));
+const MicroVerticalTraceIdSchema = Schema.String.pipe(Schema.brand('MicroVerticalTraceId'), Schema.decodeTo(Schema.String));
+const MicroVerticalBuildMarkerSchema = Schema.Struct({
+    appId: MicroVerticalAppIdSchema,
+    build: Schema.String,
+    buildMarker: Schema.String,
+    deployProfile: Schema.String,
+    packageName: Schema.String,
+    sourceRevision: Schema.String,
+    surface: Schema.String,
+    unitId: MicroVerticalUnitIdSchema,
+    version: Schema.String
+});
+const MicroVerticalReadinessSchema = Schema.Struct({
+    checks: Schema.Struct({
+        api: Schema.Literal('ready'),
+        moduleFederation: Schema.Literal('ready'),
+        ssr: Schema.Literal('ready'),
+        translations: Schema.Literal('ready')
+    }),
+    marker: MicroVerticalBuildMarkerSchema,
+    status: Schema.Literal('ready'),
+    versionSkew: Schema.Literal('none')
+});
+const MicroVerticalOperationSourceSchema = Schema.Literals([
+    'client',
+    'server',
+    'generated-client',
+    'effect-server',
+    'data-platform',
+    'unknown'
+]);
+const MicroVerticalOperationContextSchema = Schema.Struct({
+    method: Schema.String,
+    operationId: MicroVerticalOperationIdSchema,
+    routePath: Schema.String,
+    source: MicroVerticalOperationSourceSchema,
+    traceId: Schema.optionalKey(MicroVerticalTraceIdSchema)
+});
+const createMicroVerticalOperationContext = (input)=>{
+    const context = {
+        method: input.method,
+        operationId: input.operationId,
+        routePath: input.routePath,
+        source: 'generated-client'
+    };
+    return void 0 === input.traceId ? context : {
+        ...context,
+        traceId: input.traceId
+    };
+};
+const microVerticalOperationAttributes = (operationContext)=>{
+    const attributes = {
+        'modernjs.operation.id': operationContext.operationId,
+        'modernjs.operation.method': operationContext.method,
+        'modernjs.operation.route': operationContext.routePath,
+        'modernjs.operation.source': operationContext.source
+    };
+    return void 0 === operationContext.traceId ? attributes : {
+        ...attributes,
+        'modernjs.trace.id': operationContext.traceId
+    };
+};
+export { MicroVerticalBuildMarkerSchema, MicroVerticalOperationContextSchema, MicroVerticalOperationSourceSchema, MicroVerticalReadinessSchema, createMicroVerticalOperationContext, microVerticalOperationAttributes };

package/dist/types/assembly.d.ts

@@ -0,0 +1,10 @@
+/** Server-only assembly for the invariant tail of a strict Effect BFF runtime factory. */
+import * as Layer from 'effect/Layer';
+import type { HttpApi, HttpApiGroup } from 'effect/unstable/httpapi';
+import type { EffectRuntimeRequirements } from './effect/handler/types.js';
+export interface EffectBffRuntimeAssembly<ApiId extends string, Groups extends HttpApiGroup.Constraint, HandlerRequirements extends EffectRuntimeRequirements, TransportRequirements extends EffectRuntimeRequirements = never> {
+    readonly api: HttpApi.HttpApi<ApiId, Groups>;
+    readonly handlers: Layer.Layer<HttpApiGroup.ToService<ApiId, Groups>, never, HandlerRequirements>;
+    readonly transport?: Layer.Layer<never, never, TransportRequirements>;
+}
+export declare const assembleEffectBffRuntime: <ApiId extends string, Groups extends HttpApiGroup.Constraint, HandlerRequirements extends EffectRuntimeRequirements, TransportRequirements extends EffectRuntimeRequirements = never>({ api, handlers, transport, }: EffectBffRuntimeAssembly<ApiId, Groups, HandlerRequirements, TransportRequirements>) => import("./effect/index.js").EffectBffDefinition<HttpApi.HttpApi<ApiId, Groups>, Layer.Layer<never, never, HandlerRequirements | TransportRequirements | Exclude<import("effect/FileSystem").FileSystem, HttpApiGroup.ToService<ApiId, Groups>> | Exclude<import("effect/unstable/http/Etag").Generator, HttpApiGroup.ToService<ApiId, Groups>> | Exclude<import("effect/unstable/http/HttpPlatform").HttpPlatform, HttpApiGroup.ToService<ApiId, Groups>> | Exclude<import("effect/unstable/http/HttpRouter").HttpRouter, HttpApiGroup.ToService<ApiId, Groups>> | Exclude<import("effect/Path").Path, HttpApiGroup.ToService<ApiId, Groups>> | Exclude<HttpApiGroup.ToService<ApiId, Groups>, HttpApiGroup.ToService<ApiId, Groups>>>, import("effect/unstable/rpc/Rpc").Any> & import("./effect/index.js").EffectBffRuntime<HttpApi.HttpApi<ApiId, Groups>, Layer.Layer<never, never, HandlerRequirements | TransportRequirements | Exclude<import("effect/FileSystem").FileSystem, HttpApiGroup.ToService<ApiId, Groups>> | Exclude<import("effect/unstable/http/Etag").Generator, HttpApiGroup.ToService<ApiId, Groups>> | Exclude<import("effect/unstable/http/HttpPlatform").HttpPlatform, HttpApiGroup.ToService<ApiId, Groups>> | Exclude<import("effect/unstable/http/HttpRouter").HttpRouter, HttpApiGroup.ToService<ApiId, Groups>> | Exclude<import("effect/Path").Path, HttpApiGroup.ToService<ApiId, Groups>> | Exclude<HttpApiGroup.ToService<ApiId, Groups>, HttpApiGroup.ToService<ApiId, Groups>>>>;

package/dist/types/data-platform/batch/options.d.ts

@@ -0,0 +1,7 @@
+import type { DataBatchTransportOptions } from '../types.js';
+/** Wire limits and method eligibility are identical on both sides. */
+export declare function normalizeBatchLimits(options?: Pick<DataBatchTransportOptions, 'maxBatchSize' | 'maxBatchBytes' | 'allowedMethods'>): {
+    maxBatchSize: number;
+    maxBatchBytes: number;
+    allowedMethods: Set<string>;
+};

package/dist/types/data-platform/batch/queue.d.ts

@@ -30,7 +30,6 @@ type QueuedBatchRequest = {
 };
 type BatchBucket = {
     items: QueuedBatchRequest[];
-    bytes: number;
     batchId: string;
     sentAt: number;
     timer: ReturnType<typeof setTimeout> | null;

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;
-export declare const useOperationContext: () => import("@modern-js/create-request").OperationContext;
+/** @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

@@ -1,8 +1,9 @@
-import { type NormalizedCrossProjectPolicy } from '@modern-js/bff-core/security/cross-project-policy';
+import { type NormalizedCrossProjectPolicy } from '@modern-js/server-runtime-extensions/bff-policy';
 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,8 +12,7 @@ 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, EffectApiPromiseClientFromApi, EffectBffDefinition, EffectBffHandlerFactory, EffectBffOpenApiConfig, EffectBffRuntime, EffectDataPlatformBatchOptions, EffectDataPlatformSelectionValidationOptions, EffectDataPlatformValidationOptions, EffectRequestValidator, EffectRpcBffDefinition, EffectRpcBffHandlerFactory, EffectRpcBffHandlerOptions, EffectRpcRuntimeLayer, EffectRpcSerialization, EffectRuntimeLayer, EffectRuntimeRequirements, } from './handler.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';
 export type EffectBffEdgeDispatchOptions = Omit<DispatchEffectBffRequestOptions, 'runWithEffectContext'>;

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

@@ -1 +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';

package/dist/types/effect/endpoint-contracts.d.ts

@@ -1,17 +1,5 @@
-/**
- * Shared Effect HttpApi endpoint reflection used by BOTH sides of the
- * cross-project contract:
- *
- * - the `@modern-js/plugin-bff-extensions/client-generator` package stamps
- *   each generated operation with a per-endpoint contract hash;
- * - the `@modern-js/plugin-bff-extensions/effect-adapter` package derives the
- *   expected operation-contract map for the cross-project policy from the
- *   same endpoints.
- *
- * Keeping route-path normalization and the endpoint -> contract mapping in
- * one module is what guarantees the two hashes agree.
- */
-import { type OperationContractSource } from '@modern-js/bff-core';
+/** Shared endpoint normalization and identity hashing for server policy metadata. */
+import { type OperationContractSource } from '@modern-js/server-runtime-extensions/bff-policy/node';
 export type EffectEndpointMeta = {
     apiId: string;
     groupName: string;
@@ -26,13 +14,7 @@ type HttpApiGroupLike = {
     identifier?: unknown;
 };
 type HttpApiEndpointLike = {
-    /**
-     * effect 4.0.0-beta.98 renamed the endpoint `name` property to `identifier`,
-     * matching `HttpApiGroup`. `name` is kept as a fallback so reflection over an
-     * older Effect build does not silently degrade to the class name.
-     */
     identifier?: unknown;
-    name?: unknown;
     method?: unknown;
     path?: unknown;
 };

package/dist/types/effect/entry-shape.d.ts

@@ -1,14 +1,28 @@
+import type { EffectRpcBffDefinition } from './handler/types.js';
+/**
+ * Module Federation share through which a backend federation host hands its
+ * package-private handler factory registry to the containers it initializes.
+ */
+export declare const EFFECT_BFF_HANDLER_FACTORY_REGISTRY_SHARE = "@modern-js/bff-effect/handler-factory-registry";
+/**
+ * @internal Called by generated backend federation containers from `init()`,
+ * before any expose evaluates, so factories created by `defineEffectBff`
+ * register with the host's registry and endpoints read the host's request
+ * storage instead of bundle-local ones.
+ */
+export declare function adoptEffectBffShareScope(shareScope: unknown): Promise<void>;
 type EffectBffEntryModule = {
     api?: unknown;
     layer?: unknown;
+    rpc?: EffectRpcBffDefinition;
     handler?: unknown;
     createHandler?: unknown;
     default?: unknown;
 };
-type LegacyEffectBffEntryShape = '`handler` export' | 'default request handler';
+type UnsupportedEffectBffEntryShape = '`handler` export' | 'default request handler';
 export type EffectBffEntryShapeFacts = {
     module: EffectBffEntryModule;
-    legacyShape?: LegacyEffectBffEntryShape;
+    unsupportedShape?: UnsupportedEffectBffEntryShape;
     createHandler?: unknown;
     createHandlerValidatorAware: boolean;
     api?: unknown;

package/dist/types/effect/generated-entry.d.ts

@@ -0,0 +1,7 @@
+import { type EffectBffEdgeHandlerOptions } from './edge-dispatcher.js';
+type OperationContracts = NonNullable<EffectBffEdgeHandlerOptions['crossProjectPolicy']>['expectedOperationContracts'];
+export declare function createEffectBffEdgeDispatcherFactory(module: EffectBffEdgeHandlerOptions['module'], generatedOperationContracts: OperationContracts): (options?: Omit<EffectBffEdgeHandlerOptions, 'module'>) => Promise<{
+    dispatch: (request: Request, dispatchOptions?: Omit<import("./edge-dispatcher.js").EffectBffEdgeDispatchOptions, 'prefix' | 'onError'>) => Promise<Response>;
+    dispose: () => Promise<void>;
+}>;
+export {};