---
name: nordvpn_connect
kind: function
lang: bash
domain: infra
version: "1.0.0"
purity: impure
signature: "nordvpn_connect(country?: string, city?: string) -> json"
description: "Conecta a NordVPN por pais, ciudad o servidor especifico. Sin argumentos conecta al mejor servidor disponible. Devuelve JSON con resultado."
tags: [vpn, nordvpn, connect, infra, network]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
params:
  - name: country
    desc: "país de destino (opcional; default: auto)"
  - name: city
    desc: "ciudad de destino (opcional; default: auto)"
output: "JSON con ok, server, country, city"
tested: false
tests: []
test_file_path: ""
file_path: "bash/functions/infra/nordvpn_connect.sh"
---

## Ejemplo

```bash
source nordvpn_connect.sh

nordvpn_connect
# {"ok":true,"server":"us1234.nordvpn.com","country":"auto","city":"auto"}

nordvpn_connect Spain
# {"ok":true,"server":"es42.nordvpn.com","country":"Spain","city":"auto"}

nordvpn_connect Spain Madrid
# {"ok":true,"server":"es15.nordvpn.com","country":"Spain","city":"Madrid"}
```

## Notas

Requiere NordVPN CLI instalado y autenticado (`nordvpn login`). La salida JSON facilita composicion con otros scripts y pipelines. Si ya hay una conexion activa, NordVPN reconecta automaticamente al nuevo destino.
