@bleedingdev/modern-js-plugin-bff 3.5.0-ultramodern.3 → 3.5.0-ultramodern.31

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

@@ -0,0 +1,6 @@
+import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from '@modern-js/utils/universal';
+export { loadBackendFederatedEffectApi } from './backend-federation/load';
+export { createBackendFederationLoadEntryPlugin } from './backend-federation/plugin';
+export { createBackendFederationRuntime } from './backend-federation/runtime';
+export type { BackendFederatedEffectApiModule, BackendFederationEntryExports, BackendFederationLoadEntryPluginOptions, BackendFederationRemote, BackendFederationRuntimeOptions, } from './backend-federation/types';
+export { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION, };

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/batch-handler.d.ts

@@ -0,0 +1,11 @@
+import type { EffectDataPlatformValidationOptions } from './types';
+type DataPlatformBatchItemHandler<TContext> = (request: Request, context?: TContext) => Promise<unknown>;
+export declare function createDataPlatformBatchRequestHandler<TContext>(options: {
+    dataPlatform?: EffectDataPlatformValidationOptions;
+    handleItem: DataPlatformBatchItemHandler<TContext>;
+}): {
+    enabled: boolean;
+    path: `/${string}`;
+    handle: (request: Request, context?: TContext) => Promise<Response>;
+};
+export {};

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

@@ -0,0 +1,17 @@
+import { type DataBatchRequestPayload, type DataBatchResponseItem } from '../../data-platform';
+export declare function normalizeBatchPath(pathname: string | undefined): `/${string}`;
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+export declare function toTextLength(value: string): number;
+export declare function toHeaderRecord(headers: Headers): Record<string, string>;
+export declare function normalizeItemMethod(method: string | undefined): string;
+export declare function normalizeBatchAllowedMethods(allowedMethods: string[] | undefined): Set<string>;
+type ParsedBatchRequestPayload = Omit<DataBatchRequestPayload, 'items'> & {
+    items: unknown[];
+};
+export declare function isBatchRequestPayload(value: unknown): value is ParsedBatchRequestPayload;
+export declare function createBatchValidationResponse(message: string, status?: number): Response;
+export declare function prepareJsonRequestBody(request: Request): Promise<Request | Response>;
+export declare function toBatchItemError(id: string, status: number, message: string): DataBatchResponseItem;
+export declare function promiseWithTimeout<T>(effect: Promise<T>, timeoutMs: number): Promise<T>;
+export declare function mapWithConcurrency<TItem, TResult>(items: readonly TItem[], concurrency: number, mapper: (item: TItem, index: number) => Promise<TResult>): Promise<TResult[]>;
+export {};

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

@@ -0,0 +1,17 @@
+import type { HttpApi } from 'effect/unstable/httpapi';
+import type { Rpc } from 'effect/unstable/rpc';
+import type { EffectBffRuntime, EffectDataPlatformValidationOptions, EffectRpcBffDefinition, EffectRpcBffHandlerFactory, EffectRpcRuntimeLayer, EffectRuntimeLayer } from './types';
+export declare function defineEffectBff<TApi extends HttpApi.AnyWithProps, TLayer extends EffectRuntimeLayer, TRpcs extends Rpc.Any = Rpc.Any>(definition: {
+    api: TApi;
+    layer: TLayer;
+    rpc?: EffectRpcBffDefinition<TRpcs>;
+    dataPlatform?: EffectDataPlatformValidationOptions;
+}): {
+    api: TApi;
+    layer: TLayer;
+    rpc?: EffectRpcBffDefinition<TRpcs>;
+    dataPlatform?: EffectDataPlatformValidationOptions;
+} & EffectBffRuntime<TApi, TLayer>;
+export declare function defineEffectRpcBff<TRpcs extends Rpc.Any = Rpc.Any, TLayer extends EffectRpcRuntimeLayer<TRpcs> = EffectRpcRuntimeLayer<TRpcs>>(definition: EffectRpcBffDefinition<TRpcs, TLayer>): EffectRpcBffDefinition<TRpcs, TLayer> & {
+    createHandler: EffectRpcBffHandlerFactory<TRpcs>;
+};

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

