@bleedingdev/modern-js-plugin-bff 3.4.0-ultramodern.9 → 3.5.0-ultramodern.1

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

@@ -13,6 +13,8 @@ export * from "effect/unstable/httpapi";
 export * from "effect/unstable/rpc";
 import * as __rspack_external_effect_Context_f1289ca3 from "effect/Context";
 const emptyEffectServiceContext = __rspack_external_effect_Context_f1289ca3.empty();
+const isEffectServiceContext = (context)=>'object' == typeof context && null !== context && 'mapUnsafe' in context;
+const toEffectServiceContext = (context)=>isEffectServiceContext(context) ? context : emptyEffectServiceContext;
 const EFFECT_VALIDATOR_AWARE_FACTORY = Symbol.for('modernjs.effect.validatorAware');
 function isValidatorAwareHandlerFactory(factory) {
     return 'function' == typeof factory && true === factory[EFFECT_VALIDATOR_AWARE_FACTORY];
@@ -330,7 +332,7 @@ const LOADER_CLIENT_IGNORED_KEYS = new Set([
 ]);
 function createLoaderMaterializedClientPlaceholder() {
     const explain = (property)=>{
-        throw new Error(`[BFF][Effect] effectBff.client.${String(property)} is not available here: the typed client only exists when this module is imported through the "@api/effect/*" transformed path (the BFF loader replaces it with generated client code). On the server, use HttpApiClient or call the Effect layer directly.`);
+        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.`);
     };
     return new Proxy(Object.create(null), {
         get (_target, property) {
@@ -371,7 +373,7 @@ function createHttpApiHandler(options) {
         if (preparedRequest instanceof Response) return preparedRequest;
         const validationError = validateDataPlatformRequestEnvelope(preparedRequest, options.dataPlatform);
         if (validationError) return validationError;
-        return httpApiHandler.handler(preparedRequest, context ?? emptyEffectServiceContext);
+        return httpApiHandler.handler(preparedRequest, toEffectServiceContext(context));
     };
     const handleBatchRequest = async (request, context)=>{
         const mountedPrefix = getMountedPrefixFromContext(request, context);
@@ -493,7 +495,7 @@ function createHttpApiHandler(options) {
             if (isRpcRequest(request, rpcPath)) {
                 const policyDenial = options.validateRequest?.(request);
                 if (policyDenial) return policyDenial;
-                return rpcHandler.handler(request, context ?? emptyEffectServiceContext);
+                return rpcHandler.handler(request, toEffectServiceContext(context));
             }
             return handleHttpApiRequest(request);
         },

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

@@ -1,5 +1,6 @@
 import "node:module";
 import * as __rspack_external__effect_opentelemetry_8bbbb5af from "@effect/opentelemetry";
 export * from "./handler.mjs";
-export { createEffectOperationContext, useEffectContext, useOperationContext } from "./context.mjs";
+export { createEffectOperationContext, runWithEffectContext, useEffectContext, useOperationContext } from "./context.mjs";
+export { createEffectBffEdgeHandler, createEffectBffTestHandler, dispatchEffectBffRequest } from "./edge.mjs";
 export { __rspack_external__effect_opentelemetry_8bbbb5af as OpenTelemetry };

package/dist/esm-node/runtime/effect/module.mjs

@@ -18,16 +18,18 @@ function isEffectServiceContext(context) {
     return 'object' == typeof context && null !== context && 'mapUnsafe' in context;
 }
 const emptyEffectServiceContext = __rspack_external_effect_Context_f1289ca3.empty();
+const strictEffectApproachMessage = '[BFF][Effect] strictEffectApproach is enforced: Effect API entries must export defineEffectBff(...) or a { api, layer } HttpApi module. Raw handler exports, default request handlers, and unbranded custom createHandler factories are not valid Effect API entries.';
+function rejectLegacyEffectModuleShape(options, shape) {
+    options.onWarning?.(`${strictEffectApproachMessage} Rejected ${shape}.`);
+    return true;
+}
 function callEffectBffRequestHandler(handler, request, context) {
     return void 0 === context ? handler(request) : handler(request, context);
 }
-function createLoadedHandler(webHandler, appliesRequestValidator) {
+function createLoadedHandler(webHandler) {
     return {
         handler: (request, context)=>callEffectBffRequestHandler(webHandler.handler, request, context),
-        dispose: webHandler.dispose,
-        ...appliesRequestValidator ? {
-            appliesRequestValidator: true
-        } : {}
+        dispose: webHandler.dispose
     };
 }
 function createLoadedHttpApiHandler(webHandler) {
@@ -36,18 +38,23 @@ function createLoadedHttpApiHandler(webHandler) {
             const effectContext = isEffectServiceContext(context) ? context : emptyEffectServiceContext;
             return webHandler.handler(request, effectContext);
         },
-        dispose: webHandler.dispose,
-        appliesRequestValidator: true
+        dispose: webHandler.dispose
     };
 }
 function resolveNormalizedEffectBffModuleHandler(normalizedModule, options = {}) {
-    if (isRequestHandler(normalizedModule.handler)) return {
-        handler: normalizedModule.handler
-    };
+    if (isRequestHandler(normalizedModule.handler)) {
+        if (rejectLegacyEffectModuleShape(options, '`handler` export')) return null;
+        return {
+            handler: normalizedModule.handler
+        };
+    }
     const entry = normalizedModule.default;
-    if (isRequestHandler(entry)) return {
-        handler: entry
-    };
+    if (isRequestHandler(entry)) {
+        if (rejectLegacyEffectModuleShape(options, 'default request handler')) return null;
+        return {
+            handler: entry
+        };
+    }
     if (isRecord(entry)) normalizedModule = {
         ...normalizedModule,
         ...entry
@@ -59,19 +66,22 @@ function resolveNormalizedEffectBffModuleHandler(normalizedModule, options = {})
             handler: maybeHandler
         };
     }
-    if (isRequestHandler(normalizedModule.handler)) return {
-        handler: normalizedModule.handler
-    };
+    if (isRequestHandler(normalizedModule.handler)) {
+        if (rejectLegacyEffectModuleShape(options, '`handler` export')) return null;
+        return {
+            handler: normalizedModule.handler
+        };
+    }
     if ('function' == typeof normalizedModule.createHandler) {
         const factory = normalizedModule.createHandler;
         const validatorAware = isValidatorAwareHandlerFactory(factory);
-        if (!validatorAware && void 0 !== options.validateRequest) options.onWarning?.('[BFF][Effect] Custom createHandler export detected: it cannot be verified to apply validateRequest (cross-project policy), so the policy is enforced by the adapter middleware on the outer request. Batched calls will be denied at the batch POST (it carries no per-operation contract); export defineEffectBff(...) to get per-batch-item enforcement.');
+        if (!validatorAware && rejectLegacyEffectModuleShape(options, 'unbranded `createHandler` export')) return null;
         const webHandler = factory({
             openapi: options.openapi,
             dataPlatform: options.dataPlatform,
             validateRequest: options.validateRequest
         });
-        return createLoadedHandler(webHandler, validatorAware);
+        return createLoadedHandler(webHandler);
     }
     if (isEffectApiDefinition(normalizedModule)) {
         options.onWarning?.('[BFF][Effect] Detected { api, layer } export without createHandler. Prefer `defineEffectBff(...)` from @modern-js/plugin-bff/server to avoid module instance mismatch.');
@@ -95,17 +105,26 @@ function resolveEffectBffModuleHandler(mod, options = {}) {
             ...value
         };
     };
-    if (isRequestHandler(normalizedModule.handler)) return Promise.resolve({
-        handler: normalizedModule.handler
-    });
+    if (isRequestHandler(normalizedModule.handler)) {
+        if (rejectLegacyEffectModuleShape(options, '`handler` export')) return Promise.resolve(null);
+        return Promise.resolve({
+            handler: normalizedModule.handler
+        });
+    }
     const entry = normalizedModule.default;
-    if (isRequestHandler(entry)) return Promise.resolve({
-        handler: entry
-    });
+    if (isRequestHandler(entry)) {
+        if (rejectLegacyEffectModuleShape(options, 'default request handler')) return Promise.resolve(null);
+        return Promise.resolve({
+            handler: entry
+        });
+    }
     if ('function' == typeof entry && 0 === entry.length) return Promise.resolve(entry()).then((out)=>{
-        if (isRequestHandler(out)) return {
-            handler: out
-        };
+        if (isRequestHandler(out)) {
+            if (rejectLegacyEffectModuleShape(options, 'default factory returning a request handler')) return null;
+            return {
+                handler: out
+            };
+        }
         mergeRuntimeExports(out);
         return resolveNormalizedEffectBffModuleHandler(normalizedModule, options);
     });

package/dist/esm-node/utils/effectClientGenerator.mjs

@@ -129,14 +129,14 @@ const __generated = createGeneratedEffectClient(__manifest, __config, __requestR
 const client = __generated.client;
 const operationManifest = __generated.operationManifest;
 const createEffectRequestContext = __generated.createEffectRequestContext;
-const effectBffModule = {
+const apiModule = {
   client,
   operationManifest,
   createEffectRequestContext,
 };
 
 export { client, createEffectRequestContext, operationManifest };
-export default effectBffModule;
+export default apiModule;
 `;
 }
 function renderClientShape(endpoints, valueType) {
@@ -209,13 +209,13 @@ export declare const createEffectRequestContext: (
   requestContext: Record<string, unknown>,
 ) => EffectRequestContext;
 export declare const operationManifest: GeneratedEffectOperationManifest;
-declare const effectBffModule: {
+declare const apiModule: {
   client: GeneratedEffectClient;
   createEffectRequestContext: typeof createEffectRequestContext;
   operationManifest: GeneratedEffectOperationManifest;
 };
 
-export default effectBffModule;
+export default apiModule;
 `;
 }
 async function generateEffectClient(options) {
@@ -238,9 +238,14 @@ async function generateEffectClientCode(options) {
 }
 function resolveEffectEntryFile(options) {
     const { appDir, apiDir, effectEntry } = options;
-    const defaultEntry = path.resolve(apiDir, 'effect', 'index');
-    const entryWithoutExt = effectEntry ? path.isAbsolute(effectEntry) ? effectEntry : path.resolve(appDir, effectEntry) : defaultEntry;
-    if (path.extname(entryWithoutExt)) return fs.existsSync(entryWithoutExt) ? entryWithoutExt : void 0;
-    return findExists(JS_OR_TS_EXTS.map((ext)=>`${entryWithoutExt}${ext}`));
+    const resolveEntry = (entryWithoutExt)=>{
+        if (path.extname(entryWithoutExt)) return fs.existsSync(entryWithoutExt) ? entryWithoutExt : void 0;
+        return findExists(JS_OR_TS_EXTS.map((ext)=>`${entryWithoutExt}${ext}`));
+    };
+    if (effectEntry) {
+        const entryWithoutExt = path.isAbsolute(effectEntry) ? effectEntry : path.resolve(appDir, effectEntry);
+        return resolveEntry(entryWithoutExt);
+    }
+    return resolveEntry(path.resolve(apiDir, 'index'));
 }
 export { generateEffectClient, generateEffectClientCode, renderEffectClientDeclaration, resolveEffectEntryFile };

package/dist/types/runtime/effect/adapter.d.ts

@@ -12,30 +12,14 @@ export declare class EffectAdapter {
     private handler;
     private dispose;
     private prefix;
-    /**
-     * True when the loaded handler does NOT run the policy seam internally
-     * (plain `handler` exports); the adapter middleware enforces it instead.
-     */
-    private policyEnforcedInMiddleware;
     constructor(api: ServerPluginAPI);
     registerMiddleware: (options: MiddlewareOptions) => Promise<void>;
     onApiHandlersUpdated: () => Promise<void>;
     private resolveEntryFile;
-    private isApiRequestPath;
-    /**
-     * Contract sources for the lambda-lane handlers hosted alongside the
-     * effect entry. Cross-project SDKs generate per-operation contracts for
-     * `api/lambda` handlers with the exact same `ApiRouter` derivation used
-     * here, so the server-side expected-contract map must include them —
-     * otherwise every lambda-lane operation of a hosted producer SDK would be
-     * denied as `unknown_operation_contract`.
-     */
-    private collectLambdaContractSources;
     /**
-     * Resolves the cross-project policy from the reflected HttpApi endpoints
-     * (plus any hosted lambda-lane handlers) so the expected operation
-     * contracts match the hashes the client generators stamp into generated
-     * SDKs.
+     * Resolves the cross-project policy from the reflected HttpApi endpoints so
+     * the expected operation contracts match the hashes the client generators
+     * stamp into generated SDKs.
      */
     private refreshCrossProjectPolicy;
     private loadEffectHandlerFromModule;

package/dist/types/runtime/effect/edge-context.d.ts

@@ -0,0 +1,5 @@
+import type { EffectContext } from './operation-context';
+export { type CreateEffectOperationContextOptions, createEffectOperationContext, type EffectContext, } from './operation-context';
+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;

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

@@ -1,6 +1,7 @@
 import type { EffectBffOpenApiConfig, EffectDataPlatformValidationOptions } from './handler';
 import { type EffectApiModule, type EffectBffRequestHandler } from './module';
 import { type EffectContext } from './operation-context';
+export { runWithEffectContext, useEffectContext, useOperationContext, } from './edge-context';
 export * from './handler';
 export { type CreateEffectOperationContextOptions, createEffectOperationContext, type EffectContext, } from './operation-context';
 export type EffectBffEdgeDispatchOptions = {
@@ -19,6 +20,7 @@ export type EffectBffEdgeHandlerOptions = {
     onWarning?: (message: string) => void;
 };
 export declare function dispatchEffectBffRequest(handler: EffectBffRequestHandler, request: Request, options?: EffectBffEdgeDispatchOptions): Promise<Response>;
+export declare const createEffectBffTestHandler: typeof createEffectBffEdgeHandler;
 export declare function createEffectBffEdgeHandler(options: EffectBffEdgeHandlerOptions): Promise<{
     handler: (request: Request, dispatchOptions?: Omit<EffectBffEdgeDispatchOptions, 'prefix' | 'onError'>) => Promise<Response>;
     dispose: () => Promise<void>;

package/dist/types/runtime/effect/handler.d.ts

@@ -144,11 +144,8 @@ export type EffectRequestValidator = (request: Request) => Response | null | und
  * seam runs inside the produced handler, including per batched item.
  *
  * `defineEffectBff` brands its factory automatically. Hand-written factories
- * are NOT assumed to honor `validateRequest` (the option is newer than the
- * factory shape), so the effect adapter falls back to middleware enforcement
- * for unbranded factories instead of silently skipping the policy. Custom
- * factories that do forward `validateRequest` into `createHttpApiHandler`
- * may opt in by setting this symbol property to `true`.
+ * are NOT assumed to honor `validateRequest`, so strict module resolution
+ * rejects unbranded factories instead of silently skipping the policy.
  *
  * Registered via `Symbol.for` so independently loaded runtime copies agree.
  */

package/dist/types/runtime/effect/index.d.ts

@@ -1,3 +1,4 @@
 export * as OpenTelemetry from '@effect/opentelemetry';
-export { type CreateEffectOperationContextOptions, createEffectOperationContext, type EffectContext, useEffectContext, useOperationContext, } from './context';
+export { type CreateEffectOperationContextOptions, createEffectOperationContext, type EffectContext, runWithEffectContext, useEffectContext, useOperationContext, } from './context';
+export { createEffectBffEdgeHandler, createEffectBffTestHandler, dispatchEffectBffRequest, } from './edge';
 export * from './handler';

package/dist/types/runtime/effect/module.d.ts

@@ -20,27 +20,14 @@ export type EffectApiModule = {
 export type LoadedEffectBffHandler = {
     handler: EffectBffRequestHandler;
     dispose?: () => Promise<void>;
-    /**
-     * True when the handler is known to apply `validateRequest` internally
-     * (including per batched item): `{ api, layer }` modules resolved through
-     * `createHttpApiHandler`, and `createHandler` factories branded by
-     * `defineEffectBff` (see `EFFECT_VALIDATOR_AWARE_FACTORY`). Plain
-     * `handler` exports and unbranded custom factories leave this unset; the
-     * adapter middleware must enforce the policy itself for those.
-     */
-    appliesRequestValidator?: boolean;
 };
 export type ResolveEffectBffModuleHandlerOptions = {
     openapi?: EffectBffOpenApiConfig;
     dataPlatform?: EffectDataPlatformValidationOptions;
     /**
-     * Server-seam request validator (cross-project policy). Applied by
-     * `createHttpApiHandler` to direct, batched and rpc requests.
-     *
-     * Note: plain `handler` exports and unbranded custom `createHandler`
-     * factories bypass this seam — the effect adapter enforces the policy in
-     * its middleware for those shapes instead (see
-     * `LoadedEffectBffHandler.appliesRequestValidator`).
+     * Server-seam request validator (cross-project policy). Strict Effect
+     * entries forward it into `createHttpApiHandler`, where it applies to
+     * direct, batched and rpc requests.
      */
     validateRequest?: EffectRequestValidator;
     onWarning?: (message: string) => void;

package/package.json

@@ -17,7 +17,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.4.0-ultramodern.9",
+  "version": "3.5.0-ultramodern.1",
   "types": "./dist/types/cli.d.ts",
   "main": "./dist/cjs/cli.js",
   "exports": {
@@ -157,12 +157,12 @@
     "effect": "4.0.0-beta.89",
     "qs": "^6.15.3",
     "type-is": "^2.1.0",
-    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.4.0-ultramodern.9",
-    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.4.0-ultramodern.9",
-    "@modern-js/server-utils": "npm:@bleedingdev/modern-js-server-utils@3.4.0-ultramodern.9",
-    "@modern-js/create-request": "npm:@bleedingdev/modern-js-create-request@3.4.0-ultramodern.9",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.4.0-ultramodern.9",
-    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.4.0-ultramodern.9"
+    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.5.0-ultramodern.1",
+    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.5.0-ultramodern.1",
+    "@modern-js/create-request": "npm:@bleedingdev/modern-js-create-request@3.5.0-ultramodern.1",
+    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.5.0-ultramodern.1",
+    "@modern-js/server-utils": "npm:@bleedingdev/modern-js-server-utils@3.5.0-ultramodern.1",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.5.0-ultramodern.1"
   },
   "devDependencies": {
     "@rsbuild/core": "2.1.0",
@@ -174,12 +174,12 @@
     "memfs": "^4.57.8",
     "typescript": "^6.0.3",
     "zod": "^4.4.3",
-    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.4.0-ultramodern.9",
-    "@modern-js/bff-runtime": "npm:@bleedingdev/modern-js-bff-runtime@3.4.0-ultramodern.9",
-    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.4.0-ultramodern.9",
-    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.4.0-ultramodern.9",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.4.0-ultramodern.9",
-    "@scripts/rstest-config": "2.66.0"
+    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.5.0-ultramodern.1",
+    "@modern-js/bff-runtime": "npm:@bleedingdev/modern-js-bff-runtime@3.5.0-ultramodern.1",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.5.0-ultramodern.1",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.5.0-ultramodern.1",
+    "@scripts/rstest-config": "2.66.0",
+    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.5.0-ultramodern.1"
   },
   "sideEffects": false,
   "publishConfig": {