chore(sat): prepara entorno para proxies

- Agrega dependencia https-proxy-agent.
- Documenta variables SAT_PROXY_LIST, SAT_PROXY_STRATEGY y SAT_PROXY_FALLBACK_DIRECT en .env.example.
- Actualiza pnpm-lock.yaml.

apps/api/.env.example

@@ -91,3 +91,13 @@ METABASE_PG_PASSWORD=
 
 # ----- SAT Playwright headless toggle (debug temporal) ----------------------
 # SAT_HEADLESS=false           # solo dev — muestra browser para debug de scrapers
+
+# ----- Proxies SAT (opcional) ------------------------------------------------
+# Lista de proxies HTTP/HTTPS para descargas masivas del SAT. Formato:
+#   http://user:pass@host:port,http://user:pass@host:port,...
+# Si se deja vacío, el sistema usa la IP pública del servidor (comportamiento actual).
+SAT_PROXY_LIST=
+# Estrategia de rotación: round-robin | random (default: round-robin)
+SAT_PROXY_STRATEGY=round-robin
+# Si es true, cuando todos los proxies fallan se intenta con la IP directa del servidor.
+SAT_PROXY_FALLBACK_DIRECT=true

apps/api/package.json

@@ -35,6 +35,7 @@
     "facturapi": "^4.14.2",
     "fast-xml-parser": "^5.3.3",
     "helmet": "^8.0.0",
+    "https-proxy-agent": "^7.0.6",
     "jsonwebtoken": "^9.0.2",
     "mercadopago": "^2.12.0",
     "node-cron": "^4.2.1",