@@ -0,0 +1,13 @@
+import type { EffectDataPlatformValidationOptions } from './types';
+/**
+ * Validates the `x-modernjs-data-envelope` header (the data-platform
+ * transport/cache contract: protocol version, scope, selection plan).
+ *
+ * This is NOT a security boundary: the envelope is client-constructed cache
+ * metadata used for batching, scope keys and hydration. Cross-project
+ * authorization runs through the bff-core policy evaluator wired in via
+ * `validateRequest` (see `EffectRequestValidator`), which both the direct
+ * and batched request paths hit before this check.
+ */
+export declare function validateDataPlatformRequestEnvelope(request: Request, options: EffectDataPlatformValidationOptions | undefined): Response | null;
+export declare function mergeDataPlatformOptions(base: EffectDataPlatformValidationOptions | undefined, override: Partial<EffectDataPlatformValidationOptions> | undefined): EffectDataPlatformValidationOptions | undefined;

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

@@ -0,0 +1,14 @@
+import type { HttpApi } from 'effect/unstable/httpapi';
+import type { Rpc } from 'effect/unstable/rpc';
+import type { EffectBffOpenApiConfig, EffectDataPlatformValidationOptions, EffectRequestValidator, EffectRpcBffDefinition, EffectRuntimeLayer } from './types';
+export declare function createHttpApiHandler<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps, TRpcs extends Rpc.Any = Rpc.Any>(options: {
+    api: TApi;
+    layer: EffectRuntimeLayer;
+    openapi?: EffectBffOpenApiConfig;
+    rpc?: EffectRpcBffDefinition<TRpcs>;
+    dataPlatform?: EffectDataPlatformValidationOptions;
+    validateRequest?: EffectRequestValidator;
+}): {
+    handler: (request: Request, context?: Parameters<(request: globalThis.Request, context: import("effect/Context").Context<unknown>) => Promise<Response>>[1]) => Promise<Response>;
+    dispose: () => Promise<void>;
+};

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

@@ -0,0 +1,4 @@
+import { HttpRouter } from 'effect/unstable/http';
+import { type HttpApi } from 'effect/unstable/httpapi';
+import type { EffectBffOpenApiConfig } from './types';
+export declare function createOpenApiLayer(api: HttpApi.AnyWithProps, openapi: EffectBffOpenApiConfig | undefined): import("effect/Layer").Layer<never, never, HttpRouter.HttpRouter> | null;

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

@@ -0,0 +1,5 @@
+export declare function getRequestPathname(request: Request): string;
+export declare function getMountedPrefixFromContext(request: Request, context: unknown): string;
+export declare function removeMountedPrefixFromBatchPath(pathWithQuery: string, prefix: string): string;
+export declare function getExpectedEnvelopeOrigin(request: Request): string;
+export declare function isRpcRequest(request: Request, rpcPath: `/${string}`): boolean;

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

@@ -0,0 +1,7 @@
+import { type Rpc } from 'effect/unstable/rpc';
+import type { EffectRpcBffDefinition } from './types';
+export declare function normalizeRpcPath(pathname: string | undefined): `/${string}`;
+export declare function createRpcApiHandler<TRpcs extends Rpc.Any = Rpc.Any>(options: EffectRpcBffDefinition<TRpcs>): {
+    readonly handler: (request: globalThis.Request, context?: import("effect/Context").Context<never> | undefined) => Promise<Response>;
+    readonly dispose: () => Promise<void>;
+};

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

