netlify-cli 10.16.0 → 10.17.0

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "netlify-cli",
-  "version": "10.16.0",
+  "version": "10.17.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "netlify-cli",
-      "version": "10.16.0",
+      "version": "10.17.0",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {
@@ -15,7 +15,7 @@
         "@netlify/edge-bundler": "^1.12.1",
         "@netlify/framework-info": "^9.2.0",
         "@netlify/local-functions-proxy": "^1.1.1",
-        "@netlify/plugins-list": "^6.37.0",
+        "@netlify/plugins-list": "^6.38.0",
         "@netlify/zip-it-and-ship-it": "^5.13.4",
         "@octokit/rest": "^18.0.0",
         "@sindresorhus/slugify": "^1.1.0",
@@ -81,7 +81,7 @@
         "multiparty": "^4.2.1",
         "netlify": "^12.0.0",
         "netlify-headers-parser": "^6.0.2",
-        "netlify-onegraph-internal": "0.8.1",
+        "netlify-onegraph-internal": "0.8.3",
         "netlify-redirect-parser": "^13.0.5",
         "netlify-redirector": "^0.2.1",
         "node-fetch": "^2.6.0",
@@ -3890,9 +3890,9 @@
       "integrity": "sha512-ni6R1xdR8EtH0iB8ixGt9ocuboW+Q8eN4ilTX8lfNHS6Y6Q2S+O/aB2n1BnAgv39wopeQsQ2meL9vfEePURl7w=="
     },
     "node_modules/@netlify/plugins-list": {
-      "version": "6.37.0",
-      "resolved": "https://registry.npmjs.org/@netlify/plugins-list/-/plugins-list-6.37.0.tgz",
-      "integrity": "sha512-sThBWfyHQ0TEVjUCPlzrt0tTjA6MVIydE718Hqb7jR8x51nSkOrWgIQmaQaJWZsGErRPX2hW501Ajdh0eIW6Bw==",
+      "version": "6.38.0",
+      "resolved": "https://registry.npmjs.org/@netlify/plugins-list/-/plugins-list-6.38.0.tgz",
+      "integrity": "sha512-fa6BfTCFF3gU2ygS4i175P2Zez8FKXgxKWtjdJPm8eh4UhJ0flIHdooTLZWTpBDL5YiDizk2cviPvOL8fQS93w==",
       "engines": {
         "node": "^12.20.0 || ^14.14.0 || >=16.0.0"
       }
@@ -16319,9 +16319,9 @@
       }
     },
     "node_modules/netlify-onegraph-internal": {
-      "version": "0.8.1",
-      "resolved": "https://registry.npmjs.org/netlify-onegraph-internal/-/netlify-onegraph-internal-0.8.1.tgz",
-      "integrity": "sha512-gCBwR6wOLWiiE+MMgYtx7OVIUvsNGPPP8oe0ltkYjCATcN/e/l0/z/FrRaTGPXnR8wMBp9Kibgibskr8h5dIpg==",
+      "version": "0.8.3",
+      "resolved": "https://registry.npmjs.org/netlify-onegraph-internal/-/netlify-onegraph-internal-0.8.3.tgz",
+      "integrity": "sha512-qxdUkP6IcXUN/6FmYrfLM+M1pXK5TUTxkhhVKXHr+jpApFV4pmEsiuWU7jX4j4AqpaF7+glVJolyVD5F3SBpvg==",
       "dependencies": {
         "graphql": "16.5.0",
         "node-fetch": "^2.6.0",
@@ -25319,9 +25319,9 @@
       "integrity": "sha512-ni6R1xdR8EtH0iB8ixGt9ocuboW+Q8eN4ilTX8lfNHS6Y6Q2S+O/aB2n1BnAgv39wopeQsQ2meL9vfEePURl7w=="
     },
     "@netlify/plugins-list": {
-      "version": "6.37.0",
-      "resolved": "https://registry.npmjs.org/@netlify/plugins-list/-/plugins-list-6.37.0.tgz",
-      "integrity": "sha512-sThBWfyHQ0TEVjUCPlzrt0tTjA6MVIydE718Hqb7jR8x51nSkOrWgIQmaQaJWZsGErRPX2hW501Ajdh0eIW6Bw=="
+      "version": "6.38.0",
+      "resolved": "https://registry.npmjs.org/@netlify/plugins-list/-/plugins-list-6.38.0.tgz",
+      "integrity": "sha512-fa6BfTCFF3gU2ygS4i175P2Zez8FKXgxKWtjdJPm8eh4UhJ0flIHdooTLZWTpBDL5YiDizk2cviPvOL8fQS93w=="
     },
     "@netlify/run-utils": {
       "version": "4.0.1",
@@ -34795,9 +34795,9 @@
       }
     },
     "netlify-onegraph-internal": {
-      "version": "0.8.1",
-      "resolved": "https://registry.npmjs.org/netlify-onegraph-internal/-/netlify-onegraph-internal-0.8.1.tgz",
-      "integrity": "sha512-gCBwR6wOLWiiE+MMgYtx7OVIUvsNGPPP8oe0ltkYjCATcN/e/l0/z/FrRaTGPXnR8wMBp9Kibgibskr8h5dIpg==",
+      "version": "0.8.3",
+      "resolved": "https://registry.npmjs.org/netlify-onegraph-internal/-/netlify-onegraph-internal-0.8.3.tgz",
+      "integrity": "sha512-qxdUkP6IcXUN/6FmYrfLM+M1pXK5TUTxkhhVKXHr+jpApFV4pmEsiuWU7jX4j4AqpaF7+glVJolyVD5F3SBpvg==",
       "requires": {
         "graphql": "16.5.0",
         "node-fetch": "^2.6.0",

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "netlify-cli",
   "description": "Netlify command line tool",
-  "version": "10.16.0",
+  "version": "10.17.0",
   "author": "Netlify Inc.",
   "contributors": [
+    "@whitep4nth3r (https://twitter.com/whitep4nth3r)",
     "Abraham Schilling <AbrahamSchilling@gmail.com> (https://gitlab.com/n4bb12)",
     "Alberto De Agostini (https://twitter.com/albertodeago88)",
     "Alejandro Ñáñez Ortiz <git@alejandro.dev> (https://twitter.com/alejandronanez)",
@@ -225,7 +226,7 @@
     "@netlify/edge-bundler": "^1.12.1",
     "@netlify/framework-info": "^9.2.0",
     "@netlify/local-functions-proxy": "^1.1.1",
-    "@netlify/plugins-list": "^6.37.0",
+    "@netlify/plugins-list": "^6.38.0",
     "@netlify/zip-it-and-ship-it": "^5.13.4",
     "@octokit/rest": "^18.0.0",
     "@sindresorhus/slugify": "^1.1.0",
@@ -291,7 +292,7 @@
     "multiparty": "^4.2.1",
     "netlify": "^12.0.0",
     "netlify-headers-parser": "^6.0.2",
-    "netlify-onegraph-internal": "0.8.1",
+    "netlify-onegraph-internal": "0.8.3",
     "netlify-redirect-parser": "^13.0.5",
     "netlify-redirector": "^0.2.1",
     "node-fetch": "^2.6.0",

package/src/commands/dev/dev.js

@@ -38,6 +38,7 @@ const {
   error,
   exit,
   generateNetlifyGraphJWT,
+  getEnvelopeEnv,
   getSiteInformation,
   getToken,
   injectEnvVariables,
@@ -428,7 +429,12 @@ const dev = async (options, command) => {
     ...options,
   }
 
-  await injectEnvVariables({ devConfig, env: command.netlify.cachedConfig.env, site })
+  let { env } = command.netlify.cachedConfig
+  if (siteInfo.use_envelope) {
+    env = await getEnvelopeEnv({ api, context: options.context, env, siteInfo })
+  }
+
+  await injectEnvVariables({ devConfig, env, site })
   await promptEditorHelper({ chalk, config, log, NETLIFYDEVLOG, repositoryRoot, state })
 
   const { addonsUrls, capabilities, siteUrl, timeouts } = await getSiteInformation({
@@ -621,6 +627,11 @@ const createDevCommand = (program) => {
       `Local dev server\nThe dev command will run a local dev server with Netlify's proxy and redirect rules`,
     )
     .option('-c ,--command <command>', 'command to run')
+    .addOption(
+      new Option('--context <context>', 'Specify a deploy context for environment variables')
+        .choices(['production', 'deploy-preview', 'branch-deploy', 'dev'])
+        .default('dev'),
+    )
     .option('-p ,--port <port>', 'port of netlify dev', (value) => Number.parseInt(value))
     .option('--targetPort <port>', 'port of target app server', (value) => Number.parseInt(value))
     .option('--framework <name>', 'framework to use. Defaults to #auto which automatically detects a framework')
@@ -670,6 +681,7 @@ const createDevCommand = (program) => {
       'netlify dev',
       'netlify dev -d public',
       'netlify dev -c "hugo server -w" --targetPort 1313',
+      'netlify dev --context production',
       'netlify dev --graph',
       'netlify dev --edgeInspect',
       'netlify dev --edgeInspect=127.0.0.1:9229',

package/src/commands/env/env-get.js

@@ -1,5 +1,7 @@
 // @ts-check
-const { log, logJson } = require('../../utils')
+const { Option } = require('commander')
+
+const { chalk, error, getEnvelopeEnv, log, logJson } = require('../../utils')
 
 /**
  * The env:get command
@@ -8,6 +10,7 @@ const { log, logJson } = require('../../utils')
  * @param {import('../base-command').BaseCommand} command
  */
 const envGet = async (name, options, command) => {
+  const { context, scope } = options
   const { api, cachedConfig, site } = command.netlify
   const siteId = site.id
 
@@ -16,9 +19,21 @@ const envGet = async (name, options, command) => {
     return false
   }
 
-  const siteData = await api.getSite({ siteId })
+  const { siteInfo } = cachedConfig
+  let { env } = cachedConfig
+
+  if (siteInfo.use_envelope) {
+    env = await getEnvelopeEnv({ api, context, env, key: name, scope, siteInfo })
+  } else if (context !== 'dev' || scope !== 'any') {
+    error(
+      `To specify a context or scope, please run ${chalk.yellowBright(
+        'netlify open:admin',
+      )} to open the Netlify UI and opt in to the new environment variables experience from Site settings`,
+    )
+    return false
+  }
 
-  const { value } = cachedConfig.env[name] || {}
+  const { value } = env[name] || {}
 
   // Return json response for piping commands
   if (options.json) {
@@ -27,7 +42,9 @@ const envGet = async (name, options, command) => {
   }
 
   if (!value) {
-    log(`Environment variable ${name} not set for site ${siteData.name}`)
+    const withContext = `in the ${chalk.magentaBright(context)} context`
+    const withScope = scope === 'any' ? '' : ` in the ${chalk.magentaBright(context)} scope`
+    log(`No value set ${withContext}${withScope} for environment variable ${chalk.yellowBright(name)}`)
     return false
   }
 
@@ -43,6 +60,16 @@ const createEnvGetCommand = (program) =>
   program
     .command('env:get')
     .argument('<name>', 'Environment variable name')
+    .addOption(
+      new Option('-c, --context <context>', 'Specify a deploy context')
+        .choices(['production', 'deploy-preview', 'branch-deploy', 'dev'])
+        .default('dev'),
+    )
+    .addOption(
+      new Option('-s, --scope <scope>', 'Specify a scope')
+        .choices(['builds', 'functions', 'post_processing', 'runtime', 'any'])
+        .default('any'),
+    )
     .description('Get resolved value of specified environment variable (includes netlify.toml)')
     .action(async (name, options, command) => {
       await envGet(name, options, command)

package/src/commands/env/env-list.js

@@ -1,20 +1,33 @@
 // @ts-check
 const AsciiTable = require('ascii-table')
 const { isCI } = require('ci-info')
+const { Option } = require('commander')
 const inquirer = require('inquirer')
 const isEmpty = require('lodash/isEmpty')
 
-const { chalk, log, logJson } = require('../../utils')
+const { chalk, error, getEnvelopeEnv, getHumanReadableScopes, log, logJson } = require('../../utils')
 
 const [logUpdatePromise, ansiEscapesPromise] = [import('log-update'), import('ansi-escapes')]
 
 const MASK_LENGTH = 50
 const MASK = '*'.repeat(MASK_LENGTH)
 
-const getTable = ({ environment, hideValues }) => {
+const getTable = ({ environment, hideValues, scopesColumn }) => {
   const table = new AsciiTable(`Environment variables`)
-  table.setHeading('Key', 'Value')
-  table.addRowMatrix(Object.entries(environment).map(([key, value]) => [key, hideValues ? MASK : value]))
+  const headings = ['Key', 'Value', scopesColumn && 'Scope'].filter(Boolean)
+  table.setHeading(...headings)
+  table.addRowMatrix(
+    Object.entries(environment).map(([key, variable]) =>
+      [
+        // Key
+        key,
+        // Value
+        hideValues ? MASK : variable.value,
+        // Scope
+        scopesColumn && getHumanReadableScopes(variable.scopes),
+      ].filter(Boolean),
+    ),
+  )
   return table.toString()
 }
 
@@ -25,6 +38,7 @@ const getTable = ({ environment, hideValues }) => {
  * @returns {Promise<boolean>}
  */
 const envList = async (options, command) => {
+  const { context, scope } = options
   const { api, cachedConfig, site } = command.netlify
   const siteId = site.id
 
@@ -33,36 +47,55 @@ const envList = async (options, command) => {
     return false
   }
 
-  const siteData = await api.getSite({ siteId })
-  const environment = Object.fromEntries(
-    Object.entries(cachedConfig.env)
-      // Omitting general variables to reduce noise.
-      .filter(([, variable]) => variable.sources[0] !== 'general')
-      .map(([key, variable]) => [key, variable.value]),
+  const { env, siteInfo } = cachedConfig
+  const isUsingEnvelope = siteInfo.use_envelope
+  let environment = env
+
+  if (isUsingEnvelope) {
+    environment = await getEnvelopeEnv({ api, context, env, scope, siteInfo })
+  } else if (context !== 'dev' || scope !== 'any') {
+    error(
+      `To specify a context or scope, please run ${chalk.yellowBright(
+        'netlify open:admin',
+      )} to open the Netlify UI and opt in to the new environment variables experience from Site settings`,
+    )
+    return false
+  }
+
+  // filter out general sources
+  environment = Object.fromEntries(
+    Object.entries(environment).filter(([, variable]) => variable.sources[0] !== 'general'),
   )
 
   // Return json response for piping commands
   if (options.json) {
-    logJson(environment)
+    const envDictionary = Object.fromEntries(
+      Object.entries(environment).map(([key, variable]) => [key, variable.value]),
+    )
+    logJson(envDictionary)
     return false
   }
 
+  const forSite = `for site ${chalk.greenBright(siteInfo.name)}`
+  const withContext = isUsingEnvelope ? `in the ${chalk.magentaBright(options.context)} context` : ''
+  const withScope = isUsingEnvelope && scope !== 'any' ? `and ${chalk.yellowBright(options.scope)} scope` : ''
   if (isEmpty(environment)) {
-    log(`No environment variables set for site ${chalk.greenBright(siteData.name)}`)
+    log(`No environment variables set ${forSite} ${withContext} ${withScope}`)
     return false
   }
 
   // List environment in a table
-  log(`Listing environment variables for site: ${chalk.greenBright(siteData.name)}`)
+  const count = Object.keys(environment).length
+  log(`${count} environment variable${count === 1 ? '' : 's'} ${forSite} ${withContext} ${withScope}`)
 
   if (isCI) {
-    log(getTable({ environment, hideValues: false }))
+    log(getTable({ environment, hideValues: false, scopesColumn: isUsingEnvelope }))
     return false
   }
 
   const { default: logUpdate } = await logUpdatePromise
 
-  logUpdate(getTable({ environment, hideValues: true }))
+  logUpdate(getTable({ environment, hideValues: true, scopesColumn: isUsingEnvelope }))
   const { showValues } = await inquirer.prompt([
     {
       type: 'confirm',
@@ -76,7 +109,7 @@ const envList = async (options, command) => {
     const { default: ansiEscapes } = await ansiEscapesPromise
     // since inquirer adds a prompt, we need to account for it when printing the table again
     log(ansiEscapes.eraseLines(3))
-    logUpdate(getTable({ environment, hideValues: false }))
+    logUpdate(getTable({ environment, hideValues: false, scopesColumn: isUsingEnvelope }))
     log(`${chalk.cyan('?')} Show values? ${chalk.cyan('Yes')}`)
   }
 }
@@ -89,6 +122,16 @@ const envList = async (options, command) => {
 const createEnvListCommand = (program) =>
   program
     .command('env:list')
+    .addOption(
+      new Option('-c, --context <context>', 'Specify a deploy context')
+        .choices(['production', 'deploy-preview', 'branch-deploy', 'dev'])
+        .default('dev'),
+    )
+    .addOption(
+      new Option('-s, --scope <scope>', 'Specify a scope')
+        .choices(['builds', 'functions', 'post_processing', 'runtime', 'any'])
+        .default('any'),
+    )
     .description('Lists resolved environment variables for site (includes netlify.toml)')
     .action(async (options, command) => {
       await envList(options, command)

package/src/commands/init/init.js

@@ -57,7 +57,7 @@ const logGitSetupInstructionsAndExit = () => {
 
    ${chalk.cyanBright.bold('git init')}
 
-2. Commit your files
+2. Add your files
 
    ${chalk.cyanBright.bold('git add .')}
 

package/src/utils/dev.js

@@ -14,7 +14,7 @@ const { loadDotEnvFiles } = require('./dot-env')
 // Possible sources of environment variables. For the purpose of printing log messages only. Order does not matter.
 const ENV_VAR_SOURCES = {
   account: {
-    name: 'shared build settings',
+    name: 'shared',
     printFn: chalk.magenta,
   },
   addons: {
@@ -34,7 +34,7 @@ const ENV_VAR_SOURCES = {
     printFn: chalk.red,
   },
   ui: {
-    name: 'build settings',
+    name: 'site settings',
     printFn: chalk.blue,
   },
 }

package/src/utils/env/index.js

@@ -1,3 +1,153 @@
+/**
+ * Finds a matching environment variable value from a given context
+ * @param {Array<object>} values - An array of environment variable values from Envelope
+ * @param {enum<dev,branch-deploy,deploy-preview,production>} context - The deploy context of the environment variable value
+ * @returns {object<context: enum<dev,branch-deploy,deploy-preview,production>, value: string>} The matching environment variable value object
+ */
+const findValueFromContext = (values, context) => values.find((val) => [context, 'all'].includes(val.context))
+
+/**
+ * Finds environment variables that match a given source
+ * @param {object} env - The dictionary of environment variables
+ * @param {enum<general,account,addons,ui,configFile>} source - The source of the environment variable
+ * @returns {object} The dictionary of env vars that match the given source
+ */
+const filterEnvBySource = (env, source) =>
+  Object.fromEntries(Object.entries(env).filter(([, variable]) => variable.sources[0] === source))
+
+/**
+ * Fetches data from Envelope
+ * @param {string} accountId - The account id
+ * @param {object} api - The api singleton object
+ * @param {string} key - If present, fetch a single key (case-sensitive)
+ * @param {string} siteId - The site id
+ * @returns {Array<object>} An array of environment variables from the Envelope service
+ */
+const fetchEnvelopeItems = async function ({ accountId, api, key, siteId }) {
+  if (accountId === undefined) {
+    return {}
+  }
+  try {
+    // if a single key is passed, fetch that single env var
+    if (key) {
+      const envelopeItem = await api.getEnvVar({ accountId, key, siteId })
+      return [envelopeItem]
+    }
+    // otherwise, fetch the entire list of env vars
+    const envelopeItems = await api.getEnvVars({ accountId, siteId })
+    return envelopeItems
+  } catch {
+    // Collaborators aren't allowed to read shared env vars,
+    // so return an empty array silently in that case
+    return []
+  }
+}
+
+/**
+ * Filters and sorts data from Envelope by a given context and/or scope
+ * @param {enum<dev,branch-deploy,deploy-preview,production>} context - The deploy context of the environment variable value
+ * @param {Array<object>} envelopeItems - An array of environment variables from the Envelope service
+ * @param {enum<any,builds,functions,runtime,post_processing>} scope - The scope of the environment variables
+ * @param {enum<general,account,addons,ui,configFile>} source - The source of the environment variable
+ * @returns {object} A dicionary in the following format:
+ * {
+ *   FOO: {
+ *     context: 'dev',
+ *     scopes: ['builds', 'functions'],
+ *     sources: ['ui'],
+ *     value: 'bar',
+ *   },
+ *   BAZ: {
+ *     context: 'dev',
+ *     scopes: ['runtime'],
+ *     sources: ['account'],
+ *     value: 'bang',
+ *   },
+ * }
+ */
+const formatEnvelopeData = ({ context = 'dev', envelopeItems = [], scope = 'any', source }) =>
+  envelopeItems
+    // filter by context
+    .filter(({ values }) => Boolean(findValueFromContext(values, context)))
+    // filter by scope
+    .filter(({ scopes }) => (scope === 'any' ? true : scopes.includes(scope)))
+    // sort alphabetically, case insensitive
+    .sort((left, right) => (left.key.toLowerCase() < right.key.toLowerCase() ? -1 : 1))
+    // format the data
+    .reduce((acc, cur) => {
+      const { context: ctx, value } = findValueFromContext(cur.values, context)
+      return {
+        ...acc,
+        [cur.key]: {
+          context: ctx,
+          scopes: cur.scopes,
+          sources: [source],
+          value,
+        },
+      }
+    }, {})
+
+/**
+ * Collects env vars from multiple sources and arranges them in the correct order of precedence
+ * @param {object} api - The api singleton object
+ * @param {enum<dev,branch-deploy,deploy-preview,production>} context - The deploy context of the environment variable
+ * @param {object} env - The dictionary of environment variables
+ * @param {string} key - If present, fetch a single key (case-sensitive)
+ * @param {enum<any,builds,functions,runtime,post_processing>} scope - The scope of the environment variables
+ * @param {object} siteInfo - The site object
+ * @returns {object} An object of environment variables keys and their metadata
+ */
+const getEnvelopeEnv = async ({ api, context = 'dev', env, key = '', scope = 'any', siteInfo }) => {
+  const { account_slug: accountId, id: siteId } = siteInfo
+
+  const [accountEnvelopeItems, siteEnvelopeItems] = await Promise.all([
+    fetchEnvelopeItems({ api, accountId, key }),
+    fetchEnvelopeItems({ api, accountId, key, siteId }),
+  ])
+
+  const accountEnv = formatEnvelopeData({ context, envelopeItems: accountEnvelopeItems, scope, source: 'account' })
+  const siteEnv = formatEnvelopeData({ context, envelopeItems: siteEnvelopeItems, scope, source: 'ui' })
+  const generalEnv = filterEnvBySource(env, 'general')
+  const addonsEnv = filterEnvBySource(env, 'addons')
+  const configFileEnv = filterEnvBySource(env, 'configFile')
+
+  // filter out configFile env vars if a non-configFile scope is passed
+  const includeConfigEnvVars = ['any', 'builds', 'post_processing'].includes(scope)
+
+  // Sources of environment variables, in ascending order of precedence.
+  return {
+    ...generalEnv,
+    ...accountEnv,
+    ...(includeConfigEnvVars ? addonsEnv : {}),
+    ...siteEnv,
+    ...(includeConfigEnvVars ? configFileEnv : {}),
+  }
+}
+
+/**
+ * Returns a human-readable, comma-separated list of scopes
+ * @param {Array<enum<builds,functions,runtime,post_processing>>} scopes - An array of scopes
+ * @returns {string} A human-readable, comma-separated list of scopes
+ */
+const getHumanReadableScopes = (scopes) => {
+  const AVAILABLE_SCOPES = {
+    builds: 'Builds',
+    functions: 'Functions',
+    post_processing: 'Post processing',
+    runtime: 'Runtime',
+  }
+  if (!scopes) {
+    // if `scopes` is not available, the env var comes from netlify.toml
+    // env vars specified in netlify.toml are present in the `builds` and `post_processing` scope
+    return 'Builds, Post processing'
+  }
+  if (scopes.length === Object.keys(AVAILABLE_SCOPES).length) {
+    // shorthand instead of listing every available scope
+    return 'All'
+  }
+  return scopes.map((scope) => AVAILABLE_SCOPES[scope]).join(', ')
+}
+
 /**
  * Translates a Mongo env into an Envelope env
  * @param {object} env - The site's env as it exists in Mongo
@@ -38,6 +188,11 @@ const translateFromEnvelopeToMongo = (envVars = []) =>
     }, {})
 
 module.exports = {
-  translateFromMongoToEnvelope,
+  findValueFromContext,
+  filterEnvBySource,
+  formatEnvelopeData,
+  getEnvelopeEnv,
+  getHumanReadableScopes,
   translateFromEnvelopeToMongo,
+  translateFromMongoToEnvelope,
 }