Files
mtusi2026lab6/src/http/request.ts
T
celis 51b02a541d Реализовать лабораторную 6: OpenTelemetry, Grafana, SLO и burn-rate alerts
- api и worker отдают traces, metrics и logs по OTLP в Collector
  (memory_limiter, redaction, batch, ограниченная очередь и retry);
  хранилища: Prometheus (OTLP receiver), Loki, Tempo; Grafana с
  provisioning datasources и dashboard «Messenger lab6»
- W3C trace context через outbox и RabbitMQ: producer/consumer spans
  связывают upload, публикации и попытки worker в одном trace
- SLO доступности API (SLI на HAProxy) и времени до ready, multiwindow
  burn-rate alerts, ApiHighErrorRate, JobQueueLagGrowing,
  DbPoolSaturated, TelemetryExportFailing; unit-тесты promtool, runbooks
- кампания трека 2 (k6, 6 отказов по расписанию), разбор и графики;
  проверки сигналов и истории telemetry, evidence и REPORT.md
2026-10-31 01:45:56 +03:00

61 lines
2.9 KiB
TypeScript

// Разбор и проверка входных данных запроса.
import type { IncomingMessage } from 'node:http';
import { badRequest, tooLarge, unsupported } from './errors.ts';
const BODY_LIMIT = 1 << 20; // 1 MiB: с запасом для 4000 символов в худшем JSON-экранировании
export const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
// Тело запроса как JSON: только application/json, строгий UTF-8, ограничение размера.
export async function readJson(req: IncomingMessage): Promise<unknown> {
if (mediaType(req) !== 'application/json') throw unsupported('Ожидается application/json');
const chunks: Buffer[] = [];
let size = 0;
for await (const chunk of req) {
size += chunk.length;
if (size > BODY_LIMIT) throw tooLarge('Слишком большое тело запроса');
chunks.push(chunk);
}
try {
return JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(Buffer.concat(chunks)));
} catch {
throw badRequest('Некорректный JSON');
}
}
// Тип тела без параметров (charset и т.п.), в нижнем регистре.
export function mediaType(req: IncomingMessage): string {
return (req.headers['content-type'] ?? '').split(';')[0].trim().toLowerCase();
}
// Для эндпоинтов без тела: любое непустое тело — 400, а не молча игнорируется.
export async function requireEmptyBody(req: IncomingMessage): Promise<void> {
let size = 0;
for await (const chunk of req) {
size += chunk.length;
if (size > BODY_LIMIT) break;
}
if (size > 0) throw badRequest('Тело запроса не допускается');
}
// JSON-объект только с разрешёнными ключами: лишние поля по контракту дают 400.
export function jsonObject(value: unknown, keys: string[]): Record<string, unknown> {
if (typeof value !== 'object' || value === null || Array.isArray(value) || Object.keys(value).some((k) => !keys.includes(k))) {
throw badRequest('Ожидается JSON-объект без лишних полей');
}
return value as Record<string, unknown>;
}
// Обязательная строка: не только пробелы, длина в Unicode code points (эмодзи = 1 символ).
export function isText(v: unknown, min: number, max: number): v is string {
if (typeof v !== 'string' || v.trim() === '') return false;
const n = [...v].length;
return n >= min && n <= max;
}
// UUID из пути в каноническом нижнем регистре.
export function uuidParam(c: { params: string[] }, name: string): string {
const value = c.params[0];
if (!UUID.test(value)) throw badRequest(`Некорректный ${name}`);
return value.toLowerCase();
}