Tipos HTTP brutos
HttpRequest, HttpResponse, CorsOptions e CookieOptions são interfaces explícitas exportadas por tyrus:http. Importe-as somente ao trabalhar na fronteira HTTP bruta. Controllers normalmente devem usar a requisição inferida pelo schema da rota e enviar por HttpReply.
HttpRequest expõe id imutável, o método, o caminho e os canais string brutos body, params, query, headers e cookies. O runtime atribui id uma vez por requisição e envia o valor Base64URL compacto sem padding no header de resposta x-request-id. { logger: true } escreve um evento de acesso estruturado em stderr com o ID, método, caminho, status e duração; ele vem desligado por padrão. Texto da query, headers, cookies, credenciais e corpos nunca entram nesse evento. Use HttpAccessLog com app.onResponse quando o código da aplicação precisar desses metadados. Veja HttpResponse, CorsOptions e CookieOptions para os 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}`);
}