@dotenvx/dotenvx 2.1.2 → 2.1.4

package/CHANGELOG.md

@@ -2,7 +2,19 @@
 
 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.1.2...main)
+[Unreleased](https://github.com/dotenvx/dotenvx/compare/v2.1.4...main)
+
+## [2.1.4](https://github.com/dotenvx/dotenvx/compare/v2.1.3...v2.1.4) (2026-07-02)
+
+### Added
+
+* Add support for `DOTENV_CONFIG_CONVENTION=nextjs` ([#869](https://github.com/dotenvx/dotenvx/pull/869))
+
+## [2.1.3](https://github.com/dotenvx/dotenvx/compare/v2.1.2...v2.1.3) (2026-07-02)
+
+### Changed
+
+* Patch edge case when custom unspecified `-f` and `--env` flag ([#868](https://github.com/dotenvx/dotenvx/pull/868))
 
 ## [2.1.2](https://github.com/dotenvx/dotenvx/compare/v2.1.1...v2.1.2) (2026-07-02)
 

package/README.md

@@ -1319,6 +1319,14 @@ $ dotenvx run --convention=nextjs -- node index.js
 Hello development local
 ```
 
+You can also set `DOTENV_CONFIG_CONVENTION=nextjs`.
+
+```sh
+$ DOTENV_CONFIG_CONVENTION=nextjs dotenvx run -- node index.js
+[dotenvx@1.X.X] injecting env (1) from .env.development.local, .env.local, .env.development, .env
+Hello development local
+```
+
 (more conventions available upon request)
 
 </details>
@@ -1338,6 +1346,14 @@ $ NODE_ENV=development dotenvx run --convention=flow -- node index.js
 Hello development local
 ```
 
+You can also set `DOTENV_CONFIG_CONVENTION=flow`.
+
+```sh
+$ NODE_ENV=development DOTENV_CONFIG_CONVENTION=flow dotenvx run -- node index.js
+[dotenvx@1.X.X] injecting env (1) from .env.development.local, .env.development, .env.local, .env
+Hello development local
+```
+
 Further, we recommend using `DOTENV_ENV` over `NODE_ENV`– as `dotenvx` works everywhere, not just node.
 
 ```sh
@@ -1468,6 +1484,13 @@ $ dotenvx get HELLO --convention=nextjs
 development local
 ```
 
+You can also set `DOTENV_CONFIG_CONVENTION=nextjs`.
+
+```sh
+$ DOTENV_CONFIG_CONVENTION=nextjs dotenvx get HELLO
+development local
+```
+
 </details>
 <details><summary>`get KEY --convention=flow`</summary><br>
 
@@ -1484,6 +1507,13 @@ $ NODE_ENV=development dotenvx get HELLO --convention=flow
 development local
 ```
 
+You can also set `DOTENV_CONFIG_CONVENTION=flow`.
+
+```sh
+$ NODE_ENV=development DOTENV_CONFIG_CONVENTION=flow dotenvx get HELLO
+development local
+```
+
 Further, we recommend using `DOTENV_ENV` over `NODE_ENV`– as `dotenvx` works everywhere, not just node.
 
 ```sh
@@ -2568,6 +2598,12 @@ This is equivalent to using `--convention=nextjs` with the CLI:
 $ dotenvx run --convention=nextjs -- node index.js
 ```
 
+You can also set `DOTENV_CONFIG_CONVENTION=nextjs`.
+
+```sh
+$ DOTENV_CONFIG_CONVENTION=nextjs node index.js
+```
+
 </details>
 <details><summary>`config(noArmor:)` - noArmor</summary><br>
 

package/package.json

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

package/src/cli/actions/get.js

@@ -7,9 +7,10 @@ const createSpinner = require('../../lib/helpers/createSpinner')
 const Session = require('../../db/session')
 const getResolver = require('./../../lib/resolvers/get')
 const normalizeArmorAliases = require('./normalizeArmorAliases')
+const normalizeDotenvConfigConvention = require('../../lib/helpers/normalizeDotenvConfigConvention')
 
 async function get (key) {
-  const options = normalizeArmorAliases(this.opts())
+  const options = normalizeDotenvConfigConvention(normalizeArmorAliases(this.opts()))
   const spinner = await createSpinner({ ...options, text: 'decrypting' })
 
   logger.debug(`options: ${JSON.stringify(options)}`)

package/src/cli/actions/run.js

@@ -8,6 +8,7 @@ const createSpinner = require('../../lib/helpers/createSpinner')
 const Session = require('../../db/session')
 const normalizeArmorAliases = require('./normalizeArmorAliases')
 const normalizeDotenvConfigQuiet = require('../../lib/helpers/normalizeDotenvConfigQuiet')
+const normalizeDotenvConfigConvention = require('../../lib/helpers/normalizeDotenvConfigConvention')
 
 const conventions = require('./../../lib/helpers/conventions')
 const { determine } = require('./../../lib/helpers/envResolution')
@@ -46,7 +47,7 @@ function uniqueInjectedKeys (processedEnvs) {
 }
 
 async function run () {
-  const options = normalizeDotenvConfigQuiet(normalizeArmorAliases(this.opts()))
+  const options = normalizeDotenvConfigConvention(normalizeDotenvConfigQuiet(normalizeArmorAliases(this.opts())))
 
   let commandArgs = this.args
   if (commandArgs.length < 1) {

package/src/lib/helpers/envResolution/determine.js

@@ -17,13 +17,16 @@ function envsFromDotenvPrivateKey (privateKeyNames) {
 
 function determine (envs = [], processEnv) {
   const privateKeyNames = dotenvPrivateKeyNames(processEnv)
-  if (!envs || envs.length <= 0) {
-    // if process.env.DOTENV_PRIVATE_KEY or process.env.DOTENV_PRIVATE_KEY_${environment} is set, assume inline encryption methodology
-    if (privateKeyNames.length > 0) {
-      return envsFromDotenvPrivateKey(privateKeyNames)
-    }
 
-    return DEFAULT_ENVS // default to .env file expectation
+  // https://github.com/dotenvx/dotenvx/issues/670
+  let defaults = DEFAULT_ENVS // default to .env file expectation
+  // if process.env.DOTENV_PRIVATE_KEY or process.env.DOTENV_PRIVATE_KEY_${environment} is set, assume inline encryption methodology
+  if (privateKeyNames.length > 0) {
+    defaults = envsFromDotenvPrivateKey(privateKeyNames)
+  }
+
+  if (!envs || envs.length <= 0) {
+    return defaults
   } else {
     let fileAlreadySpecified = false
 
@@ -39,7 +42,7 @@ function determine (envs = [], processEnv) {
     }
 
     // no .env file specified as a flag so default to .env
-    return [...DEFAULT_ENVS, ...envs]
+    return [...defaults, ...envs]
   }
 }
 

package/src/lib/helpers/normalizeDotenvConfigConvention.js

@@ -0,0 +1,9 @@
+function normalizeDotenvConfigConvention (options) {
+  if (!options.convention && process.env.DOTENV_CONFIG_CONVENTION) {
+    options.convention = process.env.DOTENV_CONFIG_CONVENTION
+  }
+
+  return options
+}
+
+module.exports = normalizeDotenvConfigConvention

package/src/lib/main.js

@@ -23,6 +23,7 @@ const fsx = require('./helpers/fsx')
 const decryptKeyValue = require('./helpers/cryptography/decryptKeyValue')
 const Errors = require('./helpers/errors')
 const normalizeDotenvConfigQuiet = require('./helpers/normalizeDotenvConfigQuiet')
+const normalizeDotenvConfigConvention = require('./helpers/normalizeDotenvConfigConvention')
 
 function uniqueInjectedKeys (processedEnvs) {
   const result = new Set()
@@ -37,6 +38,7 @@ function uniqueInjectedKeys (processedEnvs) {
 /** @type {import('./main').config} */
 const config = function (options = {}) {
   options = normalizeDotenvConfigQuiet(options)
+  options = normalizeDotenvConfigConvention(options)
 
   // allow user to set processEnv to write to
   let processEnv = process.env
@@ -300,6 +302,8 @@ const set = async function (key, value, options = {}) {
 
 /* @type {import('./main').get} */
 const get = async function (key, options = {}) {
+  options = normalizeDotenvConfigConvention(options)
+
   const envs = buildEnvs(options)
   const noArmor = resolveNoArmor(options)