@bleedingdev/modern-js-bff-effect 3.9.0-ultramodern.5 → 3.9.0-ultramodern.7

package/README.md

@@ -1,7 +1,7 @@
 # @modern-js/bff-effect
 
 Fork-owned Effect primitives for UltraModern.js BFF runtimes. The package
-keeps the portable Effect handler, data-platform, generated-client runtime,
+keeps the portable Effect handler, data-platform, native inferred clients,
 and edge dispatcher behind standalone package entry points rather than growing
 the upstream-owned `@modern-js/plugin-bff` implementation.
 
@@ -16,10 +16,26 @@ upstream Modern.js project.
 - `@modern-js/bff-effect/effect-edge` exposes the edge-safe dispatcher without
   a static Node built-in import.
 - `@modern-js/bff-effect/effect-client` exposes the Effect client runtime.
-- `@modern-js/bff-effect/effect-client-runtime` exposes the generated-client
-  runtime helpers.
 - `@modern-js/bff-effect/data-platform` exposes batching, envelope, tracing,
   validation, and invalidation primitives.
 
-Adapter lifecycle integration, Hono integration, source/client generation, and
+Adapter lifecycle integration, Hono integration, server source loading, and
 backend federation are intentionally owned by their respective packages.
+
+## HTTP clients
+
+Keep the `HttpApi` contract in a shared module and pass it to Effect's
+`HttpApiClient.make` or `makeEffectHttpApiClient` from `/effect-client`.
+Requests, responses, and declared errors are inferred from that contract.
+No SDK generation or backend-entry import is required.
+
+`defineEffectBff` creates server handlers. Its former `client` placeholder,
+the `@api/index` client transform, and `/effect-client-runtime` have been
+removed. Move consumers to the shared contract and execute native client
+operations with Effect.
+
+For APIs hosted through a cross-project plugin, pass `crossProject` to the
+native client helper: `{ requestId: 'catalog', operationVersion: 2, prefix: '/api' }`.
+Use the producer's request ID, package major version, and server mount path.
+Effect HTTP middleware derives operation headers from the shared contract;
+the server continues to reject missing or stale contract headers.

package/dist/cjs/effect/endpoint-contracts.js

