@bleedingdev/modern-js-bff-effect 3.8.3-ultramodern.2

package/dist/esm/effect/entry-shape.mjs

@@ -0,0 +1,51 @@
+function createLocalValidatorAwareHandlerFactoryRegistry() {
+    const factories = new WeakSet();
+    return {
+        register (factory) {
+            factories.add(factory);
+            return factory;
+        },
+        is (factory) {
+            return 'function' == typeof factory && factories.has(factory);
+        }
+    };
+}
+const validatorAwareHandlerFactoryRegistry = createLocalValidatorAwareHandlerFactoryRegistry();
+function registerValidatorAwareHandlerFactory(factory) {
+    return validatorAwareHandlerFactoryRegistry.register(factory);
+}
+function isValidatorAwareHandlerFactory(factory) {
+    return validatorAwareHandlerFactoryRegistry.is(factory);
+}
+const strictEffectApproachMessage = '[BFF][Effect] strictEffectApproach is enforced: Effect API entries export defineEffectBff(...) or { api, layer } HttpApi module. Raw handler exports, default request handlers, unbranded custom createHandler factories not valid Effect API entries.';
+function isEffectEntryRecord(value) {
+    return 'object' == typeof value && null !== value;
+}
+function classifyEffectBffEntryModule(value, predicates) {
+    if (!isEffectEntryRecord(value)) return null;
+    const rootModule = value;
+    if (predicates.isRequestHandler(rootModule.handler)) return createEntryShapeFacts(rootModule, predicates, '`handler` export');
+    const defaultEntry = rootModule.default;
+    if (predicates.isRequestHandler(defaultEntry)) return createEntryShapeFacts(rootModule, predicates, 'default request handler');
+    const module = isEffectEntryRecord(defaultEntry) ? {
+        ...rootModule,
+        ...defaultEntry
+    } : rootModule;
+    if (predicates.isRequestHandler(module.handler)) return createEntryShapeFacts(module, predicates, '`handler` export');
+    return createEntryShapeFacts(module, predicates);
+}
+function createEntryShapeFacts(module, predicates, legacyShape) {
+    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,
+        createHandler,
+        createHandlerValidatorAware: void 0 !== createHandler && predicates.isValidatorAwareHandlerFactory(createHandler),
+        api,
+        layer: module.layer,
+        hasRuntimeLayer
+    };
+}
+export { classifyEffectBffEntryModule, isValidatorAwareHandlerFactory, registerValidatorAwareHandlerFactory, strictEffectApproachMessage };

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

