@dotenvx/dotenvx-ops 0.38.3 → 0.39.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-ops/compare/v0.38.3...main)
+[Unreleased](https://github.com/dotenvx/dotenvx-ops/compare/v0.39.1...main)
+
+## [0.39.1](https://github.com/dotenvx/dotenvx-ops/compare/v0.39.0...v0.39.1) (2026-04-23)
+
+### Added
+
+* Display install command with update notification ([#54](https://github.com/dotenvx/dotenvx-ops/pull/54))
+
+## [0.39.0](https://github.com/dotenvx/dotenvx-ops/compare/v0.38.3...v0.39.0) (2026-04-23)
+
+### Added
+
+* Added `armor up` and `armor down` placeholders ([#53](https://github.com/dotenvx/dotenvx-ops/pull/53))
 
 ## [0.38.3](https://github.com/dotenvx/dotenvx-ops/compare/v0.38.2...v0.38.3) (2026-04-21)
 

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.38.3",
+  "version": "0.39.1",
   "name": "@dotenvx/dotenvx-ops",
   "description": "Secrets for agents–from the creator of `dotenv` and `dotenvx`",
   "author": "@motdotla",

package/src/cli/actions/armor/down.js

@@ -0,0 +1,17 @@
+const { logger } = require('@dotenvx/dotenvx')
+
+const Session = require('./../../../db/session')
+
+function down () {
+  try {
+    const sesh = new Session()
+    sesh.notifyUpdate()
+
+    logger.success('⛨ coming soon')
+  } catch (error) {
+    logger.error(error.message)
+    process.exit(1)
+  }
+}
+
+module.exports = down

package/src/cli/actions/armor/up.js

@@ -0,0 +1,17 @@
+const { logger } = require('@dotenvx/dotenvx')
+
+const Session = require('./../../../db/session')
+
+function up () {
+  try {
+    const sesh = new Session()
+    sesh.notifyUpdate()
+
+    logger.success('⛨ coming soon')
+  } catch (error) {
+    logger.error(error.message)
+    process.exit(1)
+  }
+}
+
+module.exports = up

package/src/cli/commands/armor.js

@@ -0,0 +1,28 @@
+const { Command } = require('commander')
+const Session = require('./../../db/session')
+
+const armor = new Command('armor')
+
+armor
+  .description('ARMORED KEYS ⛨')
+  .allowUnknownOption()
+  .action(async function () {
+    const sesh = new Session()
+    await sesh.notifyUpdate()
+    this.help()
+  })
+
+// dotenvx-ops armor up
+const upAction = require('./../actions/armor/up')
+armor
+  .command('up')
+  .description('harden private key')
+  .action(upAction)
+
+const downAction = require('./../actions/armor/down')
+armor
+  .command('down')
+  .description('soften private key')
+  .action(downAction)
+
+module.exports = armor

package/src/cli/dotenvx-ops.js

@@ -7,6 +7,7 @@ const program = new Command()
 const { setLogLevel } = require('@dotenvx/dotenvx')
 
 const packageJson = require('./../lib/helpers/packageJson')
+const Session = require('./../db/session')
 const argv = process.argv.slice(2)
 const firstArg = argv[0]
 
@@ -97,6 +98,9 @@ if (shouldLoadRotateCommand) {
   program.addCommand(require('./commands/rotate'))
 }
 
+// dotenvx-ops armor
+program.addCommand(require('./commands/armor'))
+
 // dotenvx-ops login
 const loginAction = require('./actions/login')
 program
@@ -124,7 +128,7 @@ program
 const keypairAction = require('./actions/keypair')
 program
   .command('keypair')
-  .description('generate keypair')
+  .description('generate armored keypair ⛨')
   .argument('[publicKey]', 'existing public key')
   .option('-h, --hostname <url>', 'set hostname')
   .option('--token <token>', 'set token')
@@ -147,4 +151,10 @@ program.helpInformation = function () {
 }
 
 /* c8 ignore stop */
-program.parse(process.argv)
+program.action(async function () {
+  const sesh = new Session()
+  await sesh.notifyUpdate()
+  this.help()
+})
+
+program.parseAsync(process.argv)

package/src/db/session.js

@@ -6,6 +6,7 @@ const { logger } = require('@dotenvx/dotenvx')
 
 const Device = require('./device')
 const jsonToEnv = require('./../lib/helpers/jsonToEnv')
+const likelyUpdateCommand = require('./../lib/helpers/likelyUpdateCommand')
 const packageJson = require('./../lib/helpers/packageJson')
 const GetVersion = require('./../lib/api/getVersion')
 
@@ -85,6 +86,8 @@ class Session {
   //
   async notifyUpdate () {
     try {
+      logger.debug('checking if update available')
+
       const lastCheck = Number(this.store.get('DOTENVX_OPS_VERSION_LAST_CHECK') || 0)
       const now = Date.now()
 
@@ -94,7 +97,10 @@ class Session {
         let remote = local // in case of http fetch error
 
         try {
+          logger.debug('fetching latest available version')
           const VERSION = await new GetVersion().run()
+          logger.debug(`latest version: ${VERSION}`)
+
           remote = VERSION
           this.store.set('DOTENVX_OPS_VERSION', VERSION) // remote version
         } catch (err) {
@@ -106,7 +112,7 @@ class Session {
 
         if (semver.gt(remote, local)) {
           const diff = semver.diff(local, remote)
-          console.error(`⛆ update available (${diff})`)
+          console.error(`⛆ update available (${diff}) [${likelyUpdateCommand()}]`)
         }
       }
     } catch (err) {

package/src/lib/helpers/likelyUpdateCommand.js

@@ -0,0 +1,33 @@
+const normalizePath = require('./normalizePath')
+const safeRealpath = require('./safeRealpath')
+
+const NPM_COMMAND = 'npm i @dotenvx/dotenvx-ops'
+const CURL_COMMAND = 'curl -sfS https://dotenvx.sh/ops | sh'
+
+function likelyUpdateCommand () {
+  const isPackaged = Boolean(process.pkg)
+  const executablePath = isPackaged ? process.execPath : (process.argv[1] || process.execPath)
+  const resolvedExecutablePath = safeRealpath(executablePath)
+  const normalizedPath = normalizePath(resolvedExecutablePath || executablePath || '')
+
+  if (
+    normalizedPath.includes('/node_modules/@dotenvx/dotenvx-ops/') ||
+    normalizedPath.includes('/node_modules/.bin/dotenvx-ops')
+  ) {
+    return NPM_COMMAND
+  }
+
+  if (
+    isPackaged ||
+    normalizedPath.endsWith('/usr/local/bin/dotenvx-ops') ||
+    normalizedPath.endsWith('/opt/homebrew/bin/dotenvx-ops') ||
+    normalizedPath.endsWith('/usr/bin/dotenvx-ops') ||
+    normalizedPath.endsWith('/bin/dotenvx-ops')
+  ) {
+    return CURL_COMMAND
+  }
+
+  return NPM_COMMAND
+}
+
+module.exports = likelyUpdateCommand

package/src/lib/helpers/normalizePath.js

@@ -0,0 +1,5 @@
+function normalizePath (value) {
+  return String(value || '').replace(/\\/g, '/').toLowerCase()
+}
+
+module.exports = normalizePath

package/src/lib/helpers/safeRealpath.js

@@ -0,0 +1,13 @@
+const fs = require('fs')
+
+function safeRealpath (filePath) {
+  if (!filePath) return filePath
+
+  try {
+    return fs.realpathSync(filePath)
+  } catch (e) {
+    return filePath
+  }
+}
+
+module.exports = safeRealpath