Skip to content

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.

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