@dotenvx/dotenvx 1.34.0 → 1.35.0

package/CHANGELOG.md

@@ -2,7 +2,16 @@
 
 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.34.0...main)
+[Unreleased](https://github.com/dotenvx/dotenvx/compare/v1.35.0...main)
+
+## [1.35.0](https://github.com/dotenvx/dotenvx/compare/v1.34.0...v1.35.0)
+
+### Added
+
+* `npx dotenvx precommit` support as a convenience ([#523](https://github.com/dotenvx/dotenvx/pull/523))
+* `main.get` method ([#524](https://github.com/dotenvx/dotenvx/pull/524))
+
+The addition of `main.get` facilitates what we term Decryption at Access, a concept explored in greater detail in our [whitepaper](https://dotenvx.com/dotenvx.pdf).
 
 ## [1.34.0](https://github.com/dotenvx/dotenvx/compare/v1.33.0...v1.34.0)
 

package/README.md

@@ -19,7 +19,7 @@ npm install @dotenvx/dotenvx --save
 ```js
 // index.js
 require('@dotenvx/dotenvx').config()
-// or import('@dotenvx/dotenvx/config') if you're using esm
+// or import '@dotenvx/dotenvx/config' // for esm
 
 console.log(`Hello ${process.env.HELLO}`)
 ```

package/package.json

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

package/src/lib/helpers/installPrecommitHook.js

@@ -3,15 +3,19 @@ const path = require('path')
 
 const HOOK_SCRIPT = `#!/bin/sh
 
-if ! command -v dotenvx 2>&1 >/dev/null
+if command -v dotenvx 2>&1 >/dev/null
 then
+  dotenvx ext precommit
+elif npx dotenvx -V >/dev/null 2>&1
+then
+  npx dotenvx ext precommit
+else
   echo "[dotenvx][precommit] 'dotenvx' command not found"
   echo "[dotenvx][precommit] ? install it with [curl -fsS https://dotenvx.sh | sh]"
   echo "[dotenvx][precommit] ? other install options [https://dotenvx.com/docs/install]"
   exit 1
 fi
-
-dotenvx ext precommit`
+`
 
 class InstallPrecommitHook {
   constructor () {

package/src/lib/main.d.ts

@@ -194,6 +194,13 @@ export interface SetOptions {
    * Set a .env convention (available conventions: 'nextjs')
    */
   convention?: string;
+
+  /**
+   * Specify whether the variable has to be encrypted
+   * @default true
+   * @example require('@dotenvx/dotenvx').config(key, value, { encrypt: false } })
+   */
+  encrypt?: boolean;
 }
 
 export type SetOutput = {

package/src/lib/main.js

@@ -9,6 +9,7 @@ const { getColor, bold } = require('./../shared/colors')
 const Ls = require('./services/ls')
 const Run = require('./services/run')
 const Sets = require('./services/sets')
+const Get = require('./services/get')
 const Keypair = require('./services/keypair')
 const Genexample = require('./services/genexample')
 
@@ -57,7 +58,6 @@ const config = function (options = {}) {
     let lastError
     /** @type {Record<string, string>} */
     const parsedAll = {}
-
     for (const processedEnv of processedEnvs) {
       if (processedEnv.type === 'envVaultFile') {
         logger.verbose(`loading env from encrypted ${processedEnv.filepath} (${path.resolve(processedEnv.filepath)})`)
@@ -234,6 +234,58 @@ const set = function (key, value, options = {}) {
   }
 }
 
+/* @type {import('./main').get} */
+const get = function (key, options = {}) {
+  const envs = buildEnvs(options)
+
+  // ignore
+  const ignore = options.ignore || []
+
+  const { parsed, errors } = new Get(key, envs, options.overload, process.env.DOTENV_KEY, options.all, options.envKeysFile).run()
+
+  for (const error of errors || []) {
+    if (options.strict) throw error // throw immediately if strict
+
+    if (ignore.includes(error.code)) {
+      continue // ignore error
+    }
+
+    console.error(error.message)
+    if (error.help) {
+      console.error(error.help)
+    }
+  }
+
+  if (key) {
+    const single = parsed[key]
+    if (single === undefined) {
+      return undefined
+    } else {
+      return single
+    }
+  } else {
+    if (options.format === 'eval') {
+      let inline = ''
+      for (const [key, value] of Object.entries(parsed)) {
+        inline += `${key}=${escape(value)}\n`
+      }
+      inline = inline.trim()
+
+      return inline
+    } else if (options.format === 'shell') {
+      let inline = ''
+      for (const [key, value] of Object.entries(parsed)) {
+        inline += `${key}=${value} `
+      }
+      inline = inline.trim()
+
+      return inline
+    } else {
+      return parsed
+    }
+  }
+}
+
 /** @type {import('./main').ls} */
 const ls = function (directory, envFile, excludeEnvFile) {
   return new Ls(directory, envFile, excludeEnvFile).run()
@@ -260,6 +312,7 @@ module.exports = {
   parse,
   // actions related
   set,
+  get,
   ls,
   keypair,
   genexample,