@dotenvx/dotenvx 1.51.3 → 1.52.0

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.51.3...main)
+[Unreleased](https://github.com/dotenvx/dotenvx/compare/v1.52.0...main)
+
+## [1.52.0](https://github.com/dotenvx/dotenvx/compare/v1.51.4...v1.52.0) (2026-01-22)
+
+### Added
+
+* Pass log level options to `main.set` ([#731](https://github.com/dotenvx/dotenvx/pull/731))
+
+## [1.51.4](https://github.com/dotenvx/dotenvx/compare/v1.51.3...v1.51.4) (2025-12-29)
+
+### Changed
+
+* Change description of `dotenvx-ops` to better reflect its tooling as operational primitives on top of dotenvx for production use cases. ([#721](https://github.com/dotenvx/dotenvx/pull/723))
 
 ## [1.51.3](https://github.com/dotenvx/dotenvx/compare/v1.51.2...v1.51.3) (2025-12-29)
 
@@ -47,7 +59,7 @@ All notable changes to this project will be documented in this file. See [standa
 ```
  _______________________________________________________________________
 |                                                                       |
-|  Dotenvx Ops: Commercial Tooling for Dotenvx                          |
+|  dotenvx-ops: production grade dotenvx–with operational primitives    |
 |                                                                       |
 |  ░▒▓██████▓▒░░▒▓███████▓▒░ ░▒▓███████▓▒░                              |
 | ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░                                     |
@@ -57,8 +69,6 @@ All notable changes to this project will be documented in this file. See [standa
 | ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░             ░▒▓█▓▒░                              |
 |  ░▒▓██████▓▒░░▒▓█▓▒░      ░▒▓███████▓▒░                               |
 |                                                                       |
-|  Use dotenvx across your team, infrastructure, agents, and more.      |
-|                                                                       |
 |  Learn more at https://dotenvx.com/ops                                |
 |_______________________________________________________________________|
 ```

package/README.md

@@ -2568,6 +2568,17 @@ const dotenvx = require('@dotenvx/dotenvx')
 dotenvx.set('HELLO', 'World', { path: '.env' })
 ```
 
+</details>
+<details><summary>`set(KEY, value, {plain:})`</summary><br>
+
+Programmatically set a plaintext environment variable.
+
+```js
+// index.js
+const dotenvx = require('@dotenvx/dotenvx')
+dotenvx.set('HELLO', 'World', { plain: true })
+```
+
 </details>
 <details><summary>`get(KEY)` - <i>Decryption at Access</i></summary><br>
 
@@ -2590,44 +2601,40 @@ This is known as *Decryption at Access* and is written about in [the whitepaper]
 
 [![dotenvx-ops](https://dotenvx.com/dotenvx-ops-banner.png?v=2)](https://dotenvx.com/ops)
 
-> [Dotenvx Ops](https://dotenvx.com/ops) is optional commercial tooling for [dotenvx](https://github.com/dotenvx/dotenvx).
+*production grade dotenvx*–with operational primitives.
 
-*Use dotenvx across your team, infrastructure, agents, and more.*
+> As dotenvx spreads inside companies, we're learning—through enterprise engagements—that dotenvx is missing an operations layer.
+>
+> Dotenvx Ops is our answer.
+>
+> It's production grade dotenvx–with operational primitives for teams, infrastructure, and agents. Private key management, access controls, and more.
 
-### Usage
+### Quickstart
 
-1. Install dotenvx-ops
+Install it and gain `ops` commands.
 
 ```sh
 $ curl -sfS https://dotenvx.sh/ops | sh
+$ dotenvx ops backup
+✔ backed up [username/project]
+⮕ next run [dotenvx-ops open] to view
 ```
 
-2. Log in
+### CLI
 
-```sh
-$ dotenvx-ops login
-✔ logged in [username]
-```
+<details><summary>`ops backup`</summary><br>
 
-3. Run dotenvx
+Back up .env.keys.
 
 ```sh
-$ dotenvx run -- yourcommand
-[dotenvx@1.0.0] 📡 radar active
-[dotenvx@1.0.0] injecting env (1) from .env
+$ dotenvx-ops backup
+✔ backed up [username/project]
 ```
 
-That's it! Your environment variables are auto-observed and backed up by [Dotenvx Ops](https://dotenvx.com/ops) radar feature.
-
-### UI
-
-![dotenvx-ops](https://dotenvx.com/ops/ui.png)
-
-### CLI
-
-<details><summary>`login`</summary><br>
+</details>
+<details><summary>`ops login`</summary><br>
 
-Log in to [Ops](https://dotenvx.com/ops).
+Log in.
 
 ```sh
 $ dotenvx-ops login
@@ -2637,25 +2644,15 @@ press Enter to open [https://ops.dotenvx.com/login/device] and enter code [D9C1-
 ```
 
 </details>
-<details><summary>`logout`</summary><br>
+<details><summary>`ops logout`</summary><br>
 
-Log out of [Ops](https://dotenvx.com/ops).
+Log out.
 
 ```sh
-$ dotenvx-ops logout
+$ dotenvx ops logout
 ✔ logged out [username] from this device and revoked token [dxo_5ZrwRXV…]
 ```
 
-</details>
-<details><summary>`status`</summary><br>
-
-Check current status of [Ops](https://dotenvx.com/ops) - `on` or `off` (logged in or out).
-
-```sh
-$ dotenvx-ops status
-on
-```
-
 </details>
 <details><summary>`settings`</summary><br>
 
@@ -2668,13 +2665,25 @@ Usage: dotenvx-ops settings [options] [command]
 ⚙️  settings
 
 Options:
-  -h, --help       display help for command
+  -h, --help        display help for command
 
 Commands:
-  username         print your username
-  token [options]  print your access token (--unmask)
-  hostname         print hostname
-  help [command]   display help for command
+  username          print your username
+  token [options]   print your access token (--unmask)
+  device [options]  print your device pubkey (--unmask)
+  hostname          print hostname
+  path              print path to settings file
+  help [command]    display help for command
+```
+
+</details>
+<details><summary>`ops status`</summary><br>
+
+Check current status of [Ops](https://dotenvx.com/ops) - `on` or `off` (logged in or out).
+
+```sh
+$ dotenvx ops status
+on
 ```
 
 </details>

package/package.json

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

package/src/cli/actions/encrypt.js

@@ -62,12 +62,13 @@ function encrypt () {
       for (const processedEnv of processedEnvs) {
         if (processedEnv.privateKeyAdded) {
           logger.success(`✔ key added to .env.keys (${processedEnv.privateKeyName})`)
+          logger.help('⮕  optional: [dotenvx ops backup] to securely backup private key')
 
           if (!isIgnoringDotenvKeys()) {
-            logger.help('⮕  next run [dotenvx ext gitignore --pattern .env.keys] to gitignore .env.keys')
+            logger.help('⮕  next run: [dotenvx ext gitignore --pattern .env.keys] to gitignore .env.keys')
           }
 
-          logger.help(`⮕  next run [${processedEnv.privateKeyName}='${processedEnv.privateKey}' dotenvx run -- yourcommand] to test decryption locally`)
+          logger.help(`⮕  next run: [${processedEnv.privateKeyName}='${processedEnv.privateKey}' dotenvx run -- yourcommand] to test decryption locally`)
         }
       }
     } catch (error) {

package/src/cli/actions/rotate.js

@@ -65,12 +65,13 @@ function rotate () {
       for (const processedEnv of processedEnvs) {
         if (processedEnv.privateKeyAdded) {
           logger.success(`✔ key added to .env.keys (${processedEnv.privateKeyName})`)
+          logger.help('⮕  optional: [dotenvx ops backup] to securely backup private key')
 
           if (!isIgnoringDotenvKeys()) {
-            logger.help('⮕  next run [dotenvx ext gitignore --pattern .env.keys] to gitignore .env.keys')
+            logger.help('⮕  next run: [dotenvx ext gitignore --pattern .env.keys] to gitignore .env.keys')
           }
 
-          logger.help(`⮕  next run [${processedEnv.privateKeyName}='${processedEnv.privateKey}' dotenvx get] to test decryption locally`)
+          logger.help(`⮕  next run: [${processedEnv.privateKeyName}='${processedEnv.privateKey}' dotenvx get] to test decryption locally`)
         }
       }
     } catch (error) {

package/src/cli/actions/set.js

@@ -67,12 +67,13 @@ function set (key, value) {
     for (const processedEnv of processedEnvs) {
       if (processedEnv.privateKeyAdded) {
         logger.success(`✔ key added to ${processedEnv.envKeysFilepath} (${processedEnv.privateKeyName})`)
+        logger.help('⮕  optional: [dotenvx ops backup] to securely backup private key')
 
         if (!isIgnoringDotenvKeys()) {
-          logger.help('⮕  next run [dotenvx ext gitignore --pattern .env.keys] to gitignore .env.keys')
+          logger.help('⮕  next run: [dotenvx ext gitignore --pattern .env.keys] to gitignore .env.keys')
         }
 
-        logger.help(`⮕  next run [${processedEnv.privateKeyName}='${processedEnv.privateKey}' dotenvx get ${key}] to test decryption locally`)
+        logger.help(`⮕  next run: [${processedEnv.privateKeyName}='${processedEnv.privateKey}' dotenvx get ${key}] to test decryption locally`)
       }
     }
   } catch (error) {

package/src/lib/helpers/executeDynamic.js

@@ -22,14 +22,14 @@ 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('[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]')
+    if (command === 'radar') {
+      logger.warn(`[INSTALLATION_NEEDED] install dotenvx-${command} to use [dotenvx ${command}] 📡`)
+      logger.warn('[DEPRECATION NOTICE] dotenvx-radar to be sunsetted soon (2026) and its featureset to be rolled into dotenvx-ops')
+      logger.help('? see installation instructions [https://dotenvx.com/radar]')
     } else if (command === 'ops') {
       const ops = ` _______________________________________________________________________
 |                                                                       |
-|  Dotenvx Ops: Commercial Tooling for Dotenvx                          |
+|  dotenvx-ops: production grade dotenvx–with operational primitives    |
 |                                                                       |
 |  ░▒▓██████▓▒░░▒▓███████▓▒░ ░▒▓███████▓▒░                              |
 | ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░                                     |
@@ -39,43 +39,14 @@ function executeDynamic (program, command, rawArgs) {
 | ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░             ░▒▓█▓▒░                              |
 |  ░▒▓██████▓▒░░▒▓█▓▒░      ░▒▓███████▓▒░                               |
 |                                                                       |
-|  Use dotenvx across your team, infrastructure, agents, and more.      |
-|                                                                       |
 |  Learn more at https://dotenvx.com/ops                                |
-|                                                                       |
-| --------------------------------------------------------------------- |
-| - thank you for using dotenvx! - @motdotla                            |
 |_______________________________________________________________________|`
 
       console.log(ops)
       console.log('')
       logger.warn(`[INSTALLATION_NEEDED] install dotenvx-${command} to use [dotenvx ${command}] 🏰`)
-      logger.help('? see installation instructions [https://dotenvx.com/ops]')
-    } else if (command === 'radar') {
-      const radar = ` _______________________________________________________________________
-|                                                                       |
-|  Dotenvx Radar: Env Observability                                     |
-|                                                                       |
-|  ░▒▓███████▓▒░ ░▒▓██████▓▒░░▒▓███████▓▒░ ░▒▓██████▓▒░░▒▓███████▓▒░    |
-|  ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░   |
-|  ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░   |
-|  ░▒▓███████▓▒░░▒▓████████▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓████████▓▒░▒▓███████▓▒░    |
-|  ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░   |
-|  ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░   |
-|  ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓███████▓▒░░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░   |
-|                                                                       |
-|  Observe, version, and back up your environment variables at runtime. |
-|                                                                       |
-|  Purchase lifetime access at https://dotenvx.com/radar                |
-|                                                                       |
-| --------------------------------------------------------------------- |
-| - thank you for using dotenvx! - @motdotla                            |
-|_______________________________________________________________________|`
-
-      console.log(radar)
-      console.log('')
-      logger.warn(`[INSTALLATION_NEEDED] install dotenvx-${command} to use [dotenvx ${command}] 📡`)
-      logger.help('? see installation instructions [https://dotenvx.com/radar]')
+      logger.help('⮕  next run: [curl -sfS https://dotenvx.sh/ops | sh]')
+      logger.help('⮕  see more: [https://dotenvx.com/ops]')
     } else {
       logger.info(`error: unknown command '${command}'`)
     }

package/src/lib/main.js

@@ -188,6 +188,12 @@ const set = function (key, value, options = {}) {
     encrypt = false
   }
 
+  if (options) {
+    setLogLevel(options)
+    setLogName(options)
+    setLogVersion(options)
+  }
+
   const envs = buildEnvs(options)
   const envKeysFilepath = options.envKeysFile
 
@@ -235,12 +241,13 @@ const set = function (key, value, options = {}) {
   for (const processedEnv of processedEnvs) {
     if (processedEnv.privateKeyAdded) {
       logger.success(`✔ key added to ${processedEnv.envKeysFilepath} (${processedEnv.privateKeyName})`)
+      logger.help('⮕  optional: [dotenvx ops backup] to securely backup private key')
 
       if (!isIgnoringDotenvKeys()) {
-        logger.help('⮕  next run [dotenvx ext gitignore --pattern .env.keys] to gitignore .env.keys')
+        logger.help('⮕  next run: [dotenvx ext gitignore --pattern .env.keys] to gitignore .env.keys')
       }
 
-      logger.help(`⮕  next run [${processedEnv.privateKeyName}='${processedEnv.privateKey}' dotenvx get ${key}] to test decryption locally`)
+      logger.help(`⮕  next run: [${processedEnv.privateKeyName}='${processedEnv.privateKey}' dotenvx get ${key}] to test decryption locally`)
     }
   }