📦 @einatec/locations-lib

Librería interna para gestionar datos geográficos de España y Andorra (provincias, municipios, códigos postales) y datos internacionales de países (códigos ISO y prefijos telefónicos).

Incluye:

• 🗺️ Locations: Provincias, municipios, códigos postales para ES y AD.
• 🌍 Countries: Listado de países con código ISO y prefijo telefónico.

Diseñada para ser ligera, rápida y fácil de integrar en cualquier proyecto TypeScript/Node.js.

🚀 Instalación

Desde el GitLab Package Registry

Añade esto a tu .npmrc ubicado en C:/Users/tu-usuario:

@einatec:registry=https://einagit.einatec.com/api/v4/groups/6/-/packages/npm/
//einagit.einatec.com/api/v4/groups/6/-/packages/npm/:_authToken=${authToken}

El authToken lo puedes generar desde el perfil de usuario de GitLab.

Opcional

Es posible que tengas que deshabilitar el ssl-strict:

npm config set strict-ssl false

Instala la librería

npm install @einatec/locations-lib

📚 Uso básico

import { locations, countries } from "@einatec/locations-lib";

🗺️ Módulo Locations

Cargar provincias

// Cargar provincias de España (por defecto)
const provinces = await locations.loadProvinces();

// Cargar provincias de otro país (ej: Andorra)
const adProvinces = await locations.loadProvinces("AD");

Buscar provincias por nombre

const madridProvinces = await locations.getProvinceByName("Madrid");

Buscar municipios por nombre

const municipalities = await locations.getMunicipalitiesByName("Barcelona");

🌍 Módulo Countries

Cargar todos los países

const allCountries = await countries.loadCountries();

País por defecto (España)

const spain = await countries.getDefaultCountry();

Buscar país por código ISO

const usa = await countries.getCountryByIsoCode("US");

Buscar país por nombre

const mexico = await countries.getCountryByName("México");

🧱 Estructura

src/
  locations/
    data/
      AD.json
      ES.json
    utils/
  countries/
    data/
      countries.json
    utils/
  utils/
tests/

🧪 Tests

npm test

🛠 Scripts

{
  "build": "tsc",
  "test": "jest",
  "test:watch": "jest --watch"
}

📦 Publicación

npm version patch
git push --tags