1.0.5 • Published 1 year ago
@jpmnsdeveloper/toolkit v1.0.5
Toolkit
Para baixá-lo digite um dos seguintes comandos:
yarn add @jpmnsdeveloper/toolkit
npm i @jpmnsdeveloper/toolkit
Esse pacote tem o objetivo de juntar e configurar as bibliotecas e classes mais utilizadas nos projetos dessa conta. São sete módulos que compõem esse toolkit, para usar ele você deve importar o toolkit, após isso digite:
toolkit.
E a frente do ponto digite o nome de um dos seguintes módulos:
- jsonWebToken
- environment
- cache
- password
- validation
- error
- generation
Error - É um conjunto de classes customizadas de erros
Não necessita de variáveis de ambiente para ser utilizado
Para ver as informações que os erros retornam acesse | https://github.com/JPedro109/toolkit/tree/master/src/modules/Error/Classes
- EmailInvalidError | Excessão para e-mail inválido
- PasswordInvalidError | Excessão para senha inválida
- MissingParamError | Excessão para erros relacionados a falta de envio de parâmetros
- UnauthorizedError | Excessão para falta de autorização
- NotFoundError | Excessão para objeto não encontrado
Environment - Conjunto de funções relacionadas com o retorno de variáveis de ambiente
Não necessita de variáveis de ambiente para ser utilizado
getValue(key: string): string | undefined - Retorna uma variável de ambiente
getRequiredValue(key: string): string - Retorna uma variável de ambiente, se ela não exister é lançada uma excessão
Cache - Conjunto de funções para gerenciar o cache da aplicação
Não necessita de variáveis de ambiente para ser utilizado
set<Type>(key: string, value: Type, expiryTime?: number): void - Armazena um novo cache
get<Type>(key: string): Type - Retorna um cache
del(key: string): void - Deleta um cache
Validation - Conjunto de funções exercer validar um e-mail ou uma senha
Não necessita de variáveis de ambiente para ser utilizado
email(email: string): boolean - Valida um e-mail
password(password: string): boolean - Valida se a senha tem 8 caracteres, uma letra maiúscula, uma minúscula e um número
Generation - Conjunto de funções gerar um id, token ou tempo de expiração de um token
Não necessita de variáveis de ambiente para ser utilizado
id(): string - Gera um id
token(): string - Gera um token
tokenExpirationTime(timeInMinutes: number): number - Gera uma data de vencimento do tokem em milissegundos
Password - Conjunto de funções para tratamento de senha
Não necessita de variáveis de ambiente para ser utilizado
encryptPassword(password: string): string - Gera um encriptação de senha
comparePasswordEncrypt(password: string, userPassword: string): boolean - Compara uma senha encriptada com uma não encriptada
JsonWebToken - Conjunto de funções para tratamento do json web token
Necessita de variáveis de ambiente para ser utilizado
- JWT_SECRET_KEY | É a chave de geração do json web token, com ele pode ser gerado e validado
createToken(payload: object, expiryTimeInSeconds: number): string - Gera um json web token
tokenVerification(token: string, secretKey: string): JsonWebTokenModel - Valida um json web token
Email - Módulo de envio de e-mail
Necessita de variáveis de ambiente para ser utilizado
- INITIALIZED_EMAIL_MODULE | Deve estar como true para o módulo de e-mail ser ativado
- PROVIDER_HOST_EMAIL_MODULE| É o servidor de envio de e-mail
- PROVIDER_PORT_EMAIL_MODULE | É a porta do servidor de envio de e-mail
- PROVIDER_EMAIL_EMAIL_MODULE | É o e-mail que será usado como remente
- PROVIDER_PASSWORD_EMAIL_MODULE | É a senha do e-mail que será usado como remente
- PROVIDER_EMAILBODIESPATH_EMAIL_MODULE | É o caminho local onde estão o corpos de email, o caminho deve partir da raiz do projeto
sendMailsendMail(to: string, subject: string, template: string, context?: object): Promise<void> - Envia um e-mail