Skip to content

Tipos HTTP sin procesar ​

HttpRequest, HttpResponse, CorsOptions y CookieOptions son interfaces explícitas exportadas por tyrus:http. Impórtelas solo al trabajar en el límite HTTP sin procesar. Los controllers normalmente deben usar la solicitud inferida por el schema de la ruta y enviar mediante HttpReply.

HttpRequest expone un id inmutable, el método de solicitud, la ruta y los canales string sin procesar body, params, query, headers y cookies. El runtime asigna id una vez por solicitud y envía el valor Base64URL compacto sin padding en la cabecera de respuesta x-request-id. { logger: true } escribe un evento de acceso estructurado en stderr con el ID, método, ruta, estado y duración; está desactivado por defecto. El texto de query, headers, cookies, credenciales y cuerpos nunca aparecen en ese evento. Use HttpAccessLog con app.onResponse cuando el código de la aplicación necesite esos metadatos. Consulte HttpResponse, CorsOptions y CookieOptions para los contratos dedicados.

tyrus
import { CorsOptions, createRouter, HttpError, HttpReply, HttpRequest, HttpResponse, HttpRouter, HttpStatus } from "tyrus:http";

interface HealthResponse {
    ok: boolean;
}

function requireAuthorization(request: HttpRequest): HttpResponse | true {
    if (request.headers.includes("authorization")) {
        return true;
    }
    return { statusCode: HttpStatus.Unauthorized, body: "Authorization required", cookies: "" };
}

const cors: CorsOptions = {
    origin: ["https://example.com"],
    methods: ["GET"],
    allowedHeaders: ["Authorization"],
    exposedHeaders: [],
    credentials: false,
    maxAge: 3600,
};

const app: HttpRouter = createRouter();
app.cors(cors);
app.get("/health", {
    response: { 200: HealthResponse },
    preHandler: [requireAuthorization],
    handler: (request, reply: HttpReply<HealthResponse>) => {
        reply.status(HttpStatus.Ok).send({ ok: true });
    },
});

try {
    app.listen(3333);
} catch (error: HttpError) {
    console.error(`${error.code}: ${error.message}`);
}