@@ -39,7 +39,6 @@ const node_namespaceObject = require("@modern-js/server-runtime-extensions/bff-p
 const external_entry_shape_js_namespaceObject = require("./entry-shape.js");
 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) {
@@ -97,7 +96,7 @@ async function extractHttpApiFromModule(mod, isHttpApi) {
         isValidatorAwareHandlerFactory: external_entry_shape_js_namespaceObject.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 (0, node_namespaceObject.createOperationContractHash)(createEffectOperationContractSource(endpoint), requestId);

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

@@ -77,13 +77,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,

package/dist/cjs/effect/handler/definition.js

@@ -53,30 +53,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)=>(0, external_rpc_js_namespaceObject.createRpcApiHandler)({

package/dist/cjs/effect/module.js

@@ -43,7 +43,7 @@ function shareDispose(dispose) {
         return disposePromise;
     };
 }
-function rejectLegacyEffectModuleShape(options, shape) {
+function rejectUnsupportedEffectModuleShape(options, shape) {
     options.onWarning?.(`${external_entry_shape_js_namespaceObject.strictEffectApproachMessage} Rejected ${shape}.`);
     return true;
 }
@@ -71,8 +71,8 @@ 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 ('function' == typeof facts.createHandler) {
         if (facts.createHandlerValidatorAware) {
@@ -85,7 +85,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?.(`${external_entry_shape_js_namespaceObject.strictEffectApproachMessage} Ignored unbranded \`createHandler\` export and rebuilt the handler from its { api, layer } exports.`);

package/dist/cjs/effect-client/cross-project.js

@@ -0,0 +1,92 @@
+"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__, {
+    withCrossProjectPolicy: ()=>withCrossProjectPolicy
+});
+const bff_policy_namespaceObject = require("@modern-js/server-runtime-extensions/bff-policy");
+const Effect_namespaceObject = require("effect/Effect");
+const Schema_namespaceObject = require("effect/Schema");
+const http_namespaceObject = require("effect/unstable/http");
+const httpapi_namespaceObject = require("effect/unstable/httpapi");
+const encodeJson = Schema_namespaceObject.encodeSync(Schema_namespaceObject.fromJsonString(Schema_namespaceObject.Unknown));
+function withCrossProjectPolicy(api, options, client) {
+    const contracts = {};
+    const prefix = options.prefix.replace(/\/$/, '');
+    httpapi_namespaceObject.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(http_namespaceObject.HttpClient.mapRequestEffect((request)=>{
+        const observed = (0, bff_policy_namespaceObject.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 Effect_namespaceObject.die(new Error('[BFF][Effect] Request has no matching shared operation contract.'));
+        return Effect_namespaceObject.gen(function*() {
+            const input = encodeJson({
+                httpMethod: contract.method,
+                name: contract.name,
+                requestId: options.requestId,
+                routePath: contract.routePath
+            });
+            const digest = yield* Effect_namespaceObject.promise(()=>globalThis.crypto.subtle.digest('SHA-256', new TextEncoder().encode(input)));
+            const schemaHash = Array.from(new Uint8Array(digest), (value)=>value.toString(16).padStart(2, '0')).join('');
+            return request.pipe(http_namespaceObject.HttpClientRequest.setHeader(bff_policy_namespaceObject.BFF_ENVELOPE_HEADER, encodeJson({
+                requestId: options.requestId
+            })), http_namespaceObject.HttpClientRequest.setHeader(bff_policy_namespaceObject.BFF_OPERATION_CONTEXT_HEADER, contract.operationId), http_namespaceObject.HttpClientRequest.setHeader(bff_policy_namespaceObject.BFF_OPERATION_CONTEXT_DETAIL_HEADER, encodeJson({
+                requestId: options.requestId,
+                operationId: contract.operationId,
+                method: contract.method,
+                routePath: contract.routePath,
+                schemaHash,
+                operationVersion: options.operationVersion
+            })));
+        });
+    }));
+}
+exports.withCrossProjectPolicy = __webpack_exports__.withCrossProjectPolicy;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "withCrossProjectPolicy"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

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

@@ -61,6 +61,7 @@ const http_namespaceObject = require("effect/unstable/http");
 const httpapi_namespaceObject = require("effect/unstable/httpapi");
 const rpc_namespaceObject = require("effect/unstable/rpc");
 const rpcSerialization_js_namespaceObject = require("../effect/rpcSerialization.js");
+const external_cross_project_js_namespaceObject = require("./cross-project.js");
 const Schema_namespaceObject = require("effect/Schema");
 const HttpClientError_namespaceObject = require("effect/unstable/http/HttpClientError");
 class EffectRpcClientError extends Data_namespaceObject.TaggedError('EffectRpcClientError') {
@@ -98,7 +99,8 @@ function makeEffectHttpApiClient(api, options) {
             for (const [header, value] of Object.entries(requestContextHeaders))if (void 0 === nextRequest.headers[header.toLowerCase()]) nextRequest = http_namespaceObject.HttpClientRequest.setHeader(nextRequest, header, value);
             return nextRequest;
         }));
-        return 'function' == typeof options?.transformClient ? options.transformClient(contextClient) : contextClient;
+        const policyClient = options?.crossProject !== void 0 ? (0, external_cross_project_js_namespaceObject.withCrossProjectPolicy)(api, options.crossProject, contextClient) : contextClient;
+        return 'function' == typeof options?.transformClient ? options.transformClient(policyClient) : policyClient;
     };
     return httpapi_namespaceObject.HttpApiClient.make(api, {
         baseUrl: options?.baseUrl,

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

@@ -2,7 +2,6 @@ import { createOperationContractHash } from "@modern-js/server-runtime-extension
 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) {
@@ -60,7 +59,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/effect/entry-shape.mjs

@@ -34,13 +34,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,

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

@@ -20,30 +20,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/effect/module.mjs

@@ -11,7 +11,7 @@ function shareDispose(dispose) {
         return disposePromise;
     };
 }
-function rejectLegacyEffectModuleShape(options, shape) {
+function rejectUnsupportedEffectModuleShape(options, shape) {
     options.onWarning?.(`${strictEffectApproachMessage} Rejected ${shape}.`);
     return true;
 }
@@ -39,8 +39,8 @@ 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 ('function' == typeof facts.createHandler) {
         if (facts.createHandlerValidatorAware) {
@@ -53,7 +53,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/effect-client/cross-project.mjs

@@ -0,0 +1,54 @@
+import { BFF_ENVELOPE_HEADER, BFF_OPERATION_CONTEXT_DETAIL_HEADER, BFF_OPERATION_CONTEXT_HEADER, 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 input = encodeJson({
+                httpMethod: contract.method,
+                name: contract.name,
+                requestId: options.requestId,
+                routePath: contract.routePath
+            });
+            const digest = yield* __rspack_external_effect_Effect_41060786.promise(()=>globalThis.crypto.subtle.digest('SHA-256', new TextEncoder().encode(input)));
+            const schemaHash = Array.from(new Uint8Array(digest), (value)=>value.toString(16).padStart(2, '0')).join('');
+            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/effect-client/index.mjs

@@ -5,6 +5,7 @@ import { FetchHttpClient, HttpClient, HttpClientRequest } from "effect/unstable/
 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";
@@ -46,7 +47,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/effect/endpoint-contracts.mjs

@@ -3,7 +3,6 @@ import { createOperationContractHash } from "@modern-js/server-runtime-extension
 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

@@ -46,13 +46,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,

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/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,8 @@ 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 ('function' == typeof facts.createHandler) {
         if (facts.createHandlerValidatorAware) {
@@ -54,7 +54,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-client/cross-project.mjs

@@ -0,0 +1,55 @@
+import "node:module";
+import { BFF_ENVELOPE_HEADER, BFF_OPERATION_CONTEXT_DETAIL_HEADER, BFF_OPERATION_CONTEXT_HEADER, 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 input = encodeJson({
+                httpMethod: contract.method,
+                name: contract.name,
+                requestId: options.requestId,
+                routePath: contract.routePath
+            });
+            const digest = yield* __rspack_external_effect_Effect_41060786.promise(()=>globalThis.crypto.subtle.digest('SHA-256', new TextEncoder().encode(input)));
+            const schemaHash = Array.from(new Uint8Array(digest), (value)=>value.toString(16).padStart(2, '0')).join('');
+            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

@@ -6,6 +6,7 @@ import { FetchHttpClient, HttpClient, HttpClientRequest } from "effect/unstable/
 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/types/effect/edge-dispatcher.d.ts

@@ -12,7 +12,7 @@ export { Cookies, Etag, FetchHttpClient, FindMyWay, Headers, HttpBody, HttpClien
 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/endpoint-contracts.d.ts

@@ -1,16 +1,4 @@
-/**
- * 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.
- */
+/** 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;
@@ -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;
 };