@bleedingdev/modern-js-plugin-bff 3.5.0-ultramodern.28 → 3.5.0-ultramodern.29

package/dist/types/runtime/effect/backend-federation.d.ts

@@ -0,0 +1,60 @@
+import type { ModuleFederation, ModuleFederationRuntimePlugin } from '@module-federation/runtime';
+import type { EffectApiModule } from './module';
+export declare const BACKEND_FEDERATION_EFFECT_EXPOSE = "./effect-api";
+export declare const BACKEND_FEDERATION_MANIFEST_FILE = "backend-mf-manifest.json";
+export declare const BACKEND_FEDERATION_CONTRACT_VERSION = "microvertical-server-effect-v1";
+export declare const BACKEND_FEDERATION_NODE_ADAPTER_VERSION = "backend-mf-effect-v1";
+export type BackendFederationRemote = {
+    name: string;
+    entry: string;
+    type?: 'commonjs-module' | 'module' | string;
+    entryGlobalName?: string;
+    shareScope?: string | string[];
+    expose?: typeof BACKEND_FEDERATION_EFFECT_EXPOSE;
+};
+export type BackendFederationRuntimeOptions = {
+    hostName: string;
+    remote?: BackendFederationRemote;
+    remotes?: BackendFederationRemote[];
+    plugins?: ModuleFederationRuntimePlugin[];
+};
+export type BackendFederationEntryExports = {
+    get: (id: string) => (() => Promise<unknown> | unknown) | Promise<() => Promise<unknown> | unknown>;
+    init?: (...args: unknown[]) => void | Promise<void>;
+};
+export type BackendFederatedEffectApiModule = EffectApiModule & {
+    backendFederationContract?: {
+        compatibility?: {
+            build?: unknown;
+            contractVersion?: unknown;
+            nodeAdapterVersion?: unknown;
+            packageName?: unknown;
+            /**
+             * ADR-0019 delivery-unit identity root, generator-emitted alongside
+             * the manifest's `versionBoundary.deliveryUnit`. Additive/optional.
+             */
+            unitId?: unknown;
+            /** ADR-0019 delivery-unit source revision. Additive/optional. */
+            sourceRevision?: unknown;
+        };
+        name?: unknown;
+        role?: unknown;
+        runtimeFramework?: unknown;
+        strictEffectApproach?: unknown;
+    };
+    contract?: unknown;
+    operationContexts?: unknown;
+    runtime?: unknown;
+};
+export type BackendFederationLoadEntryPluginOptions = {
+    resolveEntry: (remote: BackendFederationRemote) => BackendFederationEntryExports | undefined | Promise<BackendFederationEntryExports | undefined>;
+};
+type BackendFederationLoadOptions = BackendFederationRuntimeOptions & {
+    runtime?: ModuleFederation;
+    remoteName?: string;
+    expose?: string;
+};
+export declare function createBackendFederationRuntime(options: BackendFederationRuntimeOptions): ModuleFederation;
+export declare function createBackendFederationLoadEntryPlugin(options: BackendFederationLoadEntryPluginOptions): ModuleFederationRuntimePlugin;
+export declare function loadBackendFederatedEffectApi(options: BackendFederationLoadOptions): Promise<BackendFederatedEffectApiModule>;
+export {};

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

@@ -0,0 +1,17 @@
+import type { EffectBffRequestHandler } from './module';
+import { type EffectContext } from './operation-context';
+export type EffectDispatchContextRunner = <T>(context: EffectContext, cb: () => T) => T;
+export type DispatchEffectBffRequestOptions = {
+    prefix?: string;
+    env?: Record<string, unknown>;
+    path?: string;
+    method?: string;
+    runWithEffectContext: EffectDispatchContextRunner;
+    onError?: (error: unknown, context: EffectContext) => Promise<Response> | Response;
+};
+export declare function normalizeEffectBffPrefix(prefix: string | undefined): string;
+export declare function removeEffectBffPrefixFromPath(pathname: string, prefix: string | undefined): string;
+export declare function matchesEffectBffPrefix(pathname: string, prefix: string | undefined): boolean;
+export declare function createEffectBffMountedRequest(req: Request, prefix: string | undefined): Request;
+export declare function createEffectBffDispatchContext(originalRequest: Request, mountedRequest: Request, options: Omit<DispatchEffectBffRequestOptions, 'runWithEffectContext'>): EffectContext;
+export declare function dispatchEffectBffRequestWithContext(handler: EffectBffRequestHandler, request: Request, options: DispatchEffectBffRequestOptions): Promise<Response>;

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

