@dotenvx/dotenvx 2.20.1 → 2.21.0

package/CHANGELOG.md

@@ -2,7 +2,18 @@
 
 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.20.1...main)
+[Unreleased](https://github.com/dotenvx/dotenvx/compare/v2.21.0...main)
+
+## [2.21.0](https://github.com/dotenvx/dotenvx/compare/v2.20.1...v2.21.0) (2026-08-10)
+
+### Added
+
+* Add `dotenvx enc` and `dotenvx dec` shorthands for encrypt and decrypt ([#943](https://github.com/dotenvx/dotenvx/pull/943))
+* Add convenient `dx` alias for shorter `dx run --`, `dx enc`, etc ([#944](https://github.com/dotenvx/dotenvx/pull/944))
+
+### Changed
+
+* Patch typescript types for `path` ([#942](https://github.com/dotenvx/dotenvx/pull/942))
 
 ## [2.20.1](https://github.com/dotenvx/dotenvx/compare/v2.20.0...v2.20.1) (2026-08-07)
 

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.20.1",
+  "version": "2.21.0",
   "name": "@dotenvx/dotenvx",
   "description": "a secure dotenv–from the creator of `dotenv`",
   "author": "@motdotla",
@@ -39,7 +39,8 @@
     "./package.json": "./package.json"
   },
   "bin": {
-    "dotenvx": "./src/cli/dotenvx.js"
+    "dotenvx": "./src/cli/dotenvx.js",
+    "dx": "./src/cli/dotenvx.js"
   },
   "scripts": {
     "standard": "standard",

package/src/cli/dotenvx.js

@@ -142,37 +142,45 @@ program.command('del')
   })
 
 // dotenvx encrypt
-program.command('encrypt')
-  .description('encrypt .env file(s)')
-  .option('-f, --env-file <path>', 'path(s) to your env file(s)', collectEnvs('envFile'), [])
-  .option('-fk, --env-keys-file <path>', 'path to your .env.keys file (default: same path as your env file)')
-  .option('-k, --key <keys...>', 'keys(s) to encrypt (default: all keys in file)')
-  .option('-ek, --exclude-key <excludeKeys...>', 'keys(s) to exclude from encryption (default: none)')
-  .option('--stdout', 'send to stdout')
-  .option('--token <token>', 'set Armor ⛨ token')
-  .option('--no-create', 'do not create .env file(s) when missing')
-  .option('--no-armor', 'disable Dotenvx Armor features')
-  .option('--no-native', 'disable OS secret store features')
-  .action(function (...args) {
-    this.envs = envs
-    return require('./actions/encrypt').apply(this, args)
-  })
+function configureEncryptCommand (command) {
+  return command
+    .description('encrypt .env file(s)')
+    .option('-f, --env-file <path>', 'path(s) to your env file(s)', collectEnvs('envFile'), [])
+    .option('-fk, --env-keys-file <path>', 'path to your .env.keys file (default: same path as your env file)')
+    .option('-k, --key <keys...>', 'keys(s) to encrypt (default: all keys in file)')
+    .option('-ek, --exclude-key <excludeKeys...>', 'keys(s) to exclude from encryption (default: none)')
+    .option('--stdout', 'send to stdout')
+    .option('--token <token>', 'set Armor ⛨ token')
+    .option('--no-create', 'do not create .env file(s) when missing')
+    .option('--no-armor', 'disable Dotenvx Armor features')
+    .option('--no-native', 'disable OS secret store features')
+    .action(function (...args) {
+      this.envs = envs
+      return require('./actions/encrypt').apply(this, args)
+    })
+}
+configureEncryptCommand(program.command('encrypt'))
+configureEncryptCommand(program.command('enc', { hidden: true })) // shorthand
 
 // dotenvx decrypt
-program.command('decrypt')
-  .description('decrypt .env file(s)')
-  .option('-f, --env-file <path>', 'path(s) to your env file(s)', collectEnvs('envFile'), [])
-  .option('-fk, --env-keys-file <path>', 'path(s) to your .env.keys file(s) (default: same path as your env file)', collectEnvKeys)
-  .option('-k, --key <keys...>', 'keys(s) to decrypt (default: all keys in file)')
-  .option('-ek, --exclude-key <excludeKeys...>', 'keys(s) to exclude from decryption (default: none)')
-  .option('--no-armor', 'disable Dotenvx Armor features')
-  .option('--no-native', 'disable OS secret store features')
-  .option('--stdout', 'send to stdout')
-  .option('--mask [characters]', 'mask stdout values, optionally setting visible characters')
-  .action(function (...args) {
-    this.envs = envs
-    return require('./actions/decrypt').apply(this, args)
-  })
+function configureDecryptCommand (command) {
+  return command
+    .description('decrypt .env file(s)')
+    .option('-f, --env-file <path>', 'path(s) to your env file(s)', collectEnvs('envFile'), [])
+    .option('-fk, --env-keys-file <path>', 'path(s) to your .env.keys file(s) (default: same path as your env file)', collectEnvKeys)
+    .option('-k, --key <keys...>', 'keys(s) to decrypt (default: all keys in file)')
+    .option('-ek, --exclude-key <excludeKeys...>', 'keys(s) to exclude from decryption (default: none)')
+    .option('--no-armor', 'disable Dotenvx Armor features')
+    .option('--no-native', 'disable OS secret store features')
+    .option('--stdout', 'send to stdout')
+    .option('--mask [characters]', 'mask stdout values, optionally setting visible characters')
+    .action(function (...args) {
+      this.envs = envs
+      return require('./actions/decrypt').apply(this, args)
+    })
+}
+configureDecryptCommand(program.command('decrypt'))
+configureDecryptCommand(program.command('dec', { hidden: true })) // shorthand
 
 // dotenvx keypair
 program.command('keypair')

package/src/lib/main.d.ts

@@ -332,6 +332,16 @@ export function set(
 ): Promise<SetOutput>;
 
 export interface GetOptions {
+  /**
+   * Specify a custom path if your file containing environment variables is located elsewhere.
+   * Can also be an array of strings, specifying multiple paths.
+   *
+   * @default require('path').resolve(process.cwd(), '.env')
+   * @example require('@dotenvx/dotenvx').get('KEY', { path: '/custom/path/to/.env' })
+   * @example require('@dotenvx/dotenvx').get('KEY', { path: ['/path/to/first.env', '/path/to/second.env'] })
+   */
+  path?: string | string[] | URL;
+
   /**
    * Mask returned values, optionally setting the number of visible characters.
    * @default false