@dotenvx/dotenvx 2.10.0 → 2.11.0

package/CHANGELOG.md

@@ -2,7 +2,17 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-[Unreleased](https://github.com/dotenvx/dotenvx/compare/v2.10.0...main)
+[Unreleased](https://github.com/dotenvx/dotenvx/compare/v2.11.0...main)
+
+## [2.11.0](https://github.com/dotenvx/dotenvx/compare/v2.10.0...v2.11.0) (2026-07-15)
+
+### Added
+
+* Add convenience method `dotenvx update` ([#897](https://github.com/dotenvx/dotenvx/pull/897))
+
+### Changed
+
+* BREAKING: Send informational messages like `injected env` to stderr instead of stdout. This makes it more reliable to do things like piping output to a file without needing `--quiet`. ([#898](https://github.com/dotenvx/dotenvx/pull/898))
 
 ## [2.10.0](https://github.com/dotenvx/dotenvx/compare/v2.9.0...v2.10.0) (2026-07-15)
 

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.10.0",
+  "version": "2.11.0",
   "name": "@dotenvx/dotenvx",
   "description": "a secure dotenv–from the creator of `dotenv`",
   "author": "@motdotla",

package/src/cli/actions/update.js

@@ -0,0 +1,15 @@
+const childProcess = require('child_process')
+
+const INSTALL_COMMAND = 'curl -sfS https://dotenvx.sh | sh'
+
+function update () {
+  if (process.pkg) {
+    childProcess.execSync(INSTALL_COMMAND, { stdio: 'inherit' })
+    return
+  }
+
+  console.log('global: npm install -g @dotenvx/dotenvx@latest')
+  console.log('local:  npm install @dotenvx/dotenvx@latest --save')
+}
+
+module.exports = update

package/src/cli/dotenvx.js

@@ -227,6 +227,13 @@ program.command('doctor', { hidden: true })
     return require('./actions/doctor').apply(this, args)
   })
 
+// dotenvx update
+program.command('update')
+  .description('update dotenvx')
+  .action(function (...args) {
+    return require('./actions/update').apply(this, args)
+  })
+
 // dotenvx login (compatibility alias for dotenvx armor login)
 program.command('login', { hidden: true })
   .description('log in to move keys off-device, share with your team, and audit access')

package/src/lib/helpers/colorDepth.js

@@ -1,7 +1,13 @@
 const { WriteStream } = require('tty')
 
-const getColorDepth = () => {
+const getColorDepth = (stream) => {
+  if (stream && !stream.isTTY) return 1
+
   try {
+    if (stream && typeof stream.getColorDepth === 'function') {
+      return stream.getColorDepth()
+    }
+
     return WriteStream.prototype.getColorDepth()
   } catch (error) {
     const term = process.env.TERM

package/src/lib/main.d.ts

@@ -173,7 +173,6 @@ export interface DotenvConfigOptions {
     | 'error'
     | 'warn'
     | 'success'
-    | 'successv'
     | 'info'
     | 'help'
     | 'verbose'

package/src/shared/colors.js

@@ -33,8 +33,8 @@ const colorsTrueColor = new Map([
   ['red', [140, 35, 50]] // #8C2332 brighter garnet
 ])
 
-function getColor (color) {
-  const colorDepth = depth.getColorDepth()
+function getColor (color, stream) {
+  const colorDepth = depth.getColorDepth(stream)
   if (!colors256.has(color)) {
     throw new Errors({ color }).invalidColor()
   }
@@ -53,8 +53,8 @@ function getColor (color) {
   return (message) => message
 }
 
-function bold (message) {
-  if (depth.getColorDepth() >= 4) {
+function bold (message, stream) {
+  if (depth.getColorDepth(stream) >= 4) {
     return `\x1b[1m${message}\x1b[22m`
   }
 

package/src/shared/logger.js

@@ -1,4 +1,3 @@
-const packageJson = require('../lib/helpers/packageJson')
 const Errors = require('../lib/helpers/errors')
 const { getColor, bold } = require('./colors')
 
@@ -7,7 +6,6 @@ const levels = {
   infoerror: 0,
   warn: 1,
   success: 2,
-  successv: 2,
   info: 2,
   help: 2,
   verbose: 4,
@@ -15,23 +13,26 @@ const levels = {
   silly: 6
 }
 
-const error = (m) => bold(getColor('red')(`☠ ${m}`))
-const infoerror = getColor('gray') // actually an error
-const warn = (m) => getColor('orangered')(`⚠ ${m}`)
-const success = getColor('amber')
-const successv = (m) => getColor('amber')(`⟐ ${m}`)
-const info = getColor('gray')
-const help = getColor('dodgerblue')
-const verbose = (m) => getColor('plum')(`┆ ${m}`)
-const debug = (m) => getColor('plum')(`┆ ${m}`)
+const error = (m, stream) => bold(getColor('red', stream)(`☠ ${m}`), stream)
+const infoerror = (m, stream) => getColor('gray', stream)(m) // actually an error
+const warn = (m, stream) => getColor('orangered', stream)(`⚠ ${m}`)
+const success = (m, stream) => getColor('amber', stream)(m)
+const info = (m, stream) => getColor('gray', stream)(m)
+const help = (m, stream) => getColor('dodgerblue', stream)(m)
+const verbose = (m, stream) => getColor('plum', stream)(`┆ ${m}`)
+const debug = (m, stream) => getColor('plum', stream)(`┆ ${m}`)
 
 let currentLevel = levels.info // default log level
-let currentName = 'dotenvx' // default logger name
-let currentVersion = packageJson.version // default logger version
 
 function stderr (level, message) {
-  const formattedMessage = formatMessage(level, message)
-  console.error(formattedMessage)
+  if (levels[level] === undefined) {
+    throw new Errors({ level }).missingLogLevel()
+  }
+
+  if (levels[level] <= currentLevel) {
+    const formattedMessage = formatMessage(level, message, process.stderr)
+    console.error(formattedMessage)
+  }
 }
 
 function stdout (level, message) {
@@ -40,40 +41,38 @@ function stdout (level, message) {
   }
 
   if (levels[level] <= currentLevel) {
-    const formattedMessage = formatMessage(level, message)
+    const formattedMessage = formatMessage(level, message, process.stdout)
     console.log(formattedMessage)
   }
 }
 
-function formatMessage (level, message) {
+function formatMessage (level, message, stream) {
   const formattedMessage = typeof message === 'object' ? JSON.stringify(message) : message
 
   switch (level.toLowerCase()) {
     // errors
     case 'error':
-      return error(formattedMessage)
+      return error(formattedMessage, stream)
     case 'infoerror':
-      return infoerror(formattedMessage)
+      return infoerror(formattedMessage, stream)
     // warns
     case 'warn':
-      return warn(formattedMessage)
+      return warn(formattedMessage, stream)
     // successes
     case 'success':
-      return success(formattedMessage)
-    case 'successv': // success with 'version'
-      return successv(`${formattedMessage} · ${currentName}@${currentVersion}`)
+      return success(formattedMessage, stream)
     // info
     case 'info':
-      return info(formattedMessage)
+      return info(formattedMessage, stream)
     // help
     case 'help':
-      return help(formattedMessage)
+      return help(formattedMessage, stream)
     // verbose
     case 'verbose':
-      return verbose(formattedMessage)
+      return verbose(formattedMessage, stream)
     // debug
     case 'debug':
-      return debug(formattedMessage)
+      return debug(formattedMessage, stream)
   }
 }
 
@@ -85,18 +84,17 @@ const logger = {
   error: (msg) => stderr('error', msg),
   infoerror: (msg) => stderr('infoerror', msg),
   // warns
-  warn: (msg) => stdout('warn', msg),
+  warn: (msg) => stderr('warn', msg),
   // success
-  success: (msg) => stdout('success', msg),
-  successv: (msg) => stdout('successv', msg),
+  success: (msg) => stderr('success', msg),
   // info
   info: (msg) => stdout('info', msg),
   // help
-  help: (msg) => stdout('help', msg),
+  help: (msg) => stderr('help', msg),
   // verbose
-  verbose: (msg) => stdout('verbose', msg),
+  verbose: (msg) => stderr('verbose', msg),
   // debug
-  debug: (msg) => stdout('debug', msg),
+  debug: (msg) => stderr('debug', msg),
   setLevel: (level) => {
     if (levels[level] !== undefined) {
       currentLevel = levels[level]
@@ -104,11 +102,9 @@ const logger = {
     }
   },
   setName: (name) => {
-    currentName = name
     logger.name = name
   },
   setVersion: (version) => {
-    currentVersion = version
     logger.version = version
   }
 }