@@ -0,0 +1,232 @@
+import { DEFAULT_DATA_BATCH_HEADER, DEFAULT_DATA_ENVELOPE_HEADER, decodeRequestEnvelopeHeader, isPlainObject, normalizeMethod } from "../../data-platform/index.mjs";
+import { decodeBatchBody, isBatchBody, toBatchResponseItem } from "../../data-platform/batch/protocol.mjs";
+import { BatchItemTimeoutError, createBatchValidationResponse, isBatchRequestPayload, mapWithConcurrency, normalizeBatchAllowedMethods, normalizeBatchPath, promiseWithTimeout, toBatchItemError } from "./batch.mjs";
+import { getMountedPrefixFromContext, removeMountedPrefixFromBatchPath } from "./routing.mjs";
+const HOP_BY_HOP_BATCH_ITEM_HEADERS = new Set([
+    'connection',
+    'keep-alive',
+    'proxy-authenticate',
+    'proxy-authorization',
+    'proxy-connection',
+    'te',
+    'trailer',
+    'transfer-encoding',
+    'upgrade'
+]);
+const OUTER_BOUND_BATCH_ITEM_HEADERS = new Set([
+    'authorization',
+    'cookie',
+    'forwarded',
+    'origin',
+    'referer',
+    'sec-fetch-dest',
+    'sec-fetch-mode',
+    'sec-fetch-site',
+    'sec-fetch-user',
+    'x-forwarded-client-cert',
+    'x-forwarded-for',
+    'x-forwarded-host',
+    'x-forwarded-port',
+    'x-forwarded-proto',
+    'x-real-ip',
+    'x-subject-id',
+    'x-tenant-id',
+    'x-user-id',
+    'x-verified-producer'
+]);
+const TRANSPORT_CONTROLLED_BATCH_ITEM_HEADERS = new Set([
+    'content-length',
+    'host',
+    ...HOP_BY_HOP_BATCH_ITEM_HEADERS
+]);
+async function readRequestTextWithinLimit(request, maxBytes) {
+    const contentLength = request.headers.get('content-length');
+    if (null !== contentLength) {
+        if (!/^\d+$/.test(contentLength)) return {
+            status: 'invalid-content-length'
+        };
+        if (BigInt(contentLength) > BigInt(maxBytes)) return {
+            status: 'too-large'
+        };
+    }
+    if (null === request.body) return {
+        status: 'ok',
+        text: ''
+    };
+    const reader = request.body.getReader();
+    const decoder = new TextDecoder();
+    const text = [];
+    let bytesRead = 0;
+    try {
+        while(true){
+            const chunk = await reader.read();
+            if (chunk.done) {
+                text.push(decoder.decode());
+                return {
+                    status: 'ok',
+                    text: text.join('')
+                };
+            }
+            bytesRead += chunk.value.byteLength;
+            if (bytesRead > maxBytes) {
+                await reader.cancel('batch-payload-too-large');
+                return {
+                    status: 'too-large'
+                };
+            }
+            text.push(decoder.decode(chunk.value, {
+                stream: true
+            }));
+        }
+    } catch  {
+        return {
+            status: 'read-error'
+        };
+    } finally{
+        reader.releaseLock();
+    }
+}
+function createDataPlatformBatchRequestHandler(options) {
+    const dataPlatformBatchOptions = options.dataPlatform?.batch;
+    const batchEnabled = dataPlatformBatchOptions?.enabled !== false;
+    const batchPath = normalizeBatchPath(dataPlatformBatchOptions?.endpoint);
+    const batchMaxSize = Math.max(1, dataPlatformBatchOptions?.maxBatchSize ?? 16);
+    const batchMaxBytes = Math.max(1024, dataPlatformBatchOptions?.maxBatchBytes ?? 65536);
+    const batchConcurrency = Math.max(1, dataPlatformBatchOptions?.maxConcurrency ?? 4);
+    const batchItemTimeoutMs = Math.max(0, dataPlatformBatchOptions?.requestTimeoutMs ?? 10000);
+    const batchAllowedMethods = normalizeBatchAllowedMethods(dataPlatformBatchOptions?.allowedMethods);
+    const envelopeHeader = options.dataPlatform?.envelopeHeader || DEFAULT_DATA_ENVELOPE_HEADER;
+    const normalizedEnvelopeHeader = envelopeHeader.toLowerCase();
+    const handle = async (request, context)=>{
+        const mountedPrefix = getMountedPrefixFromContext(request, context);
+        const method = normalizeMethod(request.method);
+        if ('POST' !== method) return createBatchValidationResponse('Batch endpoint only supports POST requests', 405);
+        const contentType = request.headers.get('content-type') || '';
+        if (!contentType.includes('application/json')) return createBatchValidationResponse('Batch endpoint requires application/json content-type', 415);
+        const bodyResult = await readRequestTextWithinLimit(request, batchMaxBytes);
+        if ('too-large' === bodyResult.status) return createBatchValidationResponse(`Batch payload exceeds max size (${String(batchMaxBytes)} bytes)`, 413);
+        if ('invalid-content-length' === bodyResult.status) return createBatchValidationResponse('Batch payload has invalid content-length');
+        if ('read-error' === bodyResult.status) return createBatchValidationResponse('Unable to read batch payload');
+        const payloadText = bodyResult.text;
+        let payload;
+        try {
+            payload = JSON.parse(payloadText);
+        } catch  {
+            return createBatchValidationResponse('Invalid batch payload JSON');
+        }
+        if (!isBatchRequestPayload(payload)) return createBatchValidationResponse('Invalid batch payload shape');
+        if (0 === payload.items.length) return createBatchValidationResponse('Batch payload items cannot be empty');
+        if (payload.items.length > batchMaxSize) return createBatchValidationResponse(`Batch item count exceeds max size (${String(batchMaxSize)})`, 413);
+        const batchRequestOrigin = new URL(request.url).origin;
+        const responseItems = await mapWithConcurrency(payload.items, batchConcurrency, async (rawItem, index)=>{
+            const fallbackId = `item_${String(index)}`;
+            const itemId = isPlainObject(rawItem) && 'string' == typeof rawItem.id ? rawItem.id : fallbackId;
+            if (!isPlainObject(rawItem)) return toBatchItemError(itemId, 400, 'Invalid batch item; expected object');
+            if ('string' != typeof rawItem.path || 0 === rawItem.path.length) return toBatchItemError(itemId, 400, 'Invalid batch item path');
+            if (!rawItem.path.startsWith('/')) return toBatchItemError(itemId, 400, 'Batch item path must start with "/"');
+            const normalizedItemPath = removeMountedPrefixFromBatchPath(rawItem.path, mountedPrefix);
+            const itemPathname = normalizedItemPath.split('?')[0] || normalizedItemPath;
+            if (itemPathname === batchPath || itemPathname.startsWith(`${batchPath}/`)) return toBatchItemError(itemId, 400, 'Batch item path cannot target batch endpoint');
+            const itemMethod = normalizeMethod('string' == typeof rawItem.method ? rawItem.method : void 0);
+            if (!batchAllowedMethods.has(itemMethod)) return toBatchItemError(itemId, 405, `Batch item method ${itemMethod} is not allowed`);
+            if (void 0 !== rawItem.body && !isBatchBody(rawItem.body)) return toBatchItemError(itemId, 400, 'Batch item body must use the base64 body protocol');
+            if (('GET' === itemMethod || 'HEAD' === itemMethod) && void 0 !== rawItem.body) return toBatchItemError(itemId, 400, `${itemMethod} batch item cannot include body`);
+            const normalizedHeaders = {};
+            if (void 0 !== rawItem.headers) {
+                if (!isPlainObject(rawItem.headers)) return toBatchItemError(itemId, 400, 'Batch item headers must be an object');
+                for (const [key, value] of Object.entries(rawItem.headers)){
+                    if ('string' != typeof value) return toBatchItemError(itemId, 400, `Invalid header "${key}" for batch item`);
+                    normalizedHeaders[key.toLowerCase()] = value;
+                }
+            }
+            const connectionScopedHeaders = new Set((normalizedHeaders.connection || '').split(',').map((header)=>header.trim().toLowerCase()).filter(Boolean));
+            for (const header of Object.keys(normalizedHeaders))if (TRANSPORT_CONTROLLED_BATCH_ITEM_HEADERS.has(header) || OUTER_BOUND_BATCH_ITEM_HEADERS.has(header) || connectionScopedHeaders.has(header)) delete normalizedHeaders[header];
+            if (!normalizedHeaders.traceparent) {
+                const encodedEnvelope = normalizedHeaders[normalizedEnvelopeHeader];
+                if ('string' == typeof encodedEnvelope) {
+                    const envelope = decodeRequestEnvelopeHeader(encodedEnvelope);
+                    if (envelope?.traceparent) normalizedHeaders.traceparent = envelope.traceparent;
+                }
+            }
+            for (const header of OUTER_BOUND_BATCH_ITEM_HEADERS){
+                const value = request.headers.get(header);
+                if (null !== value) normalizedHeaders[header] = value;
+            }
+            if (!normalizedHeaders.traceparent) {
+                const requestTraceparent = request.headers.get('traceparent');
+                if (requestTraceparent) normalizedHeaders.traceparent = requestTraceparent;
+            }
+            const targetUrl = new URL(normalizedItemPath, request.url);
+            if (targetUrl.origin !== batchRequestOrigin) return toBatchItemError(itemId, 400, 'Batch item path must stay on the same origin');
+            let requestHeaders;
+            try {
+                requestHeaders = new Headers(normalizedHeaders);
+            } catch  {
+                return toBatchItemError(itemId, 400, 'Invalid batch item headers');
+            }
+            const body = 'GET' === itemMethod || 'HEAD' === itemMethod ? void 0 : void 0 === rawItem.body ? void 0 : decodeBatchBody(rawItem.body);
+            if (void 0 === body) requestHeaders.delete('content-type');
+            const itemAbortController = new AbortController();
+            const abortFromBatchRequest = ()=>itemAbortController.abort(request.signal.reason);
+            if (request.signal.aborted) abortFromBatchRequest();
+            else request.signal.addEventListener('abort', abortFromBatchRequest, {
+                once: true
+            });
+            const itemRequest = new Request(targetUrl.toString(), {
+                method: itemMethod,
+                headers: requestHeaders,
+                body,
+                signal: itemAbortController.signal
+            });
+            try {
+                const itemResponse = await promiseWithTimeout(options.handleItem(itemRequest, context), batchItemTimeoutMs, (error)=>itemAbortController.abort(error));
+                if (!(itemResponse instanceof Response)) return toBatchItemError(itemId, 500, 'Invalid response returned by batch item handler');
+                return toBatchResponseItem(itemId, itemResponse, 'HEAD' === itemMethod);
+            } catch (error) {
+                if (error instanceof BatchItemTimeoutError) {
+                    console.error({
+                        event: 'bff.batch.item.timeout',
+                        batchId: payload.batchId,
+                        itemId,
+                        method: itemMethod,
+                        path: itemPathname,
+                        errorName: error.name
+                    });
+                    return toBatchItemError(itemId, 504, 'Batch item request timed out');
+                }
+                if (error instanceof Response) return toBatchResponseItem(itemId, error, 'HEAD' === itemMethod);
+                console.error({
+                    event: 'bff.batch.item.failure',
+                    batchId: payload.batchId,
+                    itemId,
+                    method: itemMethod,
+                    path: itemPathname,
+                    errorName: error instanceof Error ? error.name : 'UnknownError'
+                });
+                return toBatchItemError(itemId, 500, 'Internal Server Error');
+            } finally{
+                request.signal.removeEventListener('abort', abortFromBatchRequest);
+            }
+        });
+        const responsePayload = {
+            protocolVersion: 2,
+            batchId: payload.batchId,
+            receivedAt: Date.now(),
+            items: responseItems
+        };
+        return new Response(JSON.stringify(responsePayload), {
+            status: 200,
+            headers: {
+                'content-type': 'application/json; charset=utf-8',
+                [DEFAULT_DATA_BATCH_HEADER]: '2',
+                'x-modernjs-data-batch-id': payload.batchId
+            }
+        });
+    };
+    return {
+        enabled: batchEnabled,
+        path: batchPath,
+        handle
+    };
+}
+export { createDataPlatformBatchRequestHandler };

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

