mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-18 05:53:05 +00:00
56 lines
2.7 KiB
Markdown
56 lines
2.7 KiB
Markdown
# OPS46-S1 — hook ESM mapeia next/cache incondicionalmente (impl)
|
|
|
|
Fonte: issue #789 (body = spec). Débito capturado na revisão estrutural do OPS46 (PR #787).
|
|
|
|
## Problema
|
|
|
|
`tests/helpers/e2eEsmResolve.mjs` remapeia `next/cache` → `next/cache.js` **sem tentar a
|
|
resolução bare primeiro**. Quando o `next` publicar um `exports` map (major bump), o remap
|
|
pode mascarar um erro de resolução real (fail-loud vira fail-silent).
|
|
|
|
## Abordagem recomendada
|
|
|
|
No branch `specifier === 'next/cache'`:
|
|
|
|
1. `await nextResolve(specifier, context)` primeiro.
|
|
2. Só no rejeito com `error.code === 'ERR_MODULE_NOT_FOUND'`, remapear para
|
|
`next/cache.js` (comportamento atual do fallback).
|
|
3. Qualquer outro erro propaga — fail-loud preservado.
|
|
|
|
Branch `react-server` (injeção de conditions) intocado: o issue só cita o remap, e a injeção
|
|
não mascarava erro (apenas adiciona condição, espelhando `--conditions=react-server`).
|
|
|
|
## Fases
|
|
|
|
1. Editar `tests/helpers/e2eEsmResolve.mjs` (~5 linhas; hook já é `async`, então `await`
|
|
dentro do try/catch é válido e necessário para capturar a rejeição).
|
|
2. Spec unit `tests/unit/e2eEsmResolve.unit.spec.ts` (padrão do repo: vitest importa `.mjs`
|
|
direto, ex. `agentPoolModels.unit.spec.ts`): três casos com `nextResolve` mockado —
|
|
bare-ok não remapeia; bare `ERR_MODULE_NOT_FOUND` remapeia para `next/cache.js`; erro de
|
|
outro código propaga. O repo já testa helpers `.mjs` dessa forma; a regressão
|
|
fail-loud→fail-silent é exatamente o tipo que merece pin.
|
|
3. `pnpm gate:fast` (lint + typecheck + unit).
|
|
4. Sanity opcional (OPS72, discricionário): `pnpm exec playwright test --list` para provar
|
|
que a coleta de testes segue funcionando com o hook carregado.
|
|
|
|
## Alternativas rejeitadas
|
|
|
|
- **Remover o remap de vez**: quebraria `playwright test` bare (VS Code extension, `--list`,
|
|
ad-hoc) até o next publicar exports map — a razão de existir do hook (OPS46) continuaria
|
|
pendente.
|
|
- **Checar `error.message` por `next/cache`**: spec do issue pede só `ERR_MODULE_NOT_FOUND`;
|
|
o branch já é escopado ao specifier, e o fallback propaga erros próprios. Menos código.
|
|
|
|
## Riscos
|
|
|
|
- **Catch largo (baixo)**: um `ERR_MODULE_NOT_FOUND` de import transitivo dentro da
|
|
resolução de `next/cache` dispararia o remap — mas só dentro do branch `next/cache`, e o
|
|
fallback `next/cache.js` propaga seus próprios erros. Mascaramento residual mínimo,
|
|
dentro do spec.
|
|
- **Esquecer `await` no try (nulo)**: sem `await` o try não captura rejeição — a spec
|
|
unit cobre o caso.
|
|
|
|
## Gatilho de reavaliação
|
|
|
|
Bump major do `next`: quando o exports map existir, a resolução bare passa e o fallback fica
|
|
morto — o remap pode então ser removido.
|