@dotenvx/dotenvx 1.34.0 → 1.36.0

package/CHANGELOG.md

@@ -2,7 +2,22 @@
 
 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.36.0...main)
+
+## [1.36.0](https://github.com/dotenvx/dotenvx/compare/v1.35.0...v1.36.0)
+
+### Changed
+
+* `--strict` flag respects (doesn't throw) anything in `--ignore` flag ([#527](https://github.com/dotenvx/dotenvx/pull/527))
+
+## [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

@@ -6,6 +6,8 @@
 * multi-environment
 * encrypted envs
 
+[Read the whitepaper](https://dotenvx.com/dotenvx.pdf)
+
  
 
 
@@ -19,7 +21,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}`)
 ```
@@ -524,6 +526,8 @@ More examples
   Hello local
   ```
 
+  Note subsequent files do NOT override pre-existing variables defined in previous files or env. This follows historic principle. For example, above `local` wins – from the first file.
+
   </details>
 
 * <details><summary>`--overload` flag</summary><br>
@@ -538,6 +542,8 @@ More examples
   Hello World
   ```
 
+  Note that with `--overload` subsequent files DO override pre-existing variables defined in previous files.
+
 * <details><summary>`--verbose` flag</summary><br>
 
   ```sh
@@ -798,6 +804,8 @@ More examples
   Hello local
   ```
 
+  Note subsequent files do NOT override pre-existing variables defined in previous files or env. This follows historic principle. For example, above `local` wins – from the first file.
+
   </details>
 * <details><summary>`run --env HELLO=String`</summary><br>
 
@@ -827,6 +835,8 @@ More examples
   Hello World
   ```
 
+  Note that with `--overload` subsequent files DO override pre-existing variables defined in previous files.
+
   </details>
 * <details><summary>`DOTENV_PRIVATE_KEY=key run`</summary><br>
   

package/package.json

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

package/src/cli/actions/run.js

@@ -62,13 +62,13 @@ async function run () {
       }
 
       for (const error of processedEnv.errors || []) {
-        if (options.strict) throw error // throw immediately if strict
-
         if (ignore.includes(error.code)) {
           logger.verbose(`ignored: ${error.message}`)
           continue // ignore error
         }
 
+        if (options.strict) throw error // throw if strict and not ignored
+
         if (error.code === 'MISSING_ENV_FILE') {
           if (!options.convention) { // do not output error for conventions (too noisy)
             console.error(error.message)

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)})`)
@@ -69,12 +69,13 @@ const config = function (options = {}) {
       }
 
       for (const error of processedEnv.errors || []) {
-        if (strict) throw error // throw immediately if strict
-
         if (ignore.includes(error.code)) {
+          logger.verbose(`ignored: ${error.message}`)
           continue // ignore error
         }
 
+        if (strict) throw error // throw if strict and not ignored
+
         lastError = error // surface later in { error }
 
         if (error.code === 'MISSING_ENV_FILE') {
@@ -234,6 +235,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 (ignore.includes(error.code)) {
+      continue // ignore error
+    }
+
+    if (options.strict) throw error // throw immediately if strict
+
+    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 +313,7 @@ module.exports = {
   parse,
   // actions related
   set,
+  get,
   ls,
   keypair,
   genexample,