import type { HttpRequest, HttpResponse, HttpResponseLike } from "../http/index.js";
import { type Layer } from "../layer/index.js";
import type { AnyService, HttpService, InferRequest, InferResponse } from "../service/index.js";
import { type FromFnClosure } from "./from-fn.js";
import { type MakeRequestId } from "./request-id.js";
import { type MakeHeaderValue } from "./set-header.js";
/**
 * Declaratively construct a {@link Service} values.
 *
 * `ServiceBuilder provides a builder-like interface for composing layers to be
 * applied to a `Service`.
 */
export declare class ServiceBuilder<Out extends AnyService, In extends AnyService> implements Layer<Out, In> {
    private readonly inner;
    private constructor();
    /**
     * Creates a new {@link ServiceBuilder}.
     */
    static create(): ServiceBuilder<HttpService<HttpResponseLike>, HttpService>;
    /**
     * Applies a {@link Layer} to the next service.
     */
    withLayer<TOut extends In, TIn extends AnyService>(layer: Layer<TOut, TIn>): ServiceBuilder<Out, TIn>;
    /**
     * Applies an optional {@link Layer} to the next service.
     *
     * An optional layer is only possible when the consumed service equals the
     * produced service.
     */
    withOptionLayer<TOut extends In, TIn extends In>(layer: Layer<TOut, TIn> | null | undefined): ServiceBuilder<Out, TIn>;
    /**
     * Applies a middleware function to the next service.
     *
     * @see {@link FromFnLayer}
     */
    fromFn<Next extends AnyService, Request extends InferRequest<In>, Response extends InferResponse<In>>(f: FromFnClosure<Next, Request, Response>): ServiceBuilder<Out, Next>;
    /**
     * Catches errors of the following services and produces HTTP responses.
     *
     * @see {@link CatchErrorLayer}
     */
    catchError(this: ServiceBuilder<Out, HttpService>): ServiceBuilder<Out, HttpService>;
    /**
     * Map {@link HttpResponseLike} of the next service to an{@link HttpResponse}.
     *
     * @see {@link MapToHttpResponseLayer}
     */
    mapToHttpResponse(this: ServiceBuilder<Out, HttpService>): ServiceBuilder<Out, HttpService<HttpResponseLike>>;
    /**
     * Set client IP from the request.
     *
     * @see {@link SetClientIpLayer}
     */
    setClientIp(this: ServiceBuilder<Out, AnyService>, trustProxy?: boolean): ServiceBuilder<Out, HttpService>;
    /**
     * Compress response bodies.
     *
     * @see {@link ResponseCompressionLayer}
     */
    compression(this: ServiceBuilder<Out, AnyService>): ServiceBuilder<Out, HttpService>;
    /**
     * Decompress request bodies.
     *
     * @see {@link RequestDecompressionLayer}
     */
    decompression(this: ServiceBuilder<Out, AnyService>): ServiceBuilder<Out, HttpService>;
    /**
     * Add request ID header and extension.
     *
     * @see {@link SetRequestIdLayer}
     */
    setRequestId(this: ServiceBuilder<Out, HttpService>, headerName?: string, makeRequestId?: MakeRequestId): ServiceBuilder<Out, HttpService>;
    /**
     * Propagate request IDs from request to response.
     *
     * @see {@link PropagateRequestIdLayer}
     */
    propagateRequestId(this: ServiceBuilder<Out, HttpService>, headerName?: string): ServiceBuilder<Out, HttpService>;
    /**
     * Trace HTTP requests and responses.
     *
     * @see {@link TraceLayer}
     */
    traceHttp(this: ServiceBuilder<Out, HttpService>): ServiceBuilder<Out, HttpService>;
    /**
     * Intercept requests with oversized payloads and convert them into
     * `4013 Payload Too Large` responses.
     *
     * @see {@link RequestBodyLimitLayer}
     */
    requestBodyLimit(this: ServiceBuilder<Out, HttpService>, limit: number): ServiceBuilder<Out, HttpService>;
    /**
     * Mark headers as sensitive on both requests and responses.
     *
     * @see {@link SetSensitiveHeadersLayer}
     */
    sensitiveHeaders(this: ServiceBuilder<Out, HttpService>, headers: string[]): ServiceBuilder<Out, HttpService>;
    /**
     * Mark headers as sensitive on requests.
     *
     * @see {@link SetSensitiveRequestHeadersLayer}
     */
    sensitiveRequestHeaders(this: ServiceBuilder<Out, HttpService>, headers: string[]): ServiceBuilder<Out, HttpService>;
    /**
     * Mark headers as sensitive on responses.
     *
     * @see {@link SetSensitiveRequestHeadersLayer}
     */
    sensitiveResponseHeaders(this: ServiceBuilder<Out, HttpService>, headers: string[]): ServiceBuilder<Out, HttpService>;
    /**
     * Insert a header into the request.
     *
     * If a previous value exists for the same header, it is removed and
     * replaced with a new header value.
     *
     * @see {@link SetRequestHeaderLayer}
     */
    overrideRequestHeader(this: ServiceBuilder<Out, HttpService>, headerName: string, make: MakeHeaderValue<HttpRequest>): ServiceBuilder<Out, HttpService>;
    /**
     * Append a header into the request.
     *
     * If previous values exist, the header will have multiple values.
     *
     * @see {@link SetRequestHeaderLayer}
     */
    appendRequestHeader(this: ServiceBuilder<Out, HttpService>, headerName: string, make: MakeHeaderValue<HttpRequest>): ServiceBuilder<Out, HttpService>;
    /**
     * Insert a header into the request if the header is not already present.
     *
     * @see {@link SetRequestHeaderLayer}
     */
    insertRequestHeaderIfNotPresent(this: ServiceBuilder<Out, HttpService>, headerName: string, make: MakeHeaderValue<HttpRequest>): ServiceBuilder<Out, HttpService>;
    /**
     * Insert a header into the response.
     *
     * If a previous value exists for the same header, it is removed and
     * replaced with a new header value.
     *
     * @see {@link SetResponseHeaderLayer}
     */
    overrideResponseHeader(this: ServiceBuilder<Out, HttpService>, headerName: string, make: MakeHeaderValue<HttpResponse>): ServiceBuilder<Out, HttpService>;
    /**
     * Append a header into the response.
     *
     * If previous values exist, the header will have multiple values.
     *
     * @see {@link SetResponseHeaderLayer}
     */
    appendResponseHeader(this: ServiceBuilder<Out, HttpService>, headerName: string, make: MakeHeaderValue<HttpResponse>): ServiceBuilder<Out, HttpService>;
    /**
     * Insert a header into the response if the header is not already present.
     *
     * @see {@link SetResponseHeaderLayer}
     */
    insertResponseHeaderIfNotPresent(this: ServiceBuilder<Out, HttpService>, headerName: string, make: MakeHeaderValue<HttpResponse>): ServiceBuilder<Out, HttpService>;
    layer(inner: In): Out;
}