import type { NodeWebSocketServerProvider } from "../extensions/websocket/index.js";
/** Public API contract for veryfront service server fetch. */
export type VeryfrontServiceServerFetch = (request: Request) => Response | Promise<Response>;
/** Response payload for veryfront service server module. */
export type VeryfrontServiceServerModuleResponse = Response | null | undefined;
/** Public API contract for veryfront service server module. */
export type VeryfrontServiceServerModule = {
    name: string;
    handle: (request: Request) => VeryfrontServiceServerModuleResponse | Promise<VeryfrontServiceServerModuleResponse>;
    setShuttingDown?: () => void;
    stop?: () => void | Promise<void>;
};
/** Public API contract for veryfront service server logger. */
export type VeryfrontServiceServerLogger = {
    debug?: (message: string, metadata?: Record<string, unknown>) => void;
    info?: (message: string, metadata?: Record<string, unknown>) => void;
    warn?: (message: string, metadata?: Record<string, unknown>) => void;
    error?: (message: string, metadata?: Record<string, unknown>) => void;
};
/** Options accepted by create veryfront server. */
export type CreateVeryfrontServerOptions = {
    modules: readonly VeryfrontServiceServerModule[];
    notFound?: (request: Request) => Response | Promise<Response>;
    onError?: (error: unknown, request: Request) => Response | Promise<Response>;
    logger?: VeryfrontServiceServerLogger;
};
/** Public API contract for veryfront service server runtime. */
export type VeryfrontServiceServerRuntime = {
    fetch: VeryfrontServiceServerFetch;
    setShuttingDown: () => void;
    stop: () => Promise<void>;
};
/** Options accepted by start node veryfront server. */
export type StartNodeVeryfrontServerOptions = {
    runtime: VeryfrontServiceServerRuntime;
    port: number;
    bindAddress?: string;
    logger?: VeryfrontServiceServerLogger;
    signals?: readonly NodeJS.Signals[];
    hardShutdownTimeoutMs?: number;
    /** Extension-provided Node WebSocket implementation; upgrades fail closed when omitted. */
    nodeWebSocketServerProvider?: Readonly<NodeWebSocketServerProvider>;
};
/** Options accepted by start veryfront server. */
export type StartVeryfrontServerOptions = {
    runtime: VeryfrontServiceServerRuntime;
    port: number;
    bindAddress?: string;
    logger?: VeryfrontServiceServerLogger;
    signals?: readonly NodeJS.Signals[];
    hardShutdownTimeoutMs?: number;
    /** Used only when the selected runtime is Node.js. */
    nodeWebSocketServerProvider?: Readonly<NodeWebSocketServerProvider>;
};
/** Public API contract for veryfront service server runtime kind. */
export type VeryfrontServiceServerRuntimeKind = "node" | "deno" | "bun";
/** Public API contract for veryfront service server. */
export type VeryfrontServiceServer = {
    ready: Promise<void>;
    stop: () => Promise<void>;
    port: number;
    url: string;
    runtime: VeryfrontServiceServerRuntimeKind;
};
/** Public API contract for node veryfront service server. */
export type NodeVeryfrontServiceServer = {
    server: import("node:http").Server;
    ready: Promise<void>;
    stop: () => Promise<void>;
    port: number;
    url: string;
    runtime: "node";
};
/** Create veryfront server. */
export declare function createVeryfrontServer(options: CreateVeryfrontServerOptions): VeryfrontServiceServerRuntime;
/** Starts veryfront server. */
export declare function startVeryfrontServer(options: StartVeryfrontServerOptions): Promise<VeryfrontServiceServer | NodeVeryfrontServiceServer>;
/** Starts node veryfront server. */
export declare function startNodeVeryfrontServer(options: StartNodeVeryfrontServerOptions): Promise<NodeVeryfrontServiceServer>;
//# sourceMappingURL=service-server.d.ts.map