@@ -0,0 +1,148 @@
+import type { FileSystem, Path } from 'effect';
+import * as Context from 'effect/Context';
+import type * as EffectType from 'effect/Effect';
+import type * as Layer from 'effect/Layer';
+import type { Etag, HttpPlatform, HttpRouter } from 'effect/unstable/http';
+import type { HttpApi, HttpApiClient, HttpApiGroup } from 'effect/unstable/httpapi';
+import type { Rpc, RpcGroup } from 'effect/unstable/rpc';
+import type { createHttpApiHandler } from './http';
+import type { createRpcApiHandler } from './rpc';
+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 declare const toEffectServiceContext: (context: unknown) => Context.Context<any>;
+export type EffectRpcSerialization = 'json' | 'ndjson' | 'jsonRpc' | 'ndJsonRpc' | 'msgPack';
+export type EffectRpcRuntimeLayer<TRpcs extends Rpc.Any = Rpc.Any> = Layer.Layer<Rpc.ToHandler<TRpcs> | Rpc.Middleware<TRpcs> | Rpc.ServicesServer<TRpcs>, unknown, never>;
+export type EffectRpcBffDefinition<TRpcs extends Rpc.Any = Rpc.Any, TRpcLayer extends EffectRpcRuntimeLayer<TRpcs> = EffectRpcRuntimeLayer<TRpcs>> = {
+    group: RpcGroup.RpcGroup<TRpcs>;
+    layer: TRpcLayer;
+    path?: `/${string}`;
+    serialization?: EffectRpcSerialization;
+    disableTracing?: boolean;
+    spanPrefix?: string;
+    spanAttributes?: Record<string, unknown>;
+    disableFatalDefects?: boolean;
+};
+export type EffectRpcBffHandlerOptions = Pick<EffectRpcBffDefinition, 'path' | 'serialization' | 'disableTracing' | 'spanPrefix' | 'spanAttributes' | 'disableFatalDefects'>;
+type EffectApiPromiseClient<TClient> = {
+    [GroupName in keyof TClient]: {
+        [EndpointName in keyof TClient[GroupName]]: TClient[GroupName][EndpointName] extends (...args: infer TArgs) => infer TResult ? TResult extends EffectType.Effect<unknown, unknown, unknown> ? (...args: TArgs) => Promise<Exclude<EffectType.Success<TResult>, readonly [unknown, unknown]>> : never : never;
+    };
+};
+export type EffectApiClientFromApi<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps> = TApi extends HttpApi.HttpApi<infer _ApiId, infer Groups> ? HttpApiClient.Client<Extract<Groups, HttpApiGroup.Any>, never, never> : never;
+export type EffectApiPromiseClientFromApi<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps> = EffectApiPromiseClient<EffectApiClientFromApi<TApi>>;
+export type EffectBffDefinition<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps, TLayer extends EffectRuntimeLayer = EffectRuntimeLayer, TRpcs extends Rpc.Any = Rpc.Any> = {
+    api: TApi;
+    layer: TLayer;
+    rpc?: EffectRpcBffDefinition<TRpcs>;
+    dataPlatform?: EffectDataPlatformValidationOptions;
+};
+export type EffectDataPlatformSelectionValidationOptions = {
+    maxDepth?: number;
+    maxFields?: number;
+    allowedLeafPaths?: string[];
+};
+export type EffectDataPlatformBatchOptions = {
+    /**
+     * Enable network batching endpoint for Effect HttpApi requests.
+     * Defaults to `true`.
+     */
+    enabled?: boolean;
+    /**
+     * Batch endpoint path mounted under BFF prefix.
+     * Defaults to `/_data/batch`.
+     */
+    endpoint?: `/${string}`;
+    /**
+     * Maximum request items accepted per batch call.
+     * Defaults to `16`.
+     */
+    maxBatchSize?: number;
+    /**
+     * Maximum serialized request payload size in bytes.
+     * Defaults to `65536` (64KiB).
+     */
+    maxBatchBytes?: number;
+    /**
+     * Client-side micro-batch flush window in milliseconds.
+     * Server runtime ignores this value and passes it through for codegen.
+     * Defaults to `8`.
+     */
+    flushIntervalMs?: number;
+    /**
+     * Maximum per-batch internal request concurrency.
+     * Defaults to `4`.
+     */
+    maxConcurrency?: number;
+    /**
+     * Optional timeout per internal request in milliseconds.
+     * Defaults to `10000`.
+     */
+    requestTimeoutMs?: number;
+    /**
+     * Allowed HTTP methods for internal batched dispatch.
+     * Defaults to `['GET']`.
+     */
+    allowedMethods?: string[];
+};
+export type EffectDataPlatformValidationOptions = {
+    /**
+     * Enable envelope validation for HttpApi requests.
+     * Defaults to `true`.
+     */
+    enabled?: boolean;
+    /**
+     * Require every HttpApi request to include an envelope header.
+     * Defaults to `false`.
+     */
+    requireEnvelope?: boolean;
+    /**
+     * Header name used by client/server for the serialized request envelope.
+     * Defaults to `x-modernjs-data-envelope`.
+     */
+    envelopeHeader?: string;
+    /**
+     * Optional namespace assertion for envelope validation.
+     */
+    expectedNamespace?: string;
+    /**
+     * Validate envelope origin against incoming request origin.
+     * Defaults to `true`.
+     */
+    validateOrigin?: boolean;
+    /**
+     * Require trace context inside request envelope.
+     * Defaults to `false`.
+     */
+    requireTraceContext?: boolean;
+    /**
+     * Selection plan guardrails for server-side validation.
+     */
+    selection?: EffectDataPlatformSelectionValidationOptions;
+    /**
+     * Network batching gateway configuration.
+     */
+    batch?: EffectDataPlatformBatchOptions;
+};
+/**
+ * Server-seam request validator applied to every HttpApi request — direct,
+ * batched (per item) and rpc. Returning a Response short-circuits the
+ * request; returning `null`/`undefined` lets it through. Used by the effect
+ * adapter to enforce the cross-project policy at one seam so batched items
+ * cannot bypass it.
+ */
+export type EffectRequestValidator = (request: Request) => Response | null | undefined;
+export type EffectBffHandlerFactory<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps, TLayer extends EffectRuntimeLayer = EffectRuntimeLayer> = (options?: {
+    openapi?: EffectBffOpenApiConfig;
+    rpc?: Partial<EffectRpcBffHandlerOptions>;
+    dataPlatform?: Partial<EffectDataPlatformValidationOptions>;
+    validateRequest?: EffectRequestValidator;
+}) => ReturnType<typeof createHttpApiHandler>;
+export type EffectBffRuntime<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps, TLayer extends EffectRuntimeLayer = EffectRuntimeLayer> = {
+    createHandler: EffectBffHandlerFactory<TApi, TLayer>;
+    client: EffectApiPromiseClientFromApi<TApi>;
+};
+export type EffectBffOpenApiConfig = boolean | {
+    path?: string;
+};
+export type EffectRpcBffHandlerFactory<TRpcs extends Rpc.Any = Rpc.Any> = (options?: Partial<EffectRpcBffHandlerOptions>) => ReturnType<typeof createRpcApiHandler<TRpcs>>;
+export {};

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

