dotenv-extended 2.9.0 → 3.0.1

package/README.md

@@ -1,9 +1,12 @@
 # dotenv-extended
 
-[![Build Status](https://travis-ci.org/keithmorris/node-dotenv-extended.svg?branch=develop)](https://travis-ci.org/keithmorris/node-dotenv-extended)
-[![Coverage Status](https://coveralls.io/repos/github/keithmorris/node-dotenv-extended/badge.svg?branch=develop)](https://coveralls.io/github/keithmorris/node-dotenv-extended?branch=develop)
-[![Dependency Status](https://david-dm.org/keithmorris/node-dotenv-extended.svg)](https://david-dm.org/keithmorris/node-dotenv-extended)
+Extended `.env` loading with defaults and schema validation.
 
+## Supported Node Versions
+
+- Node `20.x`
+- Node `22.x`
+- Node `24.x`
 
 I've been a big fan of the [dotenv] for a quite some time (in fact, this library uses [dotenv] under the hood for the `.env` file parsing). However, while working on some bigger projects, we realized that the managing of the `.env` files became a bit of a chore. As the files changed in the development environments, it became a tedious manual process to compare and figure out what needed to be added or removed in the other environments.
 
@@ -29,7 +32,6 @@ Common configuration defaults across all environments (commited to source contro
 
 Defines a schema of what variables _should_ be defined in the combination of `.env` and `.env.defaults`. Optionally, you can have the library throw an error if all values are not configured or if there are extra values that shouldn't be there.
 
-
 The `.env.schema` file should only have the name of the variable and the `=` without any value:
 
 ```
@@ -49,6 +51,24 @@ I have tried to stay as compatible as possible with the [dotenv] library but the
 npm i --save dotenv-extended
 ```
 
+## Development
+
+```bash
+npm run check
+```
+
+`npm run check` runs linting, formatting checks, and tests.
+
+Use individual commands only when needed:
+
+```bash
+npm run build
+npm run lint
+npm run format
+npm run test:unit
+npm test
+```
+
 ## Usage
 
 As early as possible in your main script:
@@ -61,7 +81,7 @@ Or if you prefer import syntax:
 
 ```javascript
 import dotEnvExtended from 'dotenv-extended';
-dotEnvExtended.load(); 
+dotEnvExtended.load();
 ```
 
 Create a `.env` file in the root directory of your project. Add environment-specific variables on new lines in the form of `NAME=VALUE`.
@@ -80,7 +100,7 @@ MONGO_PASS=dbpassword!
 ```javascript
 mongoose.connect('mongodb://' + process.env.MONGO_HOST + '/' + process.env.MONGO_DATABASE, {
     user: process.env.MONGO_USER,
-    pass: process.env.MONGO_PASS
+    pass: process.env.MONGO_PASS,
 });
 ```
 
@@ -98,6 +118,8 @@ Or to specify load options:
 node -r dotenv-extended/config your_script.js dotenv_config_path=./env/.env dotenv_config_defaults=./env/.env.defaults
 ```
 
+`dotenv_config_*` values are normalized to the same option names as `load()`, supporting both snake_case and kebab-case style keys.
+
 ### Load Environment Variables and pass to non-NodeJS script
 
 New in 2.0.0, is a feature inspired by [cross-env](https://www.npmjs.com/package/cross-env) to allow you to load environment variables from your `.env` files and then pass them into a non-NodeJS script such as a shell script. This can simplify the process of maintaining variables used in both your Node app and other scripts. To use this command line executable, you will either need to install globally with the `-g` flag, or install `dotenv-extended` in your project and reference it from your npm scripts.
@@ -142,19 +164,20 @@ Defaults are shown below:
 
 ```javascript
 require('dotenv-extended').load({
-	encoding: 'utf8',
-	silent: true,
-	path: '.env',
-	defaults: '.env.defaults',
-	schema: '.env.schema',
-	errorOnMissing: false,
-	errorOnExtra: false,
-	errorOnRegex: false,
-	includeProcessEnv: false,
-	assignToProcessEnv: true,
-	overrideProcessEnv: false
+    encoding: 'utf8',
+    silent: true,
+    path: '.env',
+    defaults: '.env.defaults',
+    schema: '.env.schema',
+    errorOnMissing: false,
+    errorOnExtra: false,
+    errorOnRegex: false,
+    includeProcessEnv: false,
+    assignToProcessEnv: true,
+    overrideProcessEnv: false,
 });
 ```
+
 ### Configure via Environment Variables (New in 2.8.0)
 
 You may also set the configuration values via environment variables loaded from `process.env` shown below with defaults:
@@ -255,18 +278,18 @@ API_KEY=
 ```javascript
 const myConfig = require('dotenv-extended').load();
 
-myConfig.DB_HOST === process.env.DB_HOST === "localhost"
-myConfig.DB_USER === process.env.DB_USER === "databaseuser-local"
-myConfig.DB_PASS === process.env.DB_PASS === "localhost"
-myConfig.DB_DATABASE === process.env.DB_DATABASE === "MyAppDB"
-myConfig.SHARE_URL === process.env.SHARE_URL === "http://www.example.com"
+(myConfig.DB_HOST === process.env.DB_HOST) === 'localhost';
+(myConfig.DB_USER === process.env.DB_USER) === 'databaseuser-local';
+(myConfig.DB_PASS === process.env.DB_PASS) === 'localhost';
+(myConfig.DB_DATABASE === process.env.DB_DATABASE) === 'MyAppDB';
+(myConfig.SHARE_URL === process.env.SHARE_URL) === 'http://www.example.com';
 ```
 
 ### Load files with `errorOnMissing`
 
 ```javascript
 const myConfig = require('dotenv-extended').load({
-    errorOnMissing: true
+    errorOnMissing: true,
 });
 
 // Throws ERROR `MISSING CONFIG VALUES: API_KEY`
@@ -276,7 +299,7 @@ const myConfig = require('dotenv-extended').load({
 
 ```javascript
 const myConfig = require('dotenv-extended').load({
-    errorOnExtra: true
+    errorOnExtra: true,
 });
 
 // Throws ERROR `EXTRA CONFIG VALUES: SHARE_URL`
@@ -286,7 +309,7 @@ const myConfig = require('dotenv-extended').load({
 
 ```javascript
 const myConfig = require('dotenv-extended').load({
-    errorOnRegex: true
+    errorOnRegex: true,
 });
 
 // Throws ERROR `REGEX MISMATCH: DB_USER`
@@ -296,6 +319,18 @@ const myConfig = require('dotenv-extended').load({
 
 See [CONTRIBUTING.md](CONTRIBUTING.md)
 
+## Migration Notes
+
+### Migrating from legacy 2.x tooling
+
+- Node `>=20` is now required.
+- Build/test tooling no longer uses `gulp`, Babel, `esm`, or Mocha/NYC.
+- The project now uses:
+    - `tsup` for build output in `lib/`
+    - `vitest` for tests
+    - modern `eslint` config and `prettier`
+- Public API is kept compatible (`load`, `config`, `parse`, CLI behavior, and `dotenv-extended/config` preload entry).
+
 ## Change Log
 
 See [CHANGELOG.md](CHANGELOG.md)

package/dotenv-extended.d.ts

@@ -72,7 +72,7 @@ export interface IDotenvExtendedOptions {
     errorOnRegex?: boolean;
 
     /**
-     * Causes the library add process.env variables to error checking. The variables in process.env overrides the 
+     * Causes the library add process.env variables to error checking. The variables in process.env overrides the
      * variables in .env and .env.defaults while checking
      *
      * @default false

package/lib/bin/cli.js

@@ -0,0 +1,224 @@
+#!/usr/bin/env node
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/index.js
+var import_dotenv2 = __toESM(require("dotenv"));
+
+// src/utils/parse-primitive.js
+var parsePrimitive = (value) => {
+  if (value === null || typeof value === "undefined") {
+    return value;
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value !== "string") {
+    return value;
+  }
+  let normalized = value.trim().replace(/(^"|"$)|(^'|'$)/g, "").toLowerCase();
+  if (normalized === "" || normalized === "undefined") {
+    return void 0;
+  }
+  if (normalized === "null") {
+    return null;
+  }
+  if (normalized === "nan") {
+    return NaN;
+  }
+  if (normalized === "true" || normalized === "1") {
+    return true;
+  }
+  if (normalized === "false" || normalized === "0") {
+    return false;
+  }
+  const numeric = Number(normalized);
+  if (!Number.isNaN(numeric)) {
+    return numeric;
+  }
+  return value;
+};
+var parse_primitive_default = parsePrimitive;
+
+// src/utils/normalize-option-key.js
+var normalizedWithSeparators = (key) => key.toLowerCase().replace(/[_-\s]+([a-z0-9])/g, (_, next) => next.toUpperCase());
+var normalizeOptionKey = (key) => {
+  const trimmed = key.trim();
+  if (!trimmed) {
+    return "";
+  }
+  if (/[_-\s]/.test(trimmed)) {
+    return normalizedWithSeparators(trimmed);
+  }
+  if (trimmed === trimmed.toUpperCase()) {
+    return trimmed.toLowerCase();
+  }
+  return trimmed.charAt(0).toLowerCase() + trimmed.slice(1);
+};
+var normalize_option_key_default = normalizeOptionKey;
+
+// src/utils/config-from-env.js
+var getConfigFromEnv = (env) => {
+  let config2 = {};
+  Object.keys(env).forEach((key) => {
+    const curr = key.split("DOTENV_CONFIG_");
+    if (curr.length === 2 && curr[0] === "" && curr[1].length) {
+      config2[normalize_option_key_default(curr[1])] = parse_primitive_default(env[key]);
+    }
+  });
+  return config2;
+};
+var config_from_env_default = getConfigFromEnv;
+
+// src/utils/load-environment-file.js
+var import_fs = __toESM(require("fs"));
+var import_dotenv = __toESM(require("dotenv"));
+var loadEnvironmentFile = (path, encoding, silent) => {
+  try {
+    const data = import_fs.default.readFileSync(path, encoding);
+    return import_dotenv.default.parse(data);
+  } catch (err) {
+    if (!silent) {
+      console.error(err.message);
+    }
+    return {};
+  }
+};
+var load_environment_file_default = loadEnvironmentFile;
+
+// src/index.js
+var parse = import_dotenv2.default.parse.bind(import_dotenv2.default);
+var config = (options) => {
+  let defaultsData, environmentData, defaultOptions = {
+    encoding: "utf8",
+    silent: true,
+    path: ".env",
+    defaults: ".env.defaults",
+    schema: ".env.schema",
+    errorOnMissing: false,
+    errorOnExtra: false,
+    errorOnRegex: false,
+    includeProcessEnv: false,
+    assignToProcessEnv: true,
+    overrideProcessEnv: false
+  }, processEnvOptions = config_from_env_default(process.env);
+  options = Object.assign({}, defaultOptions, processEnvOptions, options);
+  defaultsData = load_environment_file_default(options.defaults, options.encoding, options.silent);
+  environmentData = load_environment_file_default(options.path, options.encoding, options.silent);
+  let configData = Object.assign({}, defaultsData, environmentData);
+  const config2 = options.includeProcessEnv ? Object.assign({}, configData, process.env) : configData;
+  const configOnlyKeys = Object.keys(configData);
+  const configKeys = Object.keys(config2);
+  if (options.errorOnMissing || options.errorOnExtra || options.errorOnRegex) {
+    const schema = load_environment_file_default(options.schema, options.encoding, options.silent);
+    const schemaKeys = Object.keys(schema);
+    let missingKeys = schemaKeys.filter(function(key) {
+      return configKeys.indexOf(key) < 0;
+    });
+    let extraKeys = configOnlyKeys.filter(function(key) {
+      return schemaKeys.indexOf(key) < 0;
+    });
+    if (options.errorOnMissing && missingKeys.length) {
+      throw new Error("MISSING CONFIG VALUES: " + missingKeys.join(", "));
+    }
+    if (options.errorOnExtra && extraKeys.length) {
+      throw new Error("EXTRA CONFIG VALUES: " + extraKeys.join(", "));
+    }
+    if (options.errorOnRegex) {
+      const regexMismatchKeys = schemaKeys.filter(function(key) {
+        if (schema[key]) {
+          return !new RegExp(schema[key]).test(
+            typeof config2[key] === "string" ? config2[key] : ""
+          );
+        }
+      });
+      if (regexMismatchKeys.length) {
+        throw new Error("REGEX MISMATCH: " + regexMismatchKeys.join(", "));
+      }
+    }
+  }
+  if (options.includeProcessEnv && !options.overrideProcessEnv) {
+    for (let i = 0; i < configKeys.length; i++) {
+      if (typeof process.env[configKeys[i]] !== "undefined")
+        configData[configKeys[i]] = process.env[configKeys[i]];
+    }
+  }
+  if (options.assignToProcessEnv) {
+    if (options.overrideProcessEnv) {
+      Object.assign(process.env, configData);
+    } else {
+      const tmp = Object.assign({}, configData, process.env);
+      Object.assign(process.env, tmp);
+    }
+  }
+  return configData;
+};
+
+// src/utils/parse-command.js
+var dotEnvFlagRegex = /^--(.+)=(.+)/;
+var parseCommand = (args) => {
+  const config2 = {};
+  let command = null;
+  let commandArgs = [];
+  for (let i = 0; i < args.length; i++) {
+    const match = dotEnvFlagRegex.exec(args[i]);
+    if (match) {
+      config2[normalize_option_key_default(match[1])] = parse_primitive_default(match[2]);
+    } else {
+      command = args[i];
+      commandArgs = args.slice(i + 1);
+      break;
+    }
+  }
+  return [config2, command, commandArgs];
+};
+var parse_command_default = parseCommand;
+
+// src/bin/index.js
+var import_node_child_process = require("child_process");
+var spawnCommand = (command, commandArgs, options) => (0, import_node_child_process.spawn)(command, commandArgs, options);
+function loadAndExecute(args, dependencies = {}) {
+  const {
+    spawnCommandFn = spawnCommand,
+    processOn = process.on.bind(process),
+    processExit = process.exit
+  } = dependencies;
+  const [dotEnvConfig, command, commandArgs] = parse_command_default(args);
+  if (command) {
+    config(dotEnvConfig);
+    const proc = spawnCommandFn(command, commandArgs, {
+      stdio: "inherit",
+      shell: true,
+      env: process.env
+    });
+    processOn("SIGTERM", () => proc.kill("SIGTERM"));
+    processOn("SIGINT", () => proc.kill("SIGINT"));
+    processOn("SIGBREAK", () => proc.kill("SIGBREAK"));
+    processOn("SIGHUP", () => proc.kill("SIGHUP"));
+    proc.on("exit", processExit);
+    return proc;
+  }
+}
+
+// src/bin/cli.js
+loadAndExecute(process.argv.slice(2));

package/lib/bin/index.js

@@ -1,63 +1,239 @@
 #!/usr/bin/env node
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-/**
- * Created by Keith Morris on 4/26/17.
- *
- * This bin script is inspired by and borrows heavily from CrossEnv
- * https://github.com/kentcdodds/cross-env
- */
-"use strict";
-
-var _ = require("..");
-
-var _parseCommand3 = _interopRequireDefault(require("../utils/parse-command"));
-
-var _crossSpawn = require("cross-spawn");
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+// src/bin/index.js
+var bin_exports = {};
+__export(bin_exports, {
+  loadAndExecute: () => loadAndExecute,
+  spawnCommand: () => spawnCommand
+});
+module.exports = __toCommonJS(bin_exports);
 
-function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+// src/index.js
+var import_dotenv2 = __toESM(require("dotenv"));
 
-function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+// src/utils/parse-primitive.js
+var parsePrimitive = (value) => {
+  if (value === null || typeof value === "undefined") {
+    return value;
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value !== "string") {
+    return value;
+  }
+  let normalized = value.trim().replace(/(^"|"$)|(^'|'$)/g, "").toLowerCase();
+  if (normalized === "" || normalized === "undefined") {
+    return void 0;
+  }
+  if (normalized === "null") {
+    return null;
+  }
+  if (normalized === "nan") {
+    return NaN;
+  }
+  if (normalized === "true" || normalized === "1") {
+    return true;
+  }
+  if (normalized === "false" || normalized === "0") {
+    return false;
+  }
+  const numeric = Number(normalized);
+  if (!Number.isNaN(numeric)) {
+    return numeric;
+  }
+  return value;
+};
+var parse_primitive_default = parsePrimitive;
 
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(n); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+// src/utils/normalize-option-key.js
+var normalizedWithSeparators = (key) => key.toLowerCase().replace(/[_-\s]+([a-z0-9])/g, (_, next) => next.toUpperCase());
+var normalizeOptionKey = (key) => {
+  const trimmed = key.trim();
+  if (!trimmed) {
+    return "";
+  }
+  if (/[_-\s]/.test(trimmed)) {
+    return normalizedWithSeparators(trimmed);
+  }
+  if (trimmed === trimmed.toUpperCase()) {
+    return trimmed.toLowerCase();
+  }
+  return trimmed.charAt(0).toLowerCase() + trimmed.slice(1);
+};
+var normalize_option_key_default = normalizeOptionKey;
 
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+// src/utils/config-from-env.js
+var getConfigFromEnv = (env) => {
+  let config2 = {};
+  Object.keys(env).forEach((key) => {
+    const curr = key.split("DOTENV_CONFIG_");
+    if (curr.length === 2 && curr[0] === "" && curr[1].length) {
+      config2[normalize_option_key_default(curr[1])] = parse_primitive_default(env[key]);
+    }
+  });
+  return config2;
+};
+var config_from_env_default = getConfigFromEnv;
 
-function _iterableToArrayLimit(arr, i) { if (typeof Symbol === "undefined" || !(Symbol.iterator in Object(arr))) return; var _arr = []; var _n = true; var _d = false; var _e = undefined; try { for (var _i = arr[Symbol.iterator](), _s; !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
+// src/utils/load-environment-file.js
+var import_fs = __toESM(require("fs"));
+var import_dotenv = __toESM(require("dotenv"));
+var loadEnvironmentFile = (path, encoding, silent) => {
+  try {
+    const data = import_fs.default.readFileSync(path, encoding);
+    return import_dotenv.default.parse(data);
+  } catch (err) {
+    if (!silent) {
+      console.error(err.message);
+    }
+    return {};
+  }
+};
+var load_environment_file_default = loadEnvironmentFile;
 
-function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+// src/index.js
+var parse = import_dotenv2.default.parse.bind(import_dotenv2.default);
+var config = (options) => {
+  let defaultsData, environmentData, defaultOptions = {
+    encoding: "utf8",
+    silent: true,
+    path: ".env",
+    defaults: ".env.defaults",
+    schema: ".env.schema",
+    errorOnMissing: false,
+    errorOnExtra: false,
+    errorOnRegex: false,
+    includeProcessEnv: false,
+    assignToProcessEnv: true,
+    overrideProcessEnv: false
+  }, processEnvOptions = config_from_env_default(process.env);
+  options = Object.assign({}, defaultOptions, processEnvOptions, options);
+  defaultsData = load_environment_file_default(options.defaults, options.encoding, options.silent);
+  environmentData = load_environment_file_default(options.path, options.encoding, options.silent);
+  let configData = Object.assign({}, defaultsData, environmentData);
+  const config2 = options.includeProcessEnv ? Object.assign({}, configData, process.env) : configData;
+  const configOnlyKeys = Object.keys(configData);
+  const configKeys = Object.keys(config2);
+  if (options.errorOnMissing || options.errorOnExtra || options.errorOnRegex) {
+    const schema = load_environment_file_default(options.schema, options.encoding, options.silent);
+    const schemaKeys = Object.keys(schema);
+    let missingKeys = schemaKeys.filter(function(key) {
+      return configKeys.indexOf(key) < 0;
+    });
+    let extraKeys = configOnlyKeys.filter(function(key) {
+      return schemaKeys.indexOf(key) < 0;
+    });
+    if (options.errorOnMissing && missingKeys.length) {
+      throw new Error("MISSING CONFIG VALUES: " + missingKeys.join(", "));
+    }
+    if (options.errorOnExtra && extraKeys.length) {
+      throw new Error("EXTRA CONFIG VALUES: " + extraKeys.join(", "));
+    }
+    if (options.errorOnRegex) {
+      const regexMismatchKeys = schemaKeys.filter(function(key) {
+        if (schema[key]) {
+          return !new RegExp(schema[key]).test(
+            typeof config2[key] === "string" ? config2[key] : ""
+          );
+        }
+      });
+      if (regexMismatchKeys.length) {
+        throw new Error("REGEX MISMATCH: " + regexMismatchKeys.join(", "));
+      }
+    }
+  }
+  if (options.includeProcessEnv && !options.overrideProcessEnv) {
+    for (let i = 0; i < configKeys.length; i++) {
+      if (typeof process.env[configKeys[i]] !== "undefined")
+        configData[configKeys[i]] = process.env[configKeys[i]];
+    }
+  }
+  if (options.assignToProcessEnv) {
+    if (options.overrideProcessEnv) {
+      Object.assign(process.env, configData);
+    } else {
+      const tmp = Object.assign({}, configData, process.env);
+      Object.assign(process.env, tmp);
+    }
+  }
+  return configData;
+};
 
-function loadAndExecute(args) {
-  var _parseCommand = (0, _parseCommand3["default"])(args),
-      _parseCommand2 = _slicedToArray(_parseCommand, 3),
-      dotEnvConfig = _parseCommand2[0],
-      command = _parseCommand2[1],
-      commandArgs = _parseCommand2[2];
+// src/utils/parse-command.js
+var dotEnvFlagRegex = /^--(.+)=(.+)/;
+var parseCommand = (args) => {
+  const config2 = {};
+  let command = null;
+  let commandArgs = [];
+  for (let i = 0; i < args.length; i++) {
+    const match = dotEnvFlagRegex.exec(args[i]);
+    if (match) {
+      config2[normalize_option_key_default(match[1])] = parse_primitive_default(match[2]);
+    } else {
+      command = args[i];
+      commandArgs = args.slice(i + 1);
+      break;
+    }
+  }
+  return [config2, command, commandArgs];
+};
+var parse_command_default = parseCommand;
 
+// src/bin/index.js
+var import_node_child_process = require("child_process");
+var spawnCommand = (command, commandArgs, options) => (0, import_node_child_process.spawn)(command, commandArgs, options);
+function loadAndExecute(args, dependencies = {}) {
+  const {
+    spawnCommandFn = spawnCommand,
+    processOn = process.on.bind(process),
+    processExit = process.exit
+  } = dependencies;
+  const [dotEnvConfig, command, commandArgs] = parse_command_default(args);
   if (command) {
-    (0, _.config)(dotEnvConfig); // mutates process.env
-
-    var proc = (0, _crossSpawn.spawn)(command, commandArgs, {
-      stdio: 'inherit',
+    config(dotEnvConfig);
+    const proc = spawnCommandFn(command, commandArgs, {
+      stdio: "inherit",
       shell: true,
       env: process.env
     });
-    process.on('SIGTERM', function () {
-      return proc.kill('SIGTERM');
-    });
-    process.on('SIGINT', function () {
-      return proc.kill('SIGINT');
-    });
-    process.on('SIGBREAK', function () {
-      return proc.kill('SIGBREAK');
-    });
-    process.on('SIGHUP', function () {
-      return proc.kill('SIGHUP');
-    });
-    proc.on('exit', process.exit);
+    processOn("SIGTERM", () => proc.kill("SIGTERM"));
+    processOn("SIGINT", () => proc.kill("SIGINT"));
+    processOn("SIGBREAK", () => proc.kill("SIGBREAK"));
+    processOn("SIGHUP", () => proc.kill("SIGHUP"));
+    proc.on("exit", processExit);
     return proc;
   }
 }
-
-loadAndExecute(process.argv.slice(2));
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  loadAndExecute,
+  spawnCommand
+});