v0.1.1
📦 @notoriosti/env-manager
Resumen de lanzamiento · v0.1.0 → v0.1.1
▎ 31 de marzo de 2026
¿Qué es?
Una librería TypeScript para gestionar configuración y secretos en aplicaciones Node.js. Define tus variables en YAML y env-manager las carga desde archivos .env locales o desde Google Cloud Secret Manager —
con coerción de tipos, validación y soporte multi-ambiente.
npm install @notoriosti/env-manager
✨ Características
┌─────────────────────────────┬──────────────────────────────────────────────────────────────────────────────────┐
│ Característica │ Descripción │
├─────────────────────────────┼──────────────────────────────────────────────────────────────────────────────────┤
│ 📄 Configuración en YAML │ Define variables con origen, tipo, default y validación en un solo archivo │
├─────────────────────────────┼──────────────────────────────────────────────────────────────────────────────────┤
│ 🔐 Dos orígenes de secretos │ local (.env via dotenv) o gcp (Google Cloud Secret Manager) │
├─────────────────────────────┼──────────────────────────────────────────────────────────────────────────────────┤
│ 🔄 Coerción de tipos │ Convierte automáticamente a str, int, float o bool │
├─────────────────────────────┼──────────────────────────────────────────────────────────────────────────────────┤
│ 🌍 Multi-ambiente │ Selecciona el ambiente activo via APP_ENV │
├─────────────────────────────┼──────────────────────────────────────────────────────────────────────────────────┤
│ 🎯 Overrides por variable │ Cada variable puede fijar su propio ambiente, origen o ruta │
├─────────────────────────────┼──────────────────────────────────────────────────────────────────────────────────┤
│ ✅ Validación flexible │ Modo estricto, variables requeridas/opcionales, errores descriptivos al arranque │
├─────────────────────────────┼──────────────────────────────────────────────────────────────────────────────────┤
│ 🔁 API Singleton │ initConfig / getConfig / requireConfig para acceso global │
├─────────────────────────────┼──────────────────────────────────────────────────────────────────────────────────┤
│ 📦 ESM + CJS │ Compatible con proyectos modernos y legacy │
└─────────────────────────────┴──────────────────────────────────────────────────────────────────────────────────┘
Ejemplo rápido
import { initConfig, getConfig } from '@notoriosti/env-manager';
// Inicializa una vez al arranque
initConfig('./config.yaml');
// Accede desde cualquier parte
const port = getConfig('PORT'); // 8080 (number)
const pass = getConfig('DB_PASSWORD'); // desde .env o GCP
config.yaml
variables:
DB_PASSWORD:
source: DB_PASSWORD
type: str
PORT:
source: PORT
type: int
default: 8080
environments:
development:
origin: local
dotenv_path: .env
default: true
production:
origin: gcp
gcp_project_id: mi-proyecto-prod
🔧 v0.1.1 — Corrección de advertencias
Se eliminaron dos advertencias de deprecación que aparecían al instalar el paquete:
npm warn deprecated glob@10.5.0: Old versions of glob are not supported...
npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead
Ambas provenían de dependencias transitivas de @google-cloud/secret-manager → google-gax. Se resolvieron con overrides en el package.json, sin afectar la API.
▎ Sin cambios de API. Actualización segura desde v0.1.0.