{"id":24614287,"url":"https://github.com/ogaston/utils-do","last_synced_at":"2025-09-15T12:32:51.187Z","repository":{"id":34909102,"uuid":"188271259","full_name":"ogaston/utils-do","owner":"ogaston","description":"utils-do is a javascript package that provides functionalities that'll easily help you to interact with Dominican Republic's data. ","archived":false,"fork":false,"pushed_at":"2023-04-26T23:46:59.000Z","size":714,"stargazers_count":19,"open_issues_count":6,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-07T00:05:35.275Z","etag":null,"topics":["dominican-republic","geolocation","identification","telephone-number"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ogaston.png","metadata":{"files":{"readme":"README-ES.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-05-23T16:35:38.000Z","updated_at":"2024-04-22T03:12:06.000Z","dependencies_parsed_at":"2023-01-15T10:12:34.736Z","dependency_job_id":null,"html_url":"https://github.com/ogaston/utils-do","commit_stats":{"total_commits":48,"total_committers":9,"mean_commits":5.333333333333333,"dds":0.6666666666666667,"last_synced_commit":"0306288f2fac9aea88f1b69cac9569b8f1b9390f"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ogaston%2Futils-do","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ogaston%2Futils-do/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ogaston%2Futils-do/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ogaston%2Futils-do/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ogaston","download_url":"https://codeload.github.com/ogaston/utils-do/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252788521,"owners_count":21804285,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dominican-republic","geolocation","identification","telephone-number"],"created_at":"2025-01-24T21:15:57.842Z","updated_at":"2025-05-07T00:06:06.681Z","avatar_url":"https://github.com/ogaston.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003e **Utils-DO esta actualmente en beta.** Espera m谩s errores que una versi贸n final.\n\n[Read in English](https://github.com/ogaston/utils-do/blob/master/README.md)\n\n## Documentaci贸n\n\n馃殌 Inicio [Documentaciones en curso]\n\nUtils-DO, esta peque帽a librer铆a es un manejador y fuentes de datos relacionados con Rep煤blica Dominicana.\n\n**Ahora adaptado para TypeScript**\n\n## Instalaci贸n\n\n```bash\n\n$ npm i utils-do --save\n\n```\n\n## Geo\n\nEsta clase se utiliza como fuente de informaci贸n geogr谩fica del pa铆s.\n\n```javascript\nconst { Geo } = require(\"utils-do\");\n\nconst result = Geo.getProvincesByZone(\"cibao sur\");\n\nconsole.log(result); // [ 'La Vega', 'Monse帽or Nouel', 'S谩nchez Ram铆rez' ]\n```\n\n\u003e Este m茅todo recupera una matriz de las provincias ubicadas en esa zona (subregi贸n)\n\n### Referencia de la API\n\n| M茅todo | Descripci贸n | Devuelve |\n| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |\n| `getProvinces()` | Devuelve una matriz de strings con el nombre de cada provincia | string[] |\n| `getMunicipalitiesOf(provincesName)` | Buscar una devoluci贸n de un objeto con los municipios de una provincia como propiedades | objeto o undefined |\n| `getMunicipalDistrictOf(provincia, municipio)` | Devolver el distrito municipal de un municipio de una provincia | string[] o undefined |\n| `getProvinceByMunicipality(municipio)` | Obtenga el nombre de las provincias a las que pertenece el municipio. Devuelve una matriz porque el nombre del municipio podr铆a estar en dos o m谩s provincias | string[] |\n| `getProvinceByMunicipalDistrict(municipalDisctric)` | Obtenga un objeto con la provincia y el municipio buscado por el distrito municipal | {provincia: string, municipio: string}[] |\n| `getRegions()` | Obtenga las macrorregiones del pa铆s | string[] |\n| `getRegionsAndZones()` | Obtenga un objeto con cada regi贸n con sus respectivas zonas | {[regi贸n]: string[]}[] |\n| `getProvincesByRegion(regi贸n)` | Obtenga las provincias que pertenecen a una regi贸n | string[] |\n| `getProvincesByZone()` | Obtenga las provincias que pertenecen a una zona | string[] |\n\n## Validator\n\nEsta clase se utiliza para manejar la validaci贸n de datos gen茅ricos como el ID (identificaci贸n del ciudadano o 'Cedula').\n\n```javascript\nconst { Validator } = require(\"utils-do\");\n\nconst result = Validator.isAnIde(\"4022222222\");\n\nconsole.log(result); // true\n\nValidator.formatToIde(4022222222); // \"402-2222222-2\"\n```\n\n\u003e Estos m茅todos se utilizan para manejar la identificaci贸n de los dominicanos.\n\n### Referencia de API\n\n| M茅todo | Descripci贸n | Devuelve |\n| ------------------ | --------------------------------------------------------------------- | ------------------ |\n| `isAnIde(id)` | Validar si el valor insertado es una identificaci贸n dominicana v谩lida | booleano |\n| `formatToIde(id)` | Devuelve el valor formateado como una identificaci贸n dominicana. | string o undefined |\n| `isATel(tel)` | Devolver el distrito municipal de un municipio de una provincia. | booleano |\n| `formatToTel(tel)` | Devuelve el valor formateado como un n煤mero de tel茅fono dominicano. | string o undefined |\n| `isRNC(entrada)` | Valide si es un RNC v谩lido. | booleano |\n| `formatToRNC(rnc)` | Devuelve el valor formateado como un RNC dominicano. | string o undefined |\n\n## Contribuyendo\n\nPara ayuda en crecer el repositorio, construir y probar.\n\nPor favor, haga un nuevo issue / haga su pull-request o [enviame un correo electr贸nico](mailto:omar.gaston.c@gmail.com).\n\n## Agradecimientos\n\nQuisi茅ramos agradecer a cualquiera que use o contribuya con este repositorio.\n\n## Licencia\n\nEste proyecto utiliza la siguiente licencia: [MIT](\u003chttps://choosealicense.com/licenses/mit/\u003e)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fogaston%2Futils-do","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fogaston%2Futils-do","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fogaston%2Futils-do/lists"}