# torogoz

> Es una libreria de utilidades para salvadoreños

Latest version **1.0.8** (published 2022-06-21) · ISC license · 0 weekly downloads

## Install

```sh
npm install torogoz
pnpm add torogoz
yarn add torogoz
bun add torogoz
```

## Health

**Score 20/100 (F)** — status: abandoned.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.8 |
| Published | 2022-06-21 |
| First published | 2022-06-18 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 55.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 6 |
| Author | Gerardo Flores |
| Maintainers | gerardofloresdev |
| Keywords | javascript, elsalvador, DUI, NIT, validation, validar, departamentos, municipios, telefono, phone |

## Links

- npm: https://www.npmjs.com/package/torogoz
- Repository: https://github.com/gerardofloresdev/Torogoz
- Homepage: https://github.com/gerardofloresdev/Torogoz#readme
- Issues: https://github.com/gerardofloresdev/Torogoz/issues
- npm.io page: https://npm.io/package/torogoz

## Alternatives

- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads

## Recent versions

- 1.0.8 (latest) — 2022-06-21
- 1.0.7 — 2022-06-20
- 1.0.6 — 2022-06-19
- 1.0.5 — 2022-06-19
- 1.0.4 — 2022-06-19
- 1.0.3 — 2022-06-19
- 1.0.2 — 2022-06-19
- 1.0.1 — 2022-06-19
- 1.0.0 — 2022-06-18

## README

<div align="center">
    <img src="./.github/torogoz.png" width="200px">
  <h1>Torogoz</h1>
</div>
<p align="center">
  Torogoz es una librería con herramientas reutilizables y comunes para programadores salvadoreños
</p>
<p align="center">
   <a href=""><img src="https://img.shields.io/github/issues/gerardofloresdev/Torogoz" alt="Issues"></a>
   <a href=""><img src="https://img.shields.io/github/forks/gerardofloresdev/Torogoz" alt="Forks"></a>
   <a href=""><img src="https://img.shields.io/github/stars/gerardofloresdev/Torogoz" alt="Stars"></a>
    <a href=""><img src="https://img.shields.io/npm/dm/Torogoz?style=flat-square" alt="Downloads"></a>
   <a href=""><img src="https://img.shields.io/github/license/gerardofloresdev/Torogoz" alt="License"></a>
   <a href=""><img src="https://img.shields.io/twitter/url?url=https%3A%2F%2Fgithub.com%2Fgerardofloresdev%2FTorogoz.git" alt="Twitter"></a>
</p>

## ¿Cómo se instala?

### npm (recomendado)

```bash
$ npm install torogoz --save
```

### yarn

```bash
$ yarn add torogoz
```

## ¿Cómo se utiliza?

### Validación de DUI

Tu puedes validar un Documento Único de Identidad (DUI)

```js
import { Torogoz, TypeDocuments } from 'torogoz';

const isValid = Torogoz.validateDocument({
  typeDocument: TypeDocuments.DUI,
  document: '00160177-3' // El DUI fue tomado de Google para efectos de prueba
});

console.log(isValid);
```

### Validación de NIT

Tu puedes validar un Número de identificación tributaria, aunque ten en cuenta que este documento dejará de utilizarse debido a la nueva regulación el 24 de diciembre de 2021

```js
import { Torogoz, TypeDocuments } from 'torogoz';

const isValid = Torogoz.validateDocument({
  typeDocument: TypeDocuments.NIT,
  document: '0614-290209-000-0' // El NIT fue tomado de Google para efectos de prueba
});

console.log(isValid);
```

### Obtener departamentos

Puedes obtener todos los departamentos de El Salvador como un areglo de objetos de Javascript para que pueda ser utilizado en tus sistemas, como por ejemplo: un select o combobox, a continuación te mostramos un ejemplo de como se veria:

| id | name (Nombre) | departmentalCapital (Cabecera departamental) | ISO (Código ISO) | expansion (Extensión territorial) |
|----|---------------|----------------------------------------------|------------------|-----------------------------------|
| 01 | Ahuachapán    | departmentalCapital                          | SV-AH            | 1239.6                            |

<br>

```js
import { Torogoz, TypeDocuments } from 'torogoz';

const deparments = Torogoz.getDepartments();

console.log(deparments);
```

### Obtener municipios por departamento

Puedes obtener todos los municipios de un departamento utilizando el ID que obtuviste al listar los departamentos, con esto puedes crear facilmente selects o combobox dependientes, a cotinuación de mostramos un ejemplo de como se veria:

| id   | name (Nombre) | cantons (Cantones) | postalCode (Código postal) |
|------|---------------|--------------------|----------------------------|
| 0101 | Ahuachapán    | 29                 | 02101                      |

<br>

```js
import { Torogoz, TypeDocuments } from 'torogoz';

const municipalities = Torogoz.getMunicipalities('01');

console.log(municipalities);
```

---
_Source: https://npm.io/package/torogoz · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._