NextUtils 1.0.1

NextMed Utils

Descrição

NextMed Utils é um pacote de utilidades desenvolvido para facilitar diversas operações comuns no desenvolvimento de software. Ele inclui conversores, extensões de string, validações e suporte para manipulação de tokens JWT.

Funcionalidades

1. Conversores JSON

CpfNormalizerJsonConverter

• Normaliza CPFs ao desserializar JSON, removendo pontos e hífens automaticamente.

2. Manipulação de Resultados

OneOf<Success, Error>

• Implementa uma estrutura que pode conter um resultado de sucesso ou erro, permitindo manipulação segura e estruturada.

3. Extensões de String

StringExtensions

• Normaliza strings, removendo acentos e cedilha.
• Validação de documentos e dados:
  • CPF
  • CNPJ
  • CNS (Cartão Nacional de Saúde)
  • CEP
  • Email
  • Telefones brasileiros
• Extração de números de uma string.
• Conversão de string para long.
• Funções para limpar CPFs, CNPJs, CEPs e Tokens.

4. Paginação

Paginate<T>

• Permite paginar consultas LINQ de forma simples, definindo página e tamanho da página.

5. Manipulação de Contexto HTTP

ContextExtensions

• Extração segura do token JWT do contexto HTTP.
• Recuperação de identificadores do sistema a partir do JWT.

Instalação

Para utilizar o pacote, basta adicioná-lo ao seu projeto .NET:

dotnet add package NextUtils --version 1.0.1

Uso

Exemplo de utilização do conversor JSON para normalização de CPF:

var options = new JsonSerializerOptions
{
    Converters = { new CpfNormalizerJsonConverter() }
};

string json = "\"123.456.789-09\"";
string cpfNormalizado = JsonSerializer.Deserialize<string>(json, options);
Console.WriteLine(cpfNormalizado); // Saída: 12345678909

Exemplo de uso de OneOf<Success, Error>:

OneOf<int, string> resultado = SomeFunction();
if (resultado.IsSuccess)
{
    Console.WriteLine($"Sucesso: {resultado.GetSuccess()}");
}
else
{
    Console.WriteLine($"Erro: {resultado.GetError()}");
}

Exemplo de validação de CPF:

bool valido = "123.456.789-09".IsValidCpf();
Console.WriteLine(valido ? "CPF válido" : "CPF inválido");

Licença

Este projeto é propriedade da NextMed e é distribuído sob uma licença proprietária. O uso não autorizado é proibido.