← VOLVER

Deja de Esparcir process.env por Todas Partes: Usa env-interpolation

— 2 min de lectura

¿Cansado de process.env esparcido por tu código? env-interpolation es una librería TypeScript que resuelve marcadores ${VAR} y ${VAR:default} dentro de objetos de configuración. Recorre cadenas en objetos/arrays y nunca toca las claves, por lo que las formas se mantienen estables y predecibles—perfecto para configuración en capas.

Lo construí para mcp-tool-selector, donde necesitaba configuración en capas sin filtrar secretos o esparcir llamadas a process.env. Se convirtió en una utilidad afilada, así que la publiqué.

De un vistazo

  • Resuelve marcadores de posición en valores solamente (objetos/arrays), claves intactas
  • Soporta valores predeterminados y resolución de múltiples pasadas
  • Cero dependencias, TS-first, Node 18+, ESM/CJS

Docs & API: lee el repositorio de GitHub y la página del paquete npm.

Prueba rápida: cargar JSON → interpolar

config.json

{
  "api": "${API_URL:https://api.example.com}",
  "timeoutMs": "${TIMEOUT:5000}",
  "flags": ["${PRIMARY:alpha}", "${SECONDARY:beta}"],
  "service": {
    "url": "${SERVICE_URL:${API_URL}/v1}",
    "headers": { "x-tenant": "${TENANT:public}" }
  }
}

load-config.ts

import { readFileSync } from "node:fs";
import { interpolate } from "env-interpolation";


const raw = readFileSync("config.json", "utf8");
const input = JSON.parse(raw);


const resolved = interpolate(input, {
  API_URL: "https://api.example.com",
  TIMEOUT: "8000",
  TENANT: "public",
});


console.log(resolved);

Este es mi segundo proyecto diseñado con IA (el primero fue mcp-server-giphy), construido con múltiples agentes de IA (Claude, Copilot, Gemini & Codex). Si tus configs abarcan archivos, entornos y herramientas, esto debería suavizar algunas asperezas.

¿Por Qué No Usar process.env Directamente?

Leer variables de entorno inline esparce la lógica de configuración por todo tu código:

// Enfoque disperso - difícil de auditar y probar
const apiUrl = process.env.API_URL || "https://api.example.com";
const timeout = parseInt(process.env.TIMEOUT || "5000", 10);

Con env-interpolation, la configuración permanece centralizada. Define la estructura una vez, y la librería maneja la resolución:

// Enfoque centralizado - config.json es la fuente de verdad
const config = interpolate(loadConfig("config.json"), process.env);

Esto hace que las configs sean más fáciles de auditar, probar y compartir entre entornos.

Cuándo Usar env-interpolation

  • Configs multi-entorno: Desarrollo, staging, producción con la misma estructura
  • Configuración en capas: Config base con sobreescrituras específicas por entorno
  • Configuración de herramientas: Herramientas CLI que necesitan archivos de config portables
  • Monorepos: Plantillas de config compartidas entre paquetes

Relacionado: Para almacenamiento seguro de secretos sin archivos de texto plano, echa un vistazo a cross-keychain, que almacena credenciales en el gestor de credenciales nativo de tu SO.