@@ -1,16 +1,12 @@
+import { type DispatchEffectBffRequestOptions } from './dispatch';
 import type { EffectBffOpenApiConfig, EffectDataPlatformValidationOptions } from './handler';
 import { type EffectApiModule, type EffectBffRequestHandler } from './module';
-import { type EffectContext } from './operation-context';
+import type { EffectContext } from './operation-context';
+export { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION, type BackendFederatedEffectApiModule, type BackendFederationEntryExports, type BackendFederationLoadEntryPluginOptions, type BackendFederationRemote, type BackendFederationRuntimeOptions, createBackendFederationLoadEntryPlugin, createBackendFederationRuntime, loadBackendFederatedEffectApi, } from './backend-federation';
 export { runWithEffectContext, useEffectContext, useOperationContext, } from './edge-context';
 export * from './handler';
 export { type CreateEffectOperationContextOptions, createEffectOperationContext, type EffectContext, } from './operation-context';
-export type EffectBffEdgeDispatchOptions = {
-    prefix?: string;
-    env?: Record<string, unknown>;
-    path?: string;
-    method?: string;
-    onError?: (error: unknown, context: EffectContext) => Promise<Response> | Response;
-};
+export type EffectBffEdgeDispatchOptions = Omit<DispatchEffectBffRequestOptions, 'runWithEffectContext'>;
 export type EffectBffEdgeHandlerOptions = {
     module: EffectApiModule;
     prefix?: string;
@@ -19,7 +15,12 @@ export type EffectBffEdgeHandlerOptions = {
     onError?: (error: unknown, context: EffectContext) => Promise<Response> | Response;
     onWarning?: (message: string) => void;
 };
+export type EffectBffEdgeRequestDispatcher = (request: Request, dispatchOptions?: Omit<EffectBffEdgeDispatchOptions, 'prefix' | 'onError'>) => Promise<Response>;
 export declare function dispatchEffectBffRequest(handler: EffectBffRequestHandler, request: Request, options?: EffectBffEdgeDispatchOptions): Promise<Response>;
+export declare function createEffectBffEdgeDispatcher(options: EffectBffEdgeHandlerOptions): Promise<{
+    dispatch: (request: Request, dispatchOptions?: Omit<EffectBffEdgeDispatchOptions, 'prefix' | 'onError'>) => Promise<Response>;
+    dispose: () => Promise<void>;
+}>;
 export declare const createEffectBffTestHandler: typeof createEffectBffEdgeHandler;
 export declare function createEffectBffEdgeHandler(options: EffectBffEdgeHandlerOptions): Promise<{
     handler: (request: Request, dispatchOptions?: Omit<EffectBffEdgeDispatchOptions, 'prefix' | 'onError'>) => Promise<Response>;

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

@@ -51,8 +51,8 @@ export declare function toOperationContractSources(endpoints: EffectEndpointMeta
 export declare function createEffectOperationContractSource(endpoint: EffectEndpointMeta): OperationContractSource;
 /**
  * Extracts the HttpApi instance from a loaded effect entry module. Mirrors
- * the module shapes accepted by `resolveEffectBffModuleHandler`:
- * `{ api }`, `{ default: { api } }` and zero-arg default factories.
+ * the shared entry-shape policy accepted by `resolveEffectBffModuleHandler`,
+ * without executing factories during contract extraction.
  */
 export declare function extractHttpApiFromModule(mod: unknown, isHttpApi: (value: unknown) => boolean): Promise<HttpApiLike | null>;
 /**

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

@@ -0,0 +1,31 @@
+export type EffectBffEntryModule = {
+    api?: unknown;
+    layer?: unknown;
+    handler?: unknown;
+    createHandler?: unknown;
+    default?: unknown;
+};
+export type LegacyEffectBffEntryShape = '`handler` export' | 'default request handler';
+export type EffectBffEntryShapeFacts = {
+    module: EffectBffEntryModule;
+    legacyShape?: LegacyEffectBffEntryShape;
+    createHandler?: unknown;
+    createHandlerValidatorAware: boolean;
+    api?: unknown;
+    layer?: unknown;
+    hasRuntimeLayer: boolean;
+};
+export type EffectBffEntryShapePredicates = {
+    isRequestHandler: (value: unknown) => boolean;
+    isValidatorAwareHandlerFactory: (value: unknown) => boolean;
+    isHttpApi: (value: unknown) => boolean;
+};
+export declare const EFFECT_VALIDATOR_AWARE_FACTORY: symbol;
+/**
+ * True when a custom createHandler factory is produced by defineEffectBff and
+ * therefore forwards strict cross-project validation into createHttpApiHandler.
+ */
+export declare function isValidatorAwareHandlerFactory(factory: unknown): boolean;
+export declare 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.";
+export declare function isEffectEntryRecord(value: unknown): value is Record<string, unknown>;
+export declare function classifyEffectBffEntryModule(value: unknown, predicates: EffectBffEntryShapePredicates): EffectBffEntryShapeFacts | null;

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

@@ -15,6 +15,7 @@ export { HttpTraceContext } from 'effect/unstable/http';
 export * from 'effect/unstable/httpapi';
 export { HttpApiBuilder } from 'effect/unstable/httpapi';
 export * from 'effect/unstable/rpc';
+export { EFFECT_VALIDATOR_AWARE_FACTORY, isValidatorAwareHandlerFactory, } from './entry-shape';
 export type EffectRuntimeRequirements = Etag.Generator | FileSystem.FileSystem | HttpPlatform.HttpPlatform | HttpRouter.HttpRouter | HttpRouter.Request<'Error', unknown> | HttpRouter.Request<'GlobalError', unknown> | HttpRouter.Request<'GlobalRequires', unknown> | HttpRouter.Request<'Requires', unknown> | Path.Path;
 export type EffectRuntimeLayer = Layer.Layer<never, never, EffectRuntimeRequirements>;
 export type EffectRpcSerialization = 'json' | 'ndjson' | 'jsonRpc' | 'ndJsonRpc' | 'msgPack';
@@ -138,23 +139,6 @@ export type EffectDataPlatformValidationOptions = {
  * cannot bypass it.
  */
 export type EffectRequestValidator = (request: Request) => Response | null | undefined;
-/**
- * Brand stamped on `createHandler` factories that are guaranteed to forward
- * `options.validateRequest` into `createHttpApiHandler` — i.e. the policy
- * seam runs inside the produced handler, including per batched item.
- *
- * `defineEffectBff` brands its factory automatically. Hand-written factories
- * 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.
- */
-export declare const EFFECT_VALIDATOR_AWARE_FACTORY: symbol;
-/**
- * True when `factory` is branded as validator-aware (see
- * {@link EFFECT_VALIDATOR_AWARE_FACTORY}).
- */
-export declare function isValidatorAwareHandlerFactory(factory: unknown): boolean;
 export type EffectBffHandlerFactory<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps, TLayer extends EffectRuntimeLayer = EffectRuntimeLayer> = (options?: {
     openapi?: EffectBffOpenApiConfig;
     rpc?: Partial<EffectRpcBffHandlerOptions>;

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

@@ -1,4 +1,7 @@
 export * as OpenTelemetry from '@effect/opentelemetry';
+export * from './backend-federation';
+export { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION, type BackendFederatedEffectApiModule, type BackendFederationEntryExports, type BackendFederationLoadEntryPluginOptions, type BackendFederationRemote, type BackendFederationRuntimeOptions, createBackendFederationLoadEntryPlugin, createBackendFederationRuntime, loadBackendFederatedEffectApi, } from './backend-federation';
+export { type BackendFederationManifest, BackendFederationManifestAdapterError, type BackendFederationManifestAdapterErrorCode, type BackendFederationManifestAdapterFallback, type BackendFederationManifestAdapterOptions, type BackendFederationManifestFetchResponse, type BackendFederationVersionBoundaryExpectation, loadBackendFederatedEffectApiFromManifest, loadBackendFederationManifest, resolveBackendFederationRemoteFromManifest, } from './backend-federation-manifest';
 export { type CreateEffectOperationContextOptions, createEffectOperationContext, type EffectContext, runWithEffectContext, useEffectContext, useOperationContext, } from './context';
 export { createEffectBffEdgeHandler, createEffectBffTestHandler, dispatchEffectBffRequest, } from './edge';
 export * from './handler';

package/package.json

@@ -17,7 +17,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.5.0-ultramodern.28",
+  "version": "3.5.0-ultramodern.29",
   "types": "./dist/types/cli.d.ts",
   "main": "./dist/cjs/cli.js",
   "exports": {
@@ -69,6 +69,14 @@
       },
       "default": "./dist/cjs/runtime/effect/index.js"
     },
+    "./effect": {
+      "types": "./dist/types/runtime/effect/index.d.ts",
+      "node": {
+        "import": "./dist/esm-node/runtime/effect/index.mjs",
+        "require": "./dist/cjs/runtime/effect/index.js"
+      },
+      "default": "./dist/cjs/runtime/effect/index.js"
+    },
     "./effect-edge": {
       "types": "./dist/types/runtime/effect/edge.d.ts",
       "import": "./dist/esm/runtime/effect/edge.mjs",
@@ -124,6 +132,9 @@
       "effect-server": [
         "./dist/types/runtime/effect/index.d.ts"
       ],
+      "effect": [
+        "./dist/types/runtime/effect/index.d.ts"
+      ],
       "effect-edge": [
         "./dist/types/runtime/effect/edge.d.ts"
       ],
@@ -143,6 +154,7 @@
   },
   "dependencies": {
     "@effect/opentelemetry": "4.0.0-beta.92",
+    "@module-federation/runtime": "2.6.0",
     "@opentelemetry/api": "1.9.1",
     "@opentelemetry/api-logs": "0.219.0",
     "@opentelemetry/resources": "2.8.0",
@@ -157,12 +169,12 @@
     "effect": "4.0.0-beta.92",
     "qs": "^6.15.3",
     "type-is": "^2.1.0",
-    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.5.0-ultramodern.28",
-    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.5.0-ultramodern.28",
-    "@modern-js/server-utils": "npm:@bleedingdev/modern-js-server-utils@3.5.0-ultramodern.28",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.5.0-ultramodern.28",
-    "@modern-js/create-request": "npm:@bleedingdev/modern-js-create-request@3.5.0-ultramodern.28",
-    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.5.0-ultramodern.28"
+    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.5.0-ultramodern.29",
+    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.5.0-ultramodern.29",
+    "@modern-js/create-request": "npm:@bleedingdev/modern-js-create-request@3.5.0-ultramodern.29",
+    "@modern-js/server-utils": "npm:@bleedingdev/modern-js-server-utils@3.5.0-ultramodern.29",
+    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.5.0-ultramodern.29",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.5.0-ultramodern.29"
   },
   "devDependencies": {
     "@rsbuild/core": "2.1.1",
@@ -174,12 +186,12 @@
     "memfs": "^4.57.8",
     "typescript": "^6.0.3",
     "zod": "^4.4.3",
-    "@modern-js/bff-runtime": "npm:@bleedingdev/modern-js-bff-runtime@3.5.0-ultramodern.28",
-    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.5.0-ultramodern.28",
-    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.5.0-ultramodern.28",
-    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.5.0-ultramodern.28",
-    "@scripts/rstest-config": "2.66.0",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.5.0-ultramodern.28"
+    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.5.0-ultramodern.29",
+    "@modern-js/bff-runtime": "npm:@bleedingdev/modern-js-bff-runtime@3.5.0-ultramodern.29",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.5.0-ultramodern.29",
+    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.5.0-ultramodern.29",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.5.0-ultramodern.29",
+    "@scripts/rstest-config": "2.66.0"
   },
   "sideEffects": false,
   "publishConfig": {