@@ -0,0 +1,105 @@
+import { DEFAULT_DATA_BATCH_ENDPOINT, isPlainObject, normalizeMethod } from "../../data-platform/index.mjs";
+import { encodeBatchText } from "../../data-platform/batch/protocol.mjs";
+function normalizeBatchPath(pathname) {
+    if (!pathname || '/' === pathname) return DEFAULT_DATA_BATCH_ENDPOINT;
+    if (!pathname.startsWith('/')) return `/${pathname}`;
+    return pathname;
+}
+function normalizeBatchAllowedMethods(allowedMethods) {
+    const source = Array.isArray(allowedMethods) && allowedMethods.length > 0 ? allowedMethods : [
+        'GET'
+    ];
+    return new Set(source.map((method)=>method.toUpperCase()));
+}
+function isBatchRequestPayload(value) {
+    return isPlainObject(value) && 2 === value.protocolVersion && 'string' == typeof value.batchId && 'number' == typeof value.sentAt && Array.isArray(value.items);
+}
+function createBatchValidationResponse(message, status = 400) {
+    return new Response(JSON.stringify({
+        message
+    }), {
+        status,
+        headers: {
+            'content-type': 'application/json; charset=utf-8'
+        }
+    });
+}
+function cloneWithoutJsonBodyHeaders(request) {
+    const headers = new Headers(request.headers);
+    headers.delete('content-type');
+    headers.delete('content-length');
+    return new Request(request.url, {
+        method: request.method,
+        headers,
+        signal: request.signal
+    });
+}
+async function prepareJsonRequestBody(request) {
+    const method = normalizeMethod(request.method);
+    if ('GET' === method || 'HEAD' === method) return request;
+    const contentType = (request.headers.get('content-type') || '').toLowerCase();
+    if (!contentType.includes('application/json')) return request;
+    if (null === request.body) return cloneWithoutJsonBodyHeaders(request);
+    try {
+        const bodyText = await request.clone().text();
+        if ('' === bodyText) return cloneWithoutJsonBodyHeaders(request);
+        JSON.parse(bodyText);
+    } catch  {
+        return createBatchValidationResponse('Invalid JSON request body');
+    }
+    return request;
+}
+function toBatchItemError(id, status, message) {
+    return {
+        id,
+        status,
+        headers: [
+            [
+                'content-type',
+                'application/json; charset=utf-8'
+            ]
+        ],
+        body: encodeBatchText(JSON.stringify({
+            message
+        }))
+    };
+}
+class BatchItemTimeoutError extends Error {
+}
+function promiseWithTimeout(effect, timeoutMs, onTimeout) {
+    if (timeoutMs <= 0) return effect;
+    return new Promise((resolve, reject)=>{
+        const timer = setTimeout(()=>{
+            const error = new BatchItemTimeoutError(`Batch item timeout after ${String(timeoutMs)}ms`);
+            onTimeout?.(error);
+            reject(error);
+        }, timeoutMs);
+        effect.then((value)=>{
+            clearTimeout(timer);
+            resolve(value);
+        }, (error)=>{
+            clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+async function mapWithConcurrency(items, concurrency, mapper) {
+    if (0 === items.length) return [];
+    const normalizedConcurrency = Math.max(1, concurrency);
+    const output = new Array(items.length);
+    let index = 0;
+    const workers = Array.from({
+        length: Math.min(normalizedConcurrency, items.length)
+    }, async ()=>{
+        while(true){
+            const currentIndex = index;
+            index += 1;
+            if (currentIndex >= items.length) return;
+            output[currentIndex] = await mapper(items[currentIndex], currentIndex);
+        }
+    });
+    await Promise.all(workers);
+    return output;
+}
+export { toHeaderRecord } from "../../headers.mjs";
+export { BatchItemTimeoutError, createBatchValidationResponse, isBatchRequestPayload, mapWithConcurrency, normalizeBatchAllowedMethods, normalizeBatchPath, prepareJsonRequestBody, promiseWithTimeout, toBatchItemError };

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

@@ -0,0 +1,58 @@
+import { registerValidatorAwareHandlerFactory } from "../entry-shape.mjs";
+import { mergeDataPlatformOptions } from "./envelope.mjs";
+import { createHttpApiHandler } from "./http.mjs";
+import { createRpcApiHandler } from "./rpc.mjs";
+function defineEffectBff(definition) {
+    const createHandler = registerValidatorAwareHandlerFactory((options)=>{
+        const rpcDefinition = definition.rpc;
+        let mergedRpcOptions = rpcDefinition;
+        if (rpcDefinition && options?.rpc) mergedRpcOptions = {
+            ...rpcDefinition,
+            ...options.rpc
+        };
+        return createHttpApiHandler({
+            api: definition.api,
+            layer: definition.layer,
+            openapi: options?.openapi,
+            rpc: mergedRpcOptions,
+            dataPlatform: mergeDataPlatformOptions(definition.dataPlatform, options?.dataPlatform),
+            interceptRequest: definition.interceptRequest,
+            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.`);
+    };
+    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({
+            ...definition,
+            ...options
+        });
+    return {
+        ...definition,
+        createHandler
+    };
+}
+export { defineEffectBff, defineEffectRpcBff };

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

@@ -0,0 +1,63 @@
+import { DEFAULT_DATA_ENVELOPE_HEADER, decodeRequestEnvelopeHeader, validateRequestEnvelope, validateSelectionPlan } from "../../data-platform/index.mjs";
+import { getExpectedEnvelopeOrigin } from "./routing.mjs";
+function createInvalidEnvelopeResponse(message, errors) {
+    return new Response(JSON.stringify({
+        message,
+        ...errors && errors.length > 0 ? {
+            errors
+        } : {}
+    }), {
+        status: 400,
+        headers: {
+            'content-type': 'application/json; charset=utf-8'
+        }
+    });
+}
+function validateDataPlatformRequestEnvelope(request, options) {
+    const isEnabled = options?.enabled ?? true;
+    if (!isEnabled) return null;
+    const envelopeHeader = options?.envelopeHeader || DEFAULT_DATA_ENVELOPE_HEADER;
+    const encodedEnvelope = request.headers.get(envelopeHeader);
+    if (!encodedEnvelope) {
+        if (options?.requireEnvelope) return createInvalidEnvelopeResponse(`Missing required data envelope header: ${envelopeHeader}`);
+        return null;
+    }
+    const envelope = decodeRequestEnvelopeHeader(encodedEnvelope);
+    if (!envelope) return createInvalidEnvelopeResponse(`Invalid data envelope header format: ${envelopeHeader}`);
+    const validation = validateRequestEnvelope(envelope, {
+        expectedProtocolVersion: 1,
+        expectedNamespace: options?.expectedNamespace,
+        expectedOrigin: options?.validateOrigin === false ? void 0 : getExpectedEnvelopeOrigin(request),
+        requireTraceContext: options?.requireTraceContext
+    });
+    if (!validation.ok) return createInvalidEnvelopeResponse('Invalid data envelope', validation.errors);
+    if (envelope.selectionPlan) {
+        const selectionValidation = validateSelectionPlan(envelope.selectionPlan, {
+            maxDepth: options?.selection?.maxDepth,
+            maxFields: options?.selection?.maxFields,
+            allowedLeafPaths: options?.selection?.allowedLeafPaths
+        });
+        if (!selectionValidation.ok) return createInvalidEnvelopeResponse('Invalid data envelope selection plan', selectionValidation.errors);
+    }
+    return null;
+}
+function mergeDataPlatformOptions(base, override) {
+    if (!base && !override) return;
+    const baseSelection = base?.selection;
+    const overrideSelection = override?.selection;
+    const baseBatch = base?.batch;
+    const overrideBatch = override?.batch;
+    return {
+        ...base,
+        ...override,
+        selection: baseSelection || overrideSelection ? {
+            ...baseSelection,
+            ...overrideSelection
+        } : void 0,
+        batch: baseBatch || overrideBatch ? {
+            ...baseBatch,
+            ...overrideBatch
+        } : void 0
+    };
+}
+export { mergeDataPlatformOptions, validateDataPlatformRequestEnvelope };

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

@@ -0,0 +1,69 @@
+import { HttpRouter, HttpServer } from "effect/unstable/http";
+import { prepareJsonRequestBody } from "./batch.mjs";
+import { createDataPlatformBatchRequestHandler } from "./batch-handler.mjs";
+import { validateDataPlatformRequestEnvelope } from "./envelope.mjs";
+import { createOpenApiLayer } from "./openapi.mjs";
+import { getRequestPathname, isRpcRequest } from "./routing.mjs";
+import { createRpcApiHandler, normalizeRpcPath } from "./rpc.mjs";
+import { toEffectServiceContext } from "./types.mjs";
+import * as __rspack_external_effect_Layer_69c46453 from "effect/Layer";
+function createHttpApiHandler(options) {
+    const apiLayer = options.layer.pipe(__rspack_external_effect_Layer_69c46453.provide(HttpServer.layerServices));
+    const openApiLayer = createOpenApiLayer(options.api, options.openapi);
+    const mergedLayer = openApiLayer ? __rspack_external_effect_Layer_69c46453.mergeAll(apiLayer, openApiLayer) : apiLayer;
+    const httpApiHandler = HttpRouter.toWebHandler(mergedLayer);
+    const dispatchHttpApiRequest = async (request, context)=>{
+        const preparedRequest = await prepareJsonRequestBody(request);
+        if (preparedRequest instanceof Response) return preparedRequest;
+        const validationError = validateDataPlatformRequestEnvelope(preparedRequest, options.dataPlatform);
+        if (validationError) return validationError;
+        return httpApiHandler.handler(preparedRequest, toEffectServiceContext(context));
+    };
+    const withRequestPolicy = async (request, context)=>{
+        const policyDenial = options.validateRequest?.(request);
+        if (policyDenial) return policyDenial;
+        const next = ()=>dispatchHttpApiRequest(request, context);
+        return options.interceptRequest ? options.interceptRequest({
+            request,
+            next
+        }) : next();
+    };
+    const batchHandler = createDataPlatformBatchRequestHandler({
+        dataPlatform: options.dataPlatform,
+        handleItem: withRequestPolicy
+    });
+    const handleHttpApiRequest = async (request, context)=>{
+        const pathname = getRequestPathname(request);
+        if (batchHandler.enabled && pathname === batchHandler.path) return batchHandler.handle(request, context);
+        return withRequestPolicy(request, context);
+    };
+    if (!options.rpc) return {
+        handler: handleHttpApiRequest,
+        dispose: async ()=>{
+            await httpApiHandler.dispose();
+        }
+    };
+    const rpcPath = normalizeRpcPath(options.rpc.path);
+    const rpcHandler = createRpcApiHandler(options.rpc);
+    return {
+        handler: async (request, context)=>{
+            if (isRpcRequest(request, rpcPath)) {
+                const policyDenial = options.validateRequest?.(request);
+                if (policyDenial) return policyDenial;
+                const next = ()=>rpcHandler.handler(request, toEffectServiceContext(context));
+                return options.interceptRequest ? options.interceptRequest({
+                    request,
+                    next
+                }) : next();
+            }
+            return handleHttpApiRequest(request, context);
+        },
+        dispose: async ()=>{
+            await Promise.all([
+                httpApiHandler.dispose(),
+                rpcHandler.dispose()
+            ]);
+        }
+    };
+}
+export { createHttpApiHandler };

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

@@ -0,0 +1,20 @@
+import { HttpRouter, HttpServerResponse } from "effect/unstable/http";
+import { OpenApi } from "effect/unstable/httpapi";
+const DEFAULT_OPENAPI_PATH = '/openapi.json';
+function normalizeOpenApiPath(pathname) {
+    if (!pathname.startsWith('/')) return `/${pathname}`;
+    return pathname;
+}
+function getOpenApiOptions(openapi) {
+    if (false === openapi || void 0 === openapi) return;
+    const path = true === openapi ? DEFAULT_OPENAPI_PATH : openapi.path;
+    return {
+        path: normalizeOpenApiPath(path ?? DEFAULT_OPENAPI_PATH)
+    };
+}
+function createOpenApiLayer(api, openapi) {
+    const openApiOptions = getOpenApiOptions(openapi);
+    if (!openApiOptions) return null;
+    return HttpRouter.add('GET', openApiOptions.path, HttpServerResponse.jsonUnsafe(OpenApi.fromApi(api)));
+}
+export { createOpenApiLayer };

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

@@ -0,0 +1,50 @@
+import { isPlainObject } from "../../data-platform/index.mjs";
+function getRequestPathname(request) {
+    try {
+        return new URL(request.url).pathname;
+    } catch  {
+        return new URL(request.url, 'http://localhost').pathname;
+    }
+}
+function normalizeMountPrefix(prefix) {
+    if (!prefix || '/' === prefix) return '';
+    return prefix.endsWith('/') ? prefix.slice(0, -1) : prefix;
+}
+function getMountedPrefixFromContext(request, context) {
+    if (!isPlainObject(context) || 'string' != typeof context.path) return '';
+    const contextPath = normalizeMountPrefix(context.path);
+    const requestPath = normalizeMountPrefix(getRequestPathname(request));
+    if (!contextPath || !requestPath || contextPath === requestPath || !contextPath.endsWith(requestPath)) return '';
+    return normalizeMountPrefix(contextPath.slice(0, contextPath.length - requestPath.length));
+}
+function removeMountedPrefixFromBatchPath(pathWithQuery, prefix) {
+    const normalizedPrefix = normalizeMountPrefix(prefix);
+    if (!normalizedPrefix) return pathWithQuery;
+    const [pathname, ...queryParts] = pathWithQuery.split('?');
+    if (!pathname) return pathWithQuery;
+    let nextPathname = pathname;
+    if (pathname === normalizedPrefix) nextPathname = '/';
+    else if (pathname.startsWith(`${normalizedPrefix}/`)) {
+        const sliced = pathname.slice(normalizedPrefix.length);
+        nextPathname = sliced.startsWith('/') ? sliced : `/${sliced}`;
+    }
+    if (0 === queryParts.length) return nextPathname;
+    return `${nextPathname}?${queryParts.join('?')}`;
+}
+function getRequestOrigin(request) {
+    try {
+        return new URL(request.url).origin;
+    } catch  {
+        return new URL(request.url, 'http://localhost').origin;
+    }
+}
+function getExpectedEnvelopeOrigin(request) {
+    const origin = request.headers.get('origin');
+    if (origin && 'null' !== origin) return origin;
+    return getRequestOrigin(request);
+}
+function isRpcRequest(request, rpcPath) {
+    const pathname = getRequestPathname(request);
+    return pathname === rpcPath || pathname.startsWith(`${rpcPath}/`);
+}
+export { getExpectedEnvelopeOrigin, getMountedPrefixFromContext, getRequestPathname, isRpcRequest, removeMountedPrefixFromBatchPath };