@@ -1,10 +1,3 @@
-import type { FileSystem, Path } from 'effect';
-import * as Context from 'effect/Context';
-import type * as EffectType from 'effect/Effect';
-import * as Layer from 'effect/Layer';
-import { Etag, HttpPlatform, HttpRouter } from 'effect/unstable/http';
-import { type HttpApi, type HttpApiClient, type HttpApiGroup } from 'effect/unstable/httpapi';
-import { type Rpc, type RpcGroup } from 'effect/unstable/rpc';
 export * as Config from 'effect/Config';
 export * as Effect from 'effect/Effect';
 export * as Layer from 'effect/Layer';
@@ -15,186 +8,7 @@ export { HttpTraceContext } from 'effect/unstable/http';
 export * from 'effect/unstable/httpapi';
 export { HttpApiBuilder } from 'effect/unstable/httpapi';
 export * from 'effect/unstable/rpc';
-export type EffectRuntimeRequirements = Etag.Generator | FileSystem.FileSystem | HttpPlatform.HttpPlatform | HttpRouter.HttpRouter | HttpRouter.Request<'Error', any> | HttpRouter.Request<'GlobalError', any> | HttpRouter.Request<'GlobalRequires', any> | HttpRouter.Request<'Requires', any> | Path.Path;
-export type EffectRuntimeLayer = Layer.Layer<never, never, EffectRuntimeRequirements>;
-export type EffectRpcSerialization = 'json' | 'ndjson' | 'jsonRpc' | 'ndJsonRpc' | 'msgPack';
-export type EffectRpcRuntimeLayer<TRpcs extends Rpc.Any = Rpc.Any> = Layer.Layer<Rpc.ToHandler<TRpcs> | Rpc.Middleware<TRpcs> | Rpc.ServicesServer<TRpcs>, unknown, never>;
-export type EffectRpcBffDefinition<TRpcs extends Rpc.Any = Rpc.Any, TRpcLayer extends EffectRpcRuntimeLayer<TRpcs> = EffectRpcRuntimeLayer<TRpcs>> = {
-    group: RpcGroup.RpcGroup<TRpcs>;
-    layer: TRpcLayer;
-    path?: `/${string}`;
-    serialization?: EffectRpcSerialization;
-    disableTracing?: boolean;
-    spanPrefix?: string;
-    spanAttributes?: Record<string, unknown>;
-    disableFatalDefects?: boolean;
-};
-export type EffectRpcBffHandlerOptions = Pick<EffectRpcBffDefinition, 'path' | 'serialization' | 'disableTracing' | 'spanPrefix' | 'spanAttributes' | 'disableFatalDefects'>;
-type EffectApiPromiseClient<TClient> = {
-    [GroupName in keyof TClient]: {
-        [EndpointName in keyof TClient[GroupName]]: TClient[GroupName][EndpointName] extends (...args: infer TArgs) => infer TResult ? TResult extends EffectType.Effect<unknown, unknown, unknown> ? (...args: TArgs) => Promise<Exclude<EffectType.Success<TResult>, readonly [unknown, unknown]>> : never : never;
-    };
-};
-export type EffectApiClientFromApi<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps> = TApi extends HttpApi.HttpApi<infer _ApiId, infer Groups> ? HttpApiClient.Client<Extract<Groups, HttpApiGroup.Any>, unknown, never> : never;
-export type EffectApiPromiseClientFromApi<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps> = EffectApiPromiseClient<EffectApiClientFromApi<TApi>>;
-export type EffectBffDefinition<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps, TLayer extends EffectRuntimeLayer = EffectRuntimeLayer, TRpcs extends Rpc.Any = Rpc.Any> = {
-    api: TApi;
-    layer: TLayer;
-    rpc?: EffectRpcBffDefinition<TRpcs>;
-    dataPlatform?: EffectDataPlatformValidationOptions;
-};
-export type EffectDataPlatformSelectionValidationOptions = {
-    maxDepth?: number;
-    maxFields?: number;
-    allowedLeafPaths?: string[];
-};
-export type EffectDataPlatformBatchOptions = {
-    /**
-     * Enable network batching endpoint for Effect HttpApi requests.
-     * Defaults to `true`.
-     */
-    enabled?: boolean;
-    /**
-     * Batch endpoint path mounted under BFF prefix.
-     * Defaults to `/_data/batch`.
-     */
-    endpoint?: `/${string}`;
-    /**
-     * Maximum request items accepted per batch call.
-     * Defaults to `16`.
-     */
-    maxBatchSize?: number;
-    /**
-     * Maximum serialized request payload size in bytes.
-     * Defaults to `65536` (64KiB).
-     */
-    maxBatchBytes?: number;
-    /**
-     * Client-side micro-batch flush window in milliseconds.
-     * Server runtime ignores this value and passes it through for codegen.
-     * Defaults to `8`.
-     */
-    flushIntervalMs?: number;
-    /**
-     * Maximum per-batch internal request concurrency.
-     * Defaults to `4`.
-     */
-    maxConcurrency?: number;
-    /**
-     * Optional timeout per internal request in milliseconds.
-     * Defaults to `10000`.
-     */
-    requestTimeoutMs?: number;
-    /**
-     * Allowed HTTP methods for internal batched dispatch.
-     * Defaults to `['GET']`.
-     */
-    allowedMethods?: string[];
-};
-export type EffectDataPlatformValidationOptions = {
-    /**
-     * Enable envelope validation for HttpApi requests.
-     * Defaults to `true`.
-     */
-    enabled?: boolean;
-    /**
-     * Require every HttpApi request to include an envelope header.
-     * Defaults to `false`.
-     */
-    requireEnvelope?: boolean;
-    /**
-     * Header name used by client/server for the serialized request envelope.
-     * Defaults to `x-modernjs-data-envelope`.
-     */
-    envelopeHeader?: string;
-    /**
-     * Optional namespace assertion for envelope validation.
-     */
-    expectedNamespace?: string;
-    /**
-     * Validate envelope origin against incoming request origin.
-     * Defaults to `true`.
-     */
-    validateOrigin?: boolean;
-    /**
-     * Require trace context inside request envelope.
-     * Defaults to `false`.
-     */
-    requireTraceContext?: boolean;
-    /**
-     * Selection plan guardrails for server-side validation.
-     */
-    selection?: EffectDataPlatformSelectionValidationOptions;
-    /**
-     * Network batching gateway configuration.
-     */
-    batch?: EffectDataPlatformBatchOptions;
-};
-/**
- * Server-seam request validator applied to every HttpApi request — direct,
- * batched (per item) and rpc. Returning a Response short-circuits the
- * request; returning `null`/`undefined` lets it through. Used by the effect
- * adapter to enforce the cross-project policy at one seam so batched items
- * 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>;
-    dataPlatform?: Partial<EffectDataPlatformValidationOptions>;
-    validateRequest?: EffectRequestValidator;
-}) => ReturnType<typeof createHttpApiHandler>;
-export type EffectBffRuntime<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps, TLayer extends EffectRuntimeLayer = EffectRuntimeLayer> = {
-    createHandler: EffectBffHandlerFactory<TApi, TLayer>;
-    client: EffectApiPromiseClientFromApi<TApi>;
-};
-export type EffectBffOpenApiConfig = boolean | {
-    path?: string;
-};
-export type EffectRpcBffHandlerFactory<TRpcs extends Rpc.Any = Rpc.Any> = (options?: Partial<EffectRpcBffHandlerOptions>) => ReturnType<typeof createRpcApiHandler<TRpcs>>;
-declare function createRpcApiHandler<TRpcs extends Rpc.Any = Rpc.Any>(options: EffectRpcBffDefinition<TRpcs>): {
-    readonly handler: (request: globalThis.Request, context?: Context.Context<never> | undefined) => Promise<Response>;
-    readonly dispose: () => Promise<void>;
-};
-export declare function defineEffectBff<TApi extends HttpApi.AnyWithProps, TLayer extends EffectRuntimeLayer, TRpcs extends Rpc.Any = Rpc.Any>(definition: {
-    api: TApi;
-    layer: TLayer;
-    rpc?: EffectRpcBffDefinition<TRpcs>;
-    dataPlatform?: EffectDataPlatformValidationOptions;
-}): {
-    api: TApi;
-    layer: TLayer;
-    rpc?: EffectRpcBffDefinition<TRpcs>;
-    dataPlatform?: EffectDataPlatformValidationOptions;
-} & EffectBffRuntime<TApi, TLayer>;
-export declare function defineEffectRpcBff<TRpcs extends Rpc.Any = Rpc.Any, TLayer extends EffectRpcRuntimeLayer<TRpcs> = EffectRpcRuntimeLayer<TRpcs>>(definition: EffectRpcBffDefinition<TRpcs, TLayer>): EffectRpcBffDefinition<TRpcs, TLayer> & {
-    createHandler: EffectRpcBffHandlerFactory<TRpcs>;
-};
-export declare function createHttpApiHandler<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps, TRpcs extends Rpc.Any = Rpc.Any>(options: {
-    api: TApi;
-    layer: EffectRuntimeLayer;
-    openapi?: EffectBffOpenApiConfig;
-    rpc?: EffectRpcBffDefinition<TRpcs>;
-    dataPlatform?: EffectDataPlatformValidationOptions;
-    validateRequest?: EffectRequestValidator;
-}): {
-    handler: (request: Request, context?: Parameters<(request: globalThis.Request, context: Context.Context<any>) => Promise<Response>>[1]) => Promise<Response>;
-    dispose: () => Promise<void>;
-};
+export { EFFECT_VALIDATOR_AWARE_FACTORY, isValidatorAwareHandlerFactory, } from './entry-shape';
+export { defineEffectBff, defineEffectRpcBff } from './handler/definition';
+export { createHttpApiHandler } from './handler/http';
+export type { EffectApiClientFromApi, EffectApiPromiseClientFromApi, EffectBffDefinition, EffectBffHandlerFactory, EffectBffOpenApiConfig, EffectBffRuntime, EffectDataPlatformBatchOptions, EffectDataPlatformSelectionValidationOptions, EffectDataPlatformValidationOptions, EffectRequestValidator, EffectRpcBffDefinition, EffectRpcBffHandlerFactory, EffectRpcBffHandlerOptions, EffectRpcRuntimeLayer, EffectRpcSerialization, EffectRuntimeLayer, EffectRuntimeRequirements, } from './handler/types';

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/dist/types/runtime/effect/rpcSerialization.d.ts

@@ -0,0 +1,3 @@
+import { RpcSerialization } from 'effect/unstable/rpc';
+import type { EffectRpcSerialization } from './handler/types';
+export declare function getRpcSerializationLayer(serialization: EffectRpcSerialization | undefined): import("effect/Layer").Layer<RpcSerialization.RpcSerialization, never, never>;

package/dist/types/runtime/effect-client/batch.d.ts

@@ -0,0 +1,2 @@
+import type { EffectRequestRuntime, GeneratedEffectClientConfig } from './types';
+export declare const configureGeneratedEffectClientRuntime: (config: GeneratedEffectClientConfig, configureRequest: EffectRequestRuntime['configure'] | undefined) => void;

package/dist/types/runtime/effect-client/envelope.d.ts

@@ -0,0 +1,15 @@
+import type { EffectOperationDescriptor, EffectRequestContext, EffectRequestContextInput, GeneratedEffectClientConfig, GeneratedEffectEndpoint } from './types';
+/**
+ * Resolves the current page origin with a configurable fallback. Single
+ * implementation shared by the configure() bootstrap and the data envelope
+ * (the generated template previously duplicated data-platform's
+ * `resolveRuntimeOrigin` with a different fallback).
+ */
+export declare const resolveOrigin: (defaultOrigin: string) => string;
+export declare const prepareEffectRequest: (options: {
+    endpoint: GeneratedEffectEndpoint;
+    operation: EffectOperationDescriptor;
+    request: unknown;
+    config: GeneratedEffectClientConfig;
+    createEffectRequestContext: (requestContext: EffectRequestContextInput) => EffectRequestContext;
+}) => Record<string, unknown>;

