Skip to content

v1.0.0

Choose a tag to compare

@KauanCalheiro KauanCalheiro released this 22 Jul 15:21
· 7 commits to main since this release

Changelog 📜

Todas as mudanças notáveis deste projeto serão documentadas neste arquivo. ✍️

Planejado 📝

  • Suporte a novos provedores de CEP 🆕
  • Suite de testes automatizados 🧪

v1.0.0 - 2025-06-22 🎉

Adicionado ➕

  • Implementação inicial do sistema de fallback para APIs de CEP 🛡️
  • Suporte aos provedores ViaCEP e BrasilAPI 🌐
  • Sistema de prioridades configurável para provedores ⚙️
  • Internacionalização com suporte para PT-BR e EN 🌍
  • Service Provider com auto-discovery do Laravel 🚀
  • Configuração via arquivo config/cep.php 🗃️
  • Configuração via variáveis de ambiente ⚡
  • Validação automática de dados de resposta ✅
  • Padronização de resposta entre diferentes provedores 📦
  • Limpeza automática de formatação de CEP 🧹
  • Tratamento de exceções específicas 🛠️
  • Documentação completa no README 📖

Estrutura 🏗️

  • CepResolver: Classe principal para resolução de CEP 🕵️‍♂️
  • CepProviderContract: Interface para implementação de provedores 🔌
  • BaseCepProvider: Classe base para provedores 🏛️
  • ViaCepProvider: Implementação do provedor ViaCEP 🏷️
  • BrasilApiProvider: Implementação do provedor BrasilAPI 🇧🇷
  • FallbackCepApiServiceProvider: Service Provider do Laravel 🧩

Configurações ⚙️

  • Placeholder configurável para URLs dos provedores 📝
  • Habilitação/desabilitação individual de provedores 🔄
  • Sistema de prioridades (menor número = maior prioridade) 🥇
  • URLs customizáveis para cada provedor 🌐
  • Suporte a tokens de autenticação (preparado para futuros provedores) 🔑