Define una vez, confía en todas partes
CtroEnv utiliza cuatro fábricas de validadores principales para mantener seguras tus variables de entorno.
Así es como funcionan:
string() para texto Úsalo para URLs, correos electrónicos y puertos. Puedes encadenar reglas como .min() o .max() para establecer límites de longitud.
number() para valores numéricos Esto convierte cadenas como "3000" en números reales. Puedes exigir números enteros o valores positivos.
boolean() para true o false Esto gestiona los feature flags. Convierte "true", "1" o "false" en booleanos reales.
pick() para conjuntos específicos Úsalo para restringir los valores a una lista. Por ejemplo, puedes obligar a que NODE_ENV sea únicamente "development", "staging" o "production". Si cometes un error tipográfico, el error sugerirá la ortografía correcta.
Herramientas útiles para cada validador:
• .default(value) - Establece un valor por defecto si la variable no está presente. • .optional() - Permite que la variable sea undefined. • .secret() - Enmascara datos sensibles en tus logs. • .describe(text) - Añade documentación para tus mensajes de error. • .validate(fn) - Te permite escribir lógica personalizada para reglas específicas.
CtroEnv funciona en diferentes entornos:
- Node.js: Usa nodeSource() o loadEnv() para leer archivos .env.
- Vite: Usa el vitePlugin para que tu build falle si