package/dist/types/runtime/effect-client/guards.d.ts

@@ -0,0 +1,2 @@
+export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
+export declare const stringOrUndefined: (value: unknown) => string | undefined;

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

@@ -53,6 +53,6 @@ export type EffectRpcClientHandle<Rpcs extends Rpc.Any, Flatten extends boolean
 export declare function view<T>(): <const Selection extends EffectViewSelection<T>>(selection: Selection) => Selection;
 export declare function mask<T, const Selection extends EffectViewSelection<T>>(value: T, selection: Selection): EffectViewData<T, Selection>;
 export declare function runEffectView<T, const Selection extends EffectViewSelection<T>>(request: PromiseLike<T>, selection: Selection): Promise<EffectViewData<T, Selection>>;
-export declare function makeEffectHttpApiClient<ApiId extends string, Groups extends HttpApiGroup.Any>(api: HttpApi.HttpApi<ApiId, Groups>, options?: EffectHttpApiClientOptions): Effect.Effect<HttpApiClient.Client<Groups>, never, HttpApiGroup.MiddlewareClient<Groups>>;
+export declare function makeEffectHttpApiClient<ApiId extends string, Groups extends HttpApiGroup.Any>(api: HttpApi.HttpApi<ApiId, Groups>, options?: EffectHttpApiClientOptions): Effect.Effect<HttpApiClient.Client<Groups, never, never>, never, HttpApiGroup.MiddlewareClient<Groups>>;
 export declare function makeEffectRpcClient<Rpcs extends Rpc.Any, const Flatten extends boolean = false>(group: RpcGroup.RpcGroup<Rpcs>, options: EffectRpcClientOptions<Rpcs, Flatten>): Effect.Effect<EffectRpcClientHandle<Rpcs, Flatten>, EffectRpcClientError, never>;
 export declare const runEffectRequest: <A, E>(effect: Effect.Effect<A, E>, options?: Effect.RunOptions | undefined) => Promise<A>;

package/dist/types/runtime/effect-client/request-context.d.ts

@@ -0,0 +1,3 @@
+import type { EffectRequestContext, EffectRequestContextInput, EffectRequestRuntime } from './types';
+export declare const createEffectRequestContext: (createRequestContextHeaders: EffectRequestRuntime['createRequestContextHeaders'], requestContext: EffectRequestContextInput) => EffectRequestContext;
+export declare const applyRequestContext: (normalizedRequest: Record<string, unknown>, request: unknown, createRequestContext: (requestContext: EffectRequestContextInput) => EffectRequestContext) => Record<string, unknown>;

package/dist/types/runtime/effect-client/request.d.ts

@@ -0,0 +1 @@
+export declare const normalizeRequest: (method: string, request: unknown) => Record<string, unknown>;