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.
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}`);
}