@dotenvx/dotenvx-ops 0.27.0 → 0.28.0

package/CHANGELOG.md

@@ -2,7 +2,13 @@
 
 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.27.0...main)
+[Unreleased](https://github.com/dotenvx/dotenvx-ops/compare/v0.28.0...main)
+
+## [0.28.0](https://github.com/dotenvx/dotenvx-ops/compare/v0.27.0...v0.28.0) (2025-12-22)
+
+### Added
+
+* Add `backup` command for backing up .env.keys files. Will serve as entry-level low priced product to serve many. ([#18](https://github.com/dotenvx/dotenvx-ops/pull/18))
 
 ## [0.27.0](https://github.com/dotenvx/dotenvx-ops/compare/v0.26.0...v0.27.0) (2025-12-14)
 

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.27.0",
+  "version": "0.28.0",
   "name": "@dotenvx/dotenvx-ops",
   "description": "Dotenvx Ops – commercial tooling for .env files",
   "author": "@motdotla",

package/src/cli/actions/backup.js

@@ -0,0 +1,53 @@
+// const fs = require('fs')
+// const crypto = require('crypto')
+
+const { logger } = require('@dotenvx/dotenvx')
+
+const { createSpinner } = require('./../../lib/helpers/createSpinner')
+
+const Backup = require('./../../lib/services/backup')
+
+const spinner = createSpinner('backing up')
+
+async function backup () {
+  // debug opts
+  const options = this.opts()
+
+  try {
+    logger.debug(`options: ${JSON.stringify(options)}`)
+
+    spinner.start()
+
+    const {
+      projectUsernameName,
+      files
+    } = await new Backup(options.hostname, options.force).run()
+    logger.debug(`files: ${JSON.stringify(files)}`)
+
+    // write output files
+    // for (const file of files) {
+    //   // const { filepath, src, sha } = file
+    // }
+
+    spinner.stop()
+
+    logger.success(`✔ backed up [${projectUsernameName}]`)
+  } catch (error) {
+    spinner.stop()
+    if (error.message) {
+      logger.error(error.message)
+    } else {
+      logger.error(error)
+    }
+    if (error.help) {
+      logger.help(error.help)
+    }
+    if (error.stack) {
+      logger.debug(error.stack)
+    }
+
+    process.exit(1)
+  }
+}
+
+module.exports = backup

package/src/cli/dotenvx-ops.js

@@ -30,6 +30,14 @@ program
   .version(packageJson.version)
   .allowUnknownOption()
 
+// dotenvx-ops backup
+const backupAction = require('./actions/backup')
+program
+  .command('backup')
+  .description('backup .env.keys file(s)')
+  .option('-h, --hostname <url>', 'set hostname', sesh.hostname())
+  .action(backupAction)
+
 // dotenvx-ops observe base64String
 const observeAction = require('./actions/observe')
 program.command('observe')

package/src/lib/api/postBackup.js

@@ -0,0 +1,65 @@
+const { http } = require('../../lib/helpers/http')
+const buildApiError = require('../../lib/helpers/buildApiError')
+const packageJson = require('../../lib/helpers/packageJson')
+
+class PostBackup {
+  constructor (hostname, token, devicePublicKey, encoded, dotenvxProjectId, pwd = null, gitUrl = null, gitBranch = null, systemUuid = null, osPlatform = null, osArch = null) {
+    this.hostname = hostname || 'https://ops.dotenvx.com'
+    this.token = token
+    this.devicePublicKey = devicePublicKey
+    this.encoded = encoded
+    this.dotenvxProjectId = dotenvxProjectId
+    this.pwd = pwd
+    this.gitUrl = gitUrl
+    this.gitBranch = gitBranch
+    this.systemUuid = systemUuid
+    this.osPlatform = osPlatform
+    this.osArch = osArch
+  }
+
+  async run () {
+    const token = this.token
+    const devicePublicKey = this.devicePublicKey
+    const url = `${this.hostname}/api/backup`
+    const encoded = this.encoded
+    const dotenvxProjectId = this.dotenvxProjectId
+    const backedupAt = new Date().toISOString()
+    const pwd = this.pwd
+    const gitUrl = this.gitUrl
+    const gitBranch = this.gitBranch
+    const systemUuid = this.systemUuid
+    const osPlatform = this.osPlatform
+    const osArch = this.osArch
+
+    const resp = await http(url, {
+      method: 'POST',
+      headers: {
+        Authorization: `Bearer ${token}`,
+        'Content-Type': 'application/json'
+      },
+      body: JSON.stringify({
+        device_public_key: devicePublicKey,
+        encoded,
+        dotenvx_project_id: dotenvxProjectId,
+        backedup_at: backedupAt,
+        pwd,
+        git_url: gitUrl,
+        git_branch: gitBranch,
+        system_uuid: systemUuid,
+        os_platform: osPlatform,
+        os_arch: osArch,
+        cli_version: packageJson.version
+      })
+    })
+
+    const json = await resp.body.json()
+
+    if (resp.statusCode >= 400) {
+      throw buildApiError(resp.statusCode, json)
+    }
+
+    return json
+  }
+}
+
+module.exports = PostBackup

package/src/lib/services/backup.js

@@ -0,0 +1,68 @@
+const fs = require('fs')
+const path = require('path')
+const si = require('systeminformation')
+const dotenvx = require('@dotenvx/dotenvx')
+
+const Session = require('./../../db/session')
+
+const gitUrl = require('./../helpers/gitUrl')
+const gitBranch = require('./../helpers/gitBranch')
+const dotenvxProjectId = require('./../helpers/dotenvxProjectId')
+
+// api calls
+const PostBackup = require('./../api/postBackup')
+
+class Backup {
+  constructor (hostname) {
+    this.hostname = hostname
+    this.cwd = process.cwd()
+  }
+
+  async run () {
+    const sesh = new Session()
+    const token = sesh.token()
+    const devicePublicKey = sesh.devicePublicKey()
+
+    // required
+    const files = this._files()
+    const payload = { files }
+    const encoded = Buffer.from(JSON.stringify(payload)).toString('base64')
+    const _dotenvxProjectId = dotenvxProjectId(this.cwd)
+
+    // optional
+    const _pwd = this.cwd
+    const _gitUrl = gitUrl()
+    const _gitBranch = gitBranch()
+
+    const system = await si.system()
+    const _systemUuid = system.uuid
+
+    const osInfo = await si.osInfo()
+    const _osPlatform = osInfo.platform
+    const _osArch = osInfo.arch
+
+    const data = await new PostBackup(this.hostname, token, devicePublicKey, encoded, _dotenvxProjectId, _pwd, _gitUrl, _gitBranch, _systemUuid, _osPlatform, _osArch).run()
+
+    return {
+      id: data.id,
+      dotenvxProjectId: data.dotenvx_project_id,
+      projectUsernameName: data.project_username_name,
+      files: data.files
+    }
+  }
+
+  _files () {
+    const out = []
+    const filepaths = dotenvx.ls(this.cwd, '.env.keys*')
+
+    for (const fp of filepaths) {
+      const abs = path.join(this.cwd, fp)
+      const src = fs.readFileSync(abs, 'utf8')
+      out.push({ filepath: fp, src })
+    }
+
+    return out
+  }
+}
+
+module.exports = Backup