nestjs-angolan-validator
Version:
A NestJS validator decorator for Angolan documents (BI, IBAN, NIF, Phone)
97 lines (62 loc) • 2.16 kB
Markdown
# nestjs-angolan-validator
[](https://www.npmjs.com/package/nestjs-angolan-validator)
[](https://opensource.org/licenses/MIT)
Validações para documentos angolanos em NestJS, incluindo:
- Bilhete de Identidade (BIC)
- Números de telefone
- IBAN bancário
- NIF (Número de Identificação Fiscal)
## Instalação
```bash
npm install nestjs-angolan-validator
```
## Validações Disponíveis em Projetos Nest
1. **Validação de Bilhete de Identidade (BI)**
Formato aceito:
- 005928773LA049 (9 dígitos + 2 letras + 3 dígitos)
```typescript
import { IsAngolanBI } from 'nestjs-angolan-bi-validator';
export class CreateUserDto {
@IsString()
nome: string;
@IsAngolanBI({ message: 'BI inválido! Exemplo: 005928773LA049' })
bilhete: string;
}
```
2. **Validação de Número de Telefone**
Formatos aceitos:
- 912345678 (nacional)
- +244912345678 (internacional)
- 244912345678
- 00244912345678
```typescript
import { IsAngolanPhone } from 'nestjs-angolan-validator';
export class ContactDTO {
@IsAngolanPhone()
phone: string;
}
```
3. **Validação de IBAN Bancário**
Formato aceito:
- AO06000500000012345678901 (AO + 21 dígitos)
```typescript
import { IsAngolanIBAN } from 'nestjs-angolan-validator';
export class AccountDTO {
@IsAngolanIBAN()
iban: string;
}
```
4. **Uso Avançado**
Você pode usar os validadores diretamente sem decorators:
```typescript
import { Validators } from 'nestjs-angolan-validator';
const isValidPhone = new Validators.Phone().validate('912345678');
const isValidBIC = new Validators.BIC().validate('005928773LA049');
```
5. **Contribuição**
Contribuições são bem-vindas! Siga estes passos:
- Faça um fork do projeto
- Crie sua branch (git checkout -b feature/validator-improvement)
- Commit suas mudanças (git commit -m 'Add new validator')
- Push para a branch (git push origin feature/validator-improvement)
- Abra um Pull Request