PhilflowIO/tsdav

Improve error messages and troubleshooting

Open

#17 aberto em 28 de out. de 2025

Ver no GitHub
 (1 comment) (0 reactions) (0 assignees)TypeScript (0 forks)auto 404
documentationenhancementgood first issuephase-2

Métricas do repositório

Stars
 (0 stars)
Métricas de merge de PR
 (Métricas PR pendentes)

Description

Make error messages more helpful and actionable.

Requirements:

  • Detailed error codes with links to documentation
  • Suggest fixes for common errors
  • Export detailed error log (JSON format)
  • Integration with --debug flag

Example:

Error: Authentication failed (HTTP 401)
Possible causes:
  1. Invalid credentials
  2. OAuth token expired
  3. Insufficient permissions

Troubleshooting steps:
  - Verify credentials in .env file
  - Regenerate OAuth refresh token
  - Check API permissions in Google Cloud Console

For more help: https://docs.example.com/errors/AUTH_401

Estimated Effort: Small (2 days)

Related to: DAV Migration CLI - Phase 2

Guia do colaborador

Direção de pesquisa
Estude o tratamento de erros existente no código, identifique os principais pontos de erro (por exemplo, autenticação, requisições de API) e implemente o padrão sugerido na issue: códigos de erro detalhados com links para documentação, sugestões de correção, exportação de log de erros em JSON e integração com a flag ` debug`.
Pilha de tecnologia
typescript
Domain
developer experiencecli
Tipo Issue
Funcionalidade
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-2 dias
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
GitTypeScript
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
75