@dotenvx/dotenvx 1.50.1 → 1.51.1

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/v1.50.1...main)
+[Unreleased](https://github.com/dotenvx/dotenvx/compare/v1.51.1...main)
+
+## [1.51.1](https://github.com/dotenvx/dotenvx/compare/v1.51.0...v1.51.1) (2025-11-03)
+
+### Added
+
+* Add `opsOff` type information
+
+## [1.51.0](https://github.com/dotenvx/dotenvx/compare/v1.50.1...v1.51.0) (2025-09-23)
+
+### Added
+
+* Add `config({opsOff: true})` options and `--ops-off` flag for turning off [Dotenvx Ops](https://dotenvx.com/ops) features. ([#680](https://github.com/dotenvx/dotenvx/pull/680))
 
 ## [1.50.1](https://github.com/dotenvx/dotenvx/compare/v1.50.0...v1.50.1) (2025-09-18)
 

package/README.md

@@ -1247,6 +1247,15 @@ $ dotenvx set HELLO world -fk .env.keys -f apps/app1/.env
 $ dotenvx run -fk .env.keys -f apps/app1/.env -- yourcommand
 ```
 
+</details>
+<details><summary>`run --ops-off`</summary><br>
+
+Turn off [Dotenvx Ops](https://dotenvx.com/ops) features.
+
+```sh
+$ dotenvx run --ops-off -- yourcommand
+```
+
 </details>
 <details><summary>`get KEY`</summary><br>
 
@@ -2453,6 +2462,48 @@ HELLO="World"
 require('@dotenvx/dotenvx').config({path: ['.env'], envKeysFile: '../../.env.keys'})
 ```
 
+</details>
+<details><summary>`config(convention:)` - convention</summary><br>
+
+Set a convention when using `dotenvx.config()`. This allows you to use the same file loading order as the CLI without needing to specify each file individually.
+
+```sh
+# Setup environment files
+$ echo "HELLO=development local" > .env.development.local
+$ echo "HELLO=local" > .env.local
+$ echo "HELLO=development" > .env.development
+$ echo "HELLO=env" > .env
+```
+
+```js
+// index.js
+require('@dotenvx/dotenvx').config({ convention: 'nextjs' })
+
+console.log(`Hello ${process.env.HELLO}`)
+```
+
+```sh
+$ NODE_ENV=development node index.js
+[dotenvx@1.28.0] injecting env (1) from .env.development.local, .env.local, .env.development, .env
+Hello development local
+```
+
+This is equivalent to using `--convention=nextjs` with the CLI:
+
+```sh
+$ dotenvx run --convention=nextjs -- node index.js
+```
+
+</details>
+<details><summary>`config(opsOff:)` - opsOff</summary><br>
+
+Turn off [Dotenvx Ops](https://dotenvx.com/ops) features.
+
+```js
+// index.js
+require('@dotenvx/dotenvx').config({opsOff: true})
+```
+
 </details>
 <details><summary>`parse(src)`</summary><br>
 

package/package.json

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

package/src/cli/actions/run.js

@@ -18,6 +18,9 @@ async function run () {
 
   const ignore = options.ignore || []
 
+  // dotenvx-ops related
+  const opsOn = options.opsOff !== true
+
   if (commandArgs.length < 1) {
     const hasSeparator = process.argv.indexOf('--') !== -1
 
@@ -49,10 +52,12 @@ async function run () {
       readableStrings,
       readableFilepaths,
       uniqueInjectedKeys
-    } = new Run(envs, options.overload, process.env.DOTENV_KEY, process.env, options.envKeysFile).run()
+    } = new Run(envs, options.overload, process.env.DOTENV_KEY, process.env, options.envKeysFile, opsOn).run()
 
-    try { new Radar().observe({ beforeEnv, processedEnvs, afterEnv }) } catch {}
-    try { new Ops().observe({ beforeEnv, processedEnvs, afterEnv }) } catch {}
+    if (opsOn) {
+      try { new Radar().observe({ beforeEnv, processedEnvs, afterEnv }) } catch {}
+      try { new Ops().observe({ beforeEnv, processedEnvs, afterEnv }) } catch {}
+    }
 
     for (const processedEnv of processedEnvs) {
       if (processedEnv.type === 'envVaultFile') {

package/src/cli/dotenvx.js

@@ -73,6 +73,7 @@ program.command('run')
   .option('--strict', 'process.exit(1) on any errors', false)
   .option('--convention <name>', 'load a .env convention (available conventions: [\'nextjs\', \'flow\'])')
   .option('--ignore <errorCodes...>', 'error code(s) to ignore (example: --ignore=MISSING_ENV_FILE)')
+  .option('--ops-off', 'disable dotenvx-ops features', false)
   .action(function (...args) {
     this.envs = envs
     runAction.apply(this, args)

package/src/lib/helpers/executeDynamic.js

@@ -23,7 +23,8 @@ function executeDynamic (program, command, rawArgs) {
   const result = childProcess.spawnSync(`dotenvx-${command}`, forwardedArgs, { stdio: 'inherit', env })
   if (result.error) {
     if (command === 'pro') {
-      logger.warn(`[INSTALLATION_NEEDED] install dotenvx-${command} to use [dotenvx ${command}] commands 🏆`)
+      logger.warn(`[INSTALLATION_NEEDED] install dotenvx-${command} to use [dotenvx-${command}] commands 🏆`)
+      logger.warn('[DEPRECATION NOTICE] dotenvx-pro to be sunsetted soon (2026) and its featureset to be rolled into dotenvx-ops')
       logger.help('? see installation instructions [https://github.com/dotenvx/dotenvx-pro]')
     } else if (command === 'ops') {
       const ops = ` _______________________________________________________________________

package/src/lib/helpers/findPrivateKey.js

@@ -5,11 +5,15 @@ const ProKeypair = require('./proKeypair')
 // services
 const Keypair = require('./../services/keypair')
 
-function findPrivateKey (envFilepath, envKeysFilepath = null) {
+function findPrivateKey (envFilepath, envKeysFilepath = null, opsOn = true) {
   // use path/to/.env.${environment} to generate privateKeyName
   const privateKeyName = guessPrivateKeyName(envFilepath)
 
-  const proKeypairs = new ProKeypair(envFilepath).run() // TODO: implement custom envKeysFilepath
+  let proKeypairs = {}
+  if (opsOn) {
+    proKeypairs = new ProKeypair(envFilepath).run() // TODO: implement custom envKeysFilepath
+  }
+
   const keypairs = new Keypair(envFilepath, envKeysFilepath).run()
 
   return proKeypairs[privateKeyName] || keypairs[privateKeyName]

package/src/lib/helpers/findPublicKey.js

@@ -5,10 +5,14 @@ const ProKeypair = require('./proKeypair')
 // services
 const Keypair = require('./../services/keypair')
 
-function findPublicKey (envFilepath) {
+function findPublicKey (envFilepath, opsOn = true) {
   const publicKeyName = guessPublicKeyName(envFilepath)
 
-  const proKeypairs = new ProKeypair(envFilepath).run()
+  let proKeypairs = {}
+  if (opsOn) {
+    proKeypairs = new ProKeypair(envFilepath).run()
+  }
+
   const keypairs = new Keypair(envFilepath).run()
 
   return proKeypairs[publicKeyName] || keypairs[publicKeyName]

package/src/lib/main.d.ts

@@ -146,6 +146,14 @@ export interface DotenvConfigOptions {
     | 'help'
     | 'verbose'
     | 'debug';
+
+  /**
+   * Turn off Dotenvx Ops features - https://dotenvx.com/ops
+   *
+   * @default false
+   * @example require('@dotenvx/dotenvx').config({ opsOff: true })
+   */
+  opsOff?: boolean;
 }
 
 export interface DotenvConfigOutput {

package/src/lib/main.js

@@ -47,6 +47,9 @@ const config = function (options = {}) {
     DOTENV_KEY = options.DOTENV_KEY
   }
 
+  // dotenvx-ops related
+  const opsOn = options.opsOff !== true
+
   if (options) {
     setLogLevel(options)
     setLogName(options)
@@ -61,10 +64,12 @@ const config = function (options = {}) {
       processedEnvs,
       readableFilepaths,
       uniqueInjectedKeys
-    } = new Run(envs, overload, DOTENV_KEY, processEnv, envKeysFile).run()
+    } = new Run(envs, overload, DOTENV_KEY, processEnv, envKeysFile, opsOn).run()
 
-    try { new Radar().observe({ beforeEnv, processedEnvs, afterEnv }) } catch {}
-    try { new Ops().observe({ beforeEnv, processedEnvs, afterEnv }) } catch {}
+    if (opsOn) {
+      try { new Radar().observe({ beforeEnv, processedEnvs, afterEnv }) } catch {}
+      try { new Ops().observe({ beforeEnv, processedEnvs, afterEnv }) } catch {}
+    }
 
     let lastError
     /** @type {Record<string, string>} */

package/src/lib/services/radar.js

@@ -10,11 +10,13 @@ class Radar {
     // check npm lib
     try {
       this.radarLib = this._radarNpm()
+      logger.warn('[DEPRECATION NOTICE] dotenvx-radar is renamed dotenv-ops. [See https://dotenvx.com/docs/ops]')
       logger.successv(`📡 radar: ${this.radarLib.status}`)
     } catch (e) {
       // check binary cli
       try {
         this.radarLib = this._radarCli()
+        logger.warn('[DEPRECATION NOTICE] dotenvx-radar is renamed dotenv-ops. [See https://dotenvx.com/docs/ops]')
         logger.successv(`📡 radar: ${this.radarLib.status}`)
       } catch (_e2) {
         // noop

package/src/lib/services/run.js

@@ -16,12 +16,13 @@ const guessPrivateKeyName = require('./../helpers/guessPrivateKeyName')
 const determineEnvs = require('./../helpers/determineEnvs')
 
 class Run {
-  constructor (envs = [], overload = false, DOTENV_KEY = '', processEnv = process.env, envKeysFilepath = null) {
+  constructor (envs = [], overload = false, DOTENV_KEY = '', processEnv = process.env, envKeysFilepath = null, opsOn = true) {
     this.envs = determineEnvs(envs, processEnv, DOTENV_KEY)
     this.overload = overload
     this.DOTENV_KEY = DOTENV_KEY
     this.processEnv = processEnv
     this.envKeysFilepath = envKeysFilepath
+    this.opsOn = opsOn
 
     this.processedEnvs = []
     this.readableFilepaths = new Set()
@@ -96,7 +97,7 @@ class Run {
       const src = fsx.readFileX(filepath, { encoding })
       this.readableFilepaths.add(envFilepath)
 
-      const privateKey = findPrivateKey(envFilepath, this.envKeysFilepath)
+      const privateKey = findPrivateKey(envFilepath, this.envKeysFilepath, this.opsOn)
       const privateKeyName = guessPrivateKeyName(envFilepath)
       const { parsed, errors, injected, preExisted } = new Parse(src, privateKey, this.processEnv, this.overload, privateKeyName).run()