feat: adiciona função findAddress para busca por endereço

[mateus-araujo]

Descrição

Esta PR adiciona a função findAddress que permite buscar endereços brasileiros utilizando estado, cidade e rua, não apenas por CEP.

A implementação foi baseada na biblioteca cep-address-finder do próprio autor, trazendo a funcionalidade para o cep-promise com suporte a múltiplos provedores.

Principais mudanças

• ✨ Nova função findAddress: Permite buscar endereços informando estado, cidade e rua
• 🔍 Múltiplos provedores: Funciona com concorrência entre provedores (padrão já utilizado na função cep)
• 🎯 Seleção inteligente: Seleciona o endereço correto baseado no número e/ou bairro informado
• ✅ Testes: 12 novos testes unitários seguindo os padrões do projeto
• 📝 Documentação: README.md e definições TypeScript atualizadas

Exemplo de uso

import { findAddress } from 'cep-promise'
// Busca básica
findAddress({
  state: 'SP',
  city: 'São Paulo',
  street: 'Rua Caiubí'
}).then(console.log)

// Com número e bairro para seleção mais precisa
findAddress({
  state: 'SP',
  city: 'São Paulo',
  street: 'Rua Caiubí',
  number: '123',
  neighborhood: 'Perdizes'
}).then(console.log)

// Especificando provedores
findAddress({
  state: 'SP',
  city: 'São Paulo',
  street: 'Rua Caiubí',
  providers: ['viacep']
}).then(console.log)

Commits

• feat: add utility functions for address search
• feat: add ViaCEP address search provider
• feat: add findAddress function
• test: add tests for findAddress function
• docs: update documentation and TypeScript definitions
• build: update dist files and package-lock
• refactor: improve readability of select-address-from-list

Checklist

• Todos os testes passando (63 testes)
• Lint passando (StandardJS)
• Build funcionando
• Cobertura de testes > 95%

[wellwelwel]

Opá! Eu não faço parte do repositório, mas gostei da ideia/feature 😅

---

Vi que as mudanças não são tão grandes quanto parecem:

@mateus-araujo, tem algum motivo do porque modificar o package-lock.json junto nesse PR? Se for por questão de dependências desatualizadas, eu recomendaria fazer isso em um PR separado, mas vale esperar pelos mantenedores 🙋🏻‍♂️