@halospv3/hce.shared-config/mjs/utils/env.mjs

Automate commit message quality, changelogs, and CI/CD releases. Exports a semantic-release shareable configuration deserialized from this package's '.releaserc.yml'. Shared resources for .NET projects are also distributed with this package.

import { config, get } from '@dotenvx/dotenvx';
import { env } from 'node:process';

/** `get` can return `undefined`. It can also return a `Record`, but that's internal. */

/**
 * A thin wrapper for {@link loadDotenv}. Loads a .env file from {@link process.cwd()} with the given options (or defaults), returns the new value of {@link process.env} with optional overrides.
 * @param [dotenvOptions] An optional {@link DotenvConfigOptions} object to pass to {@link loadDotenv}.
 * @param [overrides] If provided, this {@link NodeJS.ProcessEnv} object is merged into the return value, overriding existing properties where overlap occurs.
 * @returns A {@link NodeJS.ProcessEnv} object whose properties are variables loaded from the
 * process environment, the nearest .env file, and {@link overrides} (if provided). Where
 * overlap occurs, the later source takes priority.
 */
function getEnv(dotenvOptions, overrides) {
  config(dotenvOptions);
  if (overrides) Object.assign(env, overrides);
  return env;
}

/**
 * Get the value from the given env var in the current process or nearby .env file.
 * If found in process environment, its value is returned.
 * Else, try to get it from the nearest .env file.
 * If NOT found, return `undefined`
 * @param envVar The environment variable to lookup.
 * @param [options] Options to pass to {@link get}
 * @returns The string value of the environment variable or `undefined`.
 * `undefined` may be returned when the variable is undefined or its string is
 * empty, whitespace, or appears to have been converted from `null` or
 * `undefined`.
 */
function getEnvVarValue(envVar, options) {
  options ??= {
    ignore: ['MISSING_KEY', 'MISSING_ENV_FILE']
  };
  let value = env[envVar];
  const x = get(envVar, options);
  if (typeof x === 'string') value = x;
  // I hate this. Why is undefined converted to a string?
  return value === '' || value === 'undefined' ? undefined : value;
}
export { getEnv, getEnvVarValue };
//# sourceMappingURL=env.mjs.map