mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-15 18:53:06 +00:00
3.3 KiB
3.3 KiB
Hardening do serving privado de reels (ramo S3)
Status: rascunho Atualizado em: 2026-09-18 Issue: #1162 Priority: P2 Impeccable: A — N/A sem UI Design UI: N/A — sem UI Appetite: ~½ dia eng; cobertura do ramo de produção sem tocar o contrato Responsável: —
Intenção
O C193 (#1152) entregou o serving privado dos artefatos de reel com dois ramos no mesmo utilitário: disco local (dev/test) e S3/Garage (produção). A suíte só exercita o ramo de disco — o caminho que roda em produção (HeadObjectCommand → GetObjectCommand com Range, 206/416, 404 de objeto ausente, content-type/disposition) depende de inspeção, e uma regressão passaria o CI verde. Este item fecha essa lacuna com um teste que injeta o cliente S3 (sem depender de infraestrutura real) e pina o contrato de resposta do ramo de produção.
Contexto
- Utilitário:
src/utilities/reels/reelMediaResponse.ts(buildReelMediaResponse,openS3Object,openLocalObject). - Regras puras (já cobertas por unit):
src/lib/reelMedia.ts(reelMediaContentType,reelMediaContentDisposition,reelMediaHeaders). - Cobertura atual:
tests/int/reel.int.spec.tsexercita a rota e o disco local;tests/unit/reel.unit.spec.tscobre o puro. - Achados que motivaram o item (triage do C193):
isMissingObjectjá checava um campo inexistente (httpStatusCode) antes do fix da sessão; o ramo S3 ficou sem prova.
Objetivos
- Um teste (unit ou int, sem S3 real) cobre o ramo S3 de
buildReelMediaResponse:- objeto existente → 200 com
Content-Length/Content-Type/Cache-Control: private, no-store; Rangeválido → 206 comContent-Rangee slice correto;Rangeinsatisfazível → 416 comContent-Range: bytes */<size>;NoSuchKey/404 → 404 silencioso (sem vazar erro do SDK);ContentLengthausente → erro interno (nunca 200 enganoso).
- objeto existente → 200 com
- O teste não sobe Garage/S3: injeta um cliente falso no ponto de resolução de storage (extrair uma costura testável se necessário, sem alterar o contrato público).
- Guardrails: nenhuma mudança de comportamento observável na rota; sem migration; sem Consent;
Media.readintocado.
Decisões em aberto (implementação)
- Costura de injeção: expor um override interno (
__setReelMediaStorageForTests?) é feio; preferir extrairopenReelMediaObject({ storage, filename, rangeHeader })como função de módulo testável com um storage fake, mantendoreelMediaStorage()privado. Decidir no impl plan. - Camada: unit com fake do
S3Client(rápido, sem DB) vs int comvi.mock('@aws-sdk/client-s3'). Preferir unit — o ramo não toca Payload/DB.
Fases verificáveis
- Costura + unit do ramo S3 — extrair o ponto de injeção e cobrir a matriz acima.
- Gates —
pnpm gate:fast; push viapnpm push.
Rabbit holes / Não escopo
- Subir MinIO/Garage em CI para testar integração real (custo de infra desproporcional; o contrato do SDK é estável).
- Testar o ramo de disco de novo (já pinado no
reel.int.spec.ts). - Mudar o desenho do streaming (roteamento por presign, proxy self-fetch) — decisão travada no impl do C193.
- C194 (#1153) e C195 (#1154) — consumidores do contrato, não deste hardening.
Aceite de engenharia
- Ramo S3 coberto com fake, sem infra externa e sem afrouxar asserções.
- Nenhuma mudança de comportamento no serving;
pnpm gate:fastverde.