@karmaniverous/get-dotenv 4.0.0-0 → 4.0.0-2

package/dist/getdotenv.cli.mjs

@@ -14,13 +14,13 @@ import fs$m, { createWriteStream, createReadStream } from 'node:fs';
 import { setTimeout as setTimeout$1 } from 'node:timers/promises';
 import require$$0$2 from 'stream';
 import { debuglog } from 'node:util';
-import require$$2 from 'os';
 import require$$0$3 from 'constants';
 import require$$4$2 from 'util';
 import require$$5 from 'assert';
 import { webcrypto } from 'node:crypto';
 import url, { fileURLToPath as fileURLToPath$1 } from 'url';
 import 'node:fs/promises';
+import require$$2 from 'os';
 import require$$3 from 'crypto';
 
 // like String.prototype.search but returns the last index
@@ -89,6 +89,16 @@ const dotenvExpandAll = (values = {}, { ref = process.env, progressive = false,
     });
     return acc;
 }, {});
+/**
+ * Recursively expands environment variables in a string using `process.env` as
+ * the expansion reference. Variables may be presented with optional default as
+ * `$VAR[:default]` or `${VAR[:default]}`. Unknown variables will expand to an
+ * empty string.
+ *
+ * @param value - The string to expand.
+ * @returns The expanded string.
+ */
+const dotenvExpandFromProcessEnv = (value) => dotenvExpand(value, process.env);
 
 var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
 
@@ -23231,7 +23241,7 @@ var constants = require$$0$3;
 var origCwd = process.cwd;
 var cwd = null;
 
-var platform$1 = process.env.GRACEFUL_FS_PLATFORM || process.platform;
+var platform = process.env.GRACEFUL_FS_PLATFORM || process.platform;
 
 process.cwd = function() {
   if (!cwd)
@@ -23321,7 +23331,7 @@ function patch$1 (fs) {
   // failures. Also, take care to yield the scheduler. Windows scheduling gives
   // CPU to a busy looping process, which can cause the program causing the lock
   // contention to be starved of CPU by node, so the contention doesn't resolve.
-  if (platform$1 === "win32") {
+  if (platform === "win32") {
     fs.rename = typeof fs.rename !== 'function' ? fs.rename
     : (function (fs$rename) {
       function rename (from, to, cb) {
@@ -26340,12 +26350,6 @@ const getDotenv = async (options = {}) => {
     return dotenv;
 };
 
-// Discover platform.
-const platform = require$$2.platform();
-/**
- * `dotenvExpand` function reduced to initial argument (applies default to `ref` argument).
- */
-const dotenvExpandDefault = (value) => dotenvExpand(value);
 /**
  * Generate a Commander CLI Command for get-dotenv.
  */
@@ -26363,15 +26367,15 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         .description(description)
         .enablePositionalOptions()
         .passThroughOptions()
-        .option('-e, --env <string>', `target environment (dotenv-expanded)`, dotenvExpandDefault, env)
+        .option('-e, --env <string>', `target environment (dotenv-expanded)`, dotenvExpandFromProcessEnv, env)
         .option('-v, --vars <string>', `extra variables expressed as delimited key-value pairs (dotenv-expanded): ${[
         ['KEY1', 'VAL1'],
         ['KEY2', 'VAL2'],
     ]
         .map((v) => v.join(varsAssignor))
-        .join(varsDelimiter)}`, dotenvExpandDefault)
-        .option('-c, --command <string>', 'shell command string (dotenv-expanded)', dotenvExpandDefault)
-        .option('-o, --output-path <string>', 'consolidated output file  (dotenv-expanded)', dotenvExpandDefault, outputPath)
+        .join(varsDelimiter)}`, dotenvExpandFromProcessEnv)
+        .option('-c, --command <string>', 'shell command string (dotenv-expanded)', dotenvExpandFromProcessEnv)
+        .option('-o, --output-path <string>', 'consolidated output file  (dotenv-expanded)', dotenvExpandFromProcessEnv, outputPath)
         .addOption(new Option('-p, --load-process', `load variables to process.env ON${loadProcess ? ' (default)' : ''}`).conflicts('loadProcessOff'))
         .addOption(new Option('-P, --load-process-off', `load variables to process.env OFF${!loadProcess ? ' (default)' : ''}`).conflicts('loadProcess'))
         .addOption(new Option('-a, --exclude-all', `exclude all dotenv variables from loading ON${excludeAll ? ' (default)' : ''}`).conflicts('excludeAllOff'))
@@ -26390,13 +26394,13 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         .addOption(new Option('-L, --log-off', `console log loaded variables OFF${!log ? ' (default)' : ''}`).conflicts('log'))
         .addOption(new Option('-d, --debug', `debug mode ON${debug ? ' (default)' : ''}`).conflicts('debugOff'))
         .addOption(new Option('-D, --debug-off', `debug mode OFF${!debug ? ' (default)' : ''}`).conflicts('debug'))
-        .option('--default-env <string>', 'default target environment', dotenvExpandDefault, defaultEnv)
-        .option('--dotenv-token <string>', 'dotenv-expanded token indicating a dotenv file', dotenvExpandDefault, dotenvToken)
-        .option('--dynamic-path <string>', 'dynamic variables path', dotenvExpandDefault, dynamicPath)
-        .option('--paths <string>', 'dotenv-expanded delimited list of paths to dotenv directory', dotenvExpandDefault, paths)
+        .option('--default-env <string>', 'default target environment', dotenvExpandFromProcessEnv, defaultEnv)
+        .option('--dotenv-token <string>', 'dotenv-expanded token indicating a dotenv file', dotenvExpandFromProcessEnv, dotenvToken)
+        .option('--dynamic-path <string>', 'dynamic variables path', dotenvExpandFromProcessEnv, dynamicPath)
+        .option('--paths <string>', 'dotenv-expanded delimited list of paths to dotenv directory', dotenvExpandFromProcessEnv, paths)
         .option('--paths-delimiter <string>', 'paths delimiter string', pathsDelimiter)
         .option('--paths-delimiter-pattern <string>', 'paths delimiter regex pattern', pathsDelimiterPattern)
-        .option('--private-token <string>', 'dotenv-expanded token indicating private variables', dotenvExpandDefault, privateToken)
+        .option('--private-token <string>', 'dotenv-expanded token indicating private variables', dotenvExpandFromProcessEnv, privateToken)
         .option('--vars-delimiter <string>', 'vars delimiter string', varsDelimiter)
         .option('--vars-delimiter-pattern <string>', 'vars delimiter regex pattern', varsDelimiterPattern)
         .option('--vars-assignor <string>', 'vars assignment operator string', varsAssignor)
@@ -26408,12 +26412,18 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         .enablePositionalOptions()
         .passThroughOptions()
         .action(async (options, command) => {
-        const { args } = command;
-        if (args.length)
-            await execaCommand(args.join(platform === 'win32' ? '\\ ' : ' '), {
+        const { args, getDotenvOptions: { debug }, } = command.parent;
+        if (args.length) {
+            if (debug)
+                logger.log('\n*** raw shell args ***\n', args);
+            const shellCommand = args.join(' ');
+            if (debug)
+                logger.log('\n*** shell command ***\n', shellCommand);
+            await execaCommand(shellCommand, {
                 stdio: 'inherit',
                 shell: true,
             });
+        }
     }), { isDefault: true })
         .hook('preSubcommand', async (thisCommand) => {
         const rawOptions = thisCommand.opts();
@@ -26479,8 +26489,10 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         if (postHook)
             await postHook(dotenv);
         // Execute shell command.
-        if (command)
-            await execaCommand(platform === 'win32' ? command.replace(/ /g, '\\ ') : command, {
+        if (command) {
+            if (cliOptions.debug)
+                logger.log('\n*** shell command ***\n', command);
+            await execaCommand(command, {
                 env: {
                     ...process.env,
                     getDotenvOptions: JSON.stringify(getDotenvOptions),
@@ -26488,6 +26500,7 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
                 shell: true,
                 stdio: 'inherit',
             });
+        }
     });
 };
 

package/dist/index.cjs

@@ -15,13 +15,13 @@ var fs$m = require('node:fs');
 var promises = require('node:timers/promises');
 var require$$0$2 = require('stream');
 var node_util = require('node:util');
-var require$$2 = require('os');
 var require$$0$3 = require('constants');
 var require$$4$2 = require('util');
 var require$$5 = require('assert');
 var node_crypto = require('node:crypto');
 var url = require('url');
 require('node:fs/promises');
+var require$$2 = require('os');
 var require$$3 = require('crypto');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
@@ -91,6 +91,16 @@ const dotenvExpandAll = (values = {}, { ref = process.env, progressive = false,
     });
     return acc;
 }, {});
+/**
+ * Recursively expands environment variables in a string using `process.env` as
+ * the expansion reference. Variables may be presented with optional default as
+ * `$VAR[:default]` or `${VAR[:default]}`. Unknown variables will expand to an
+ * empty string.
+ *
+ * @param value - The string to expand.
+ * @returns The expanded string.
+ */
+const dotenvExpandFromProcessEnv = (value) => dotenvExpand(value, process.env);
 
 var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
 
@@ -23233,7 +23243,7 @@ var constants = require$$0$3;
 var origCwd = process.cwd;
 var cwd = null;
 
-var platform$1 = process.env.GRACEFUL_FS_PLATFORM || process.platform;
+var platform = process.env.GRACEFUL_FS_PLATFORM || process.platform;
 
 process.cwd = function() {
   if (!cwd)
@@ -23323,7 +23333,7 @@ function patch$1 (fs) {
   // failures. Also, take care to yield the scheduler. Windows scheduling gives
   // CPU to a busy looping process, which can cause the program causing the lock
   // contention to be starved of CPU by node, so the contention doesn't resolve.
-  if (platform$1 === "win32") {
+  if (platform === "win32") {
     fs.rename = typeof fs.rename !== 'function' ? fs.rename
     : (function (fs$rename) {
       function rename (from, to, cb) {
@@ -26342,12 +26352,6 @@ const getDotenv = async (options = {}) => {
     return dotenv;
 };
 
-// Discover platform.
-const platform = require$$2.platform();
-/**
- * `dotenvExpand` function reduced to initial argument (applies default to `ref` argument).
- */
-const dotenvExpandDefault = (value) => dotenvExpand(value);
 /**
  * Generate a Commander CLI Command for get-dotenv.
  */
@@ -26365,15 +26369,15 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         .description(description)
         .enablePositionalOptions()
         .passThroughOptions()
-        .option('-e, --env <string>', `target environment (dotenv-expanded)`, dotenvExpandDefault, env)
+        .option('-e, --env <string>', `target environment (dotenv-expanded)`, dotenvExpandFromProcessEnv, env)
         .option('-v, --vars <string>', `extra variables expressed as delimited key-value pairs (dotenv-expanded): ${[
         ['KEY1', 'VAL1'],
         ['KEY2', 'VAL2'],
     ]
         .map((v) => v.join(varsAssignor))
-        .join(varsDelimiter)}`, dotenvExpandDefault)
-        .option('-c, --command <string>', 'shell command string (dotenv-expanded)', dotenvExpandDefault)
-        .option('-o, --output-path <string>', 'consolidated output file  (dotenv-expanded)', dotenvExpandDefault, outputPath)
+        .join(varsDelimiter)}`, dotenvExpandFromProcessEnv)
+        .option('-c, --command <string>', 'shell command string (dotenv-expanded)', dotenvExpandFromProcessEnv)
+        .option('-o, --output-path <string>', 'consolidated output file  (dotenv-expanded)', dotenvExpandFromProcessEnv, outputPath)
         .addOption(new Option('-p, --load-process', `load variables to process.env ON${loadProcess ? ' (default)' : ''}`).conflicts('loadProcessOff'))
         .addOption(new Option('-P, --load-process-off', `load variables to process.env OFF${!loadProcess ? ' (default)' : ''}`).conflicts('loadProcess'))
         .addOption(new Option('-a, --exclude-all', `exclude all dotenv variables from loading ON${excludeAll ? ' (default)' : ''}`).conflicts('excludeAllOff'))
@@ -26392,13 +26396,13 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         .addOption(new Option('-L, --log-off', `console log loaded variables OFF${!log ? ' (default)' : ''}`).conflicts('log'))
         .addOption(new Option('-d, --debug', `debug mode ON${debug ? ' (default)' : ''}`).conflicts('debugOff'))
         .addOption(new Option('-D, --debug-off', `debug mode OFF${!debug ? ' (default)' : ''}`).conflicts('debug'))
-        .option('--default-env <string>', 'default target environment', dotenvExpandDefault, defaultEnv)
-        .option('--dotenv-token <string>', 'dotenv-expanded token indicating a dotenv file', dotenvExpandDefault, dotenvToken)
-        .option('--dynamic-path <string>', 'dynamic variables path', dotenvExpandDefault, dynamicPath)
-        .option('--paths <string>', 'dotenv-expanded delimited list of paths to dotenv directory', dotenvExpandDefault, paths)
+        .option('--default-env <string>', 'default target environment', dotenvExpandFromProcessEnv, defaultEnv)
+        .option('--dotenv-token <string>', 'dotenv-expanded token indicating a dotenv file', dotenvExpandFromProcessEnv, dotenvToken)
+        .option('--dynamic-path <string>', 'dynamic variables path', dotenvExpandFromProcessEnv, dynamicPath)
+        .option('--paths <string>', 'dotenv-expanded delimited list of paths to dotenv directory', dotenvExpandFromProcessEnv, paths)
         .option('--paths-delimiter <string>', 'paths delimiter string', pathsDelimiter)
         .option('--paths-delimiter-pattern <string>', 'paths delimiter regex pattern', pathsDelimiterPattern)
-        .option('--private-token <string>', 'dotenv-expanded token indicating private variables', dotenvExpandDefault, privateToken)
+        .option('--private-token <string>', 'dotenv-expanded token indicating private variables', dotenvExpandFromProcessEnv, privateToken)
         .option('--vars-delimiter <string>', 'vars delimiter string', varsDelimiter)
         .option('--vars-delimiter-pattern <string>', 'vars delimiter regex pattern', varsDelimiterPattern)
         .option('--vars-assignor <string>', 'vars assignment operator string', varsAssignor)
@@ -26410,12 +26414,18 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         .enablePositionalOptions()
         .passThroughOptions()
         .action(async (options, command) => {
-        const { args } = command;
-        if (args.length)
-            await execaCommand(args.join(platform === 'win32' ? '\\ ' : ' '), {
+        const { args, getDotenvOptions: { debug }, } = command.parent;
+        if (args.length) {
+            if (debug)
+                logger.log('\n*** raw shell args ***\n', args);
+            const shellCommand = args.join(' ');
+            if (debug)
+                logger.log('\n*** shell command ***\n', shellCommand);
+            await execaCommand(shellCommand, {
                 stdio: 'inherit',
                 shell: true,
             });
+        }
     }), { isDefault: true })
         .hook('preSubcommand', async (thisCommand) => {
         const rawOptions = thisCommand.opts();
@@ -26481,8 +26491,10 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         if (postHook)
             await postHook(dotenv);
         // Execute shell command.
-        if (command)
-            await execaCommand(platform === 'win32' ? command.replace(/ /g, '\\ ') : command, {
+        if (command) {
+            if (cliOptions.debug)
+                logger.log('\n*** shell command ***\n', command);
+            await execaCommand(command, {
                 env: {
                     ...process.env,
                     getDotenvOptions: JSON.stringify(getDotenvOptions),
@@ -26490,10 +26502,12 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
                 shell: true,
                 stdio: 'inherit',
             });
+        }
     });
 };
 
 exports.dotenvExpand = dotenvExpand;
 exports.dotenvExpandAll = dotenvExpandAll;
+exports.dotenvExpandFromProcessEnv = dotenvExpandFromProcessEnv;
 exports.generateGetDotenvCli = generateGetDotenvCli;
 exports.getDotenv = getDotenv;

package/dist/index.d.cts

@@ -57,6 +57,10 @@ type Logger = Record<string, (...args: unknown[]) => void>;
  * Options passed programmatically to `getDotenv` and `getDotEnvSync`.
  */
 interface GetDotenvOptions {
+    /**
+     * log internals to logger
+     */
+    debug?: boolean;
     /**
      * default target environment (used if `env` is not provided)
      */
@@ -148,6 +152,16 @@ declare const dotenvExpandAll: (values?: ProcessEnv, { ref, progressive, }?: {
     ref?: ProcessEnv;
     progressive?: boolean;
 }) => Record<string, string | undefined>;
+/**
+ * Recursively expands environment variables in a string using `process.env` as
+ * the expansion reference. Variables may be presented with optional default as
+ * `$VAR[:default]` or `${VAR[:default]}`. Unknown variables will expand to an
+ * empty string.
+ *
+ * @param value - The string to expand.
+ * @returns The expanded string.
+ */
+declare const dotenvExpandFromProcessEnv: (value: string | undefined) => string | undefined;
 
 /**
  * GetDotenv CLI Pre-hook Callback function type. Mutates inbound options &
@@ -231,4 +245,4 @@ declare const generateGetDotenvCli: ({ logger, preHook, postHook, ...cliOptionsC
  */
 declare const getDotenv: (options?: GetDotenvOptions) => Promise<ProcessEnv>;
 
-export { type GetDotenvDynamic, type GetDotenvOptions, type ProcessEnv, dotenvExpand, dotenvExpandAll, generateGetDotenvCli, getDotenv };
+export { type GetDotenvDynamic, type GetDotenvOptions, type ProcessEnv, dotenvExpand, dotenvExpandAll, dotenvExpandFromProcessEnv, generateGetDotenvCli, getDotenv };

package/dist/index.d.mts

@@ -57,6 +57,10 @@ type Logger = Record<string, (...args: unknown[]) => void>;
  * Options passed programmatically to `getDotenv` and `getDotEnvSync`.
  */
 interface GetDotenvOptions {
+    /**
+     * log internals to logger
+     */
+    debug?: boolean;
     /**
      * default target environment (used if `env` is not provided)
      */
@@ -148,6 +152,16 @@ declare const dotenvExpandAll: (values?: ProcessEnv, { ref, progressive, }?: {
     ref?: ProcessEnv;
     progressive?: boolean;
 }) => Record<string, string | undefined>;
+/**
+ * Recursively expands environment variables in a string using `process.env` as
+ * the expansion reference. Variables may be presented with optional default as
+ * `$VAR[:default]` or `${VAR[:default]}`. Unknown variables will expand to an
+ * empty string.
+ *
+ * @param value - The string to expand.
+ * @returns The expanded string.
+ */
+declare const dotenvExpandFromProcessEnv: (value: string | undefined) => string | undefined;
 
 /**
  * GetDotenv CLI Pre-hook Callback function type. Mutates inbound options &
@@ -231,4 +245,4 @@ declare const generateGetDotenvCli: ({ logger, preHook, postHook, ...cliOptionsC
  */
 declare const getDotenv: (options?: GetDotenvOptions) => Promise<ProcessEnv>;
 
-export { type GetDotenvDynamic, type GetDotenvOptions, type ProcessEnv, dotenvExpand, dotenvExpandAll, generateGetDotenvCli, getDotenv };
+export { type GetDotenvDynamic, type GetDotenvOptions, type ProcessEnv, dotenvExpand, dotenvExpandAll, dotenvExpandFromProcessEnv, generateGetDotenvCli, getDotenv };

package/dist/index.d.ts

@@ -57,6 +57,10 @@ type Logger = Record<string, (...args: unknown[]) => void>;
  * Options passed programmatically to `getDotenv` and `getDotEnvSync`.
  */
 interface GetDotenvOptions {
+    /**
+     * log internals to logger
+     */
+    debug?: boolean;
     /**
      * default target environment (used if `env` is not provided)
      */
@@ -148,6 +152,16 @@ declare const dotenvExpandAll: (values?: ProcessEnv, { ref, progressive, }?: {
     ref?: ProcessEnv;
     progressive?: boolean;
 }) => Record<string, string | undefined>;
+/**
+ * Recursively expands environment variables in a string using `process.env` as
+ * the expansion reference. Variables may be presented with optional default as
+ * `$VAR[:default]` or `${VAR[:default]}`. Unknown variables will expand to an
+ * empty string.
+ *
+ * @param value - The string to expand.
+ * @returns The expanded string.
+ */
+declare const dotenvExpandFromProcessEnv: (value: string | undefined) => string | undefined;
 
 /**
  * GetDotenv CLI Pre-hook Callback function type. Mutates inbound options &
@@ -231,4 +245,4 @@ declare const generateGetDotenvCli: ({ logger, preHook, postHook, ...cliOptionsC
  */
 declare const getDotenv: (options?: GetDotenvOptions) => Promise<ProcessEnv>;
 
-export { type GetDotenvDynamic, type GetDotenvOptions, type ProcessEnv, dotenvExpand, dotenvExpandAll, generateGetDotenvCli, getDotenv };
+export { type GetDotenvDynamic, type GetDotenvOptions, type ProcessEnv, dotenvExpand, dotenvExpandAll, dotenvExpandFromProcessEnv, generateGetDotenvCli, getDotenv };

package/dist/index.mjs

@@ -13,13 +13,13 @@ import fs$m, { createWriteStream, createReadStream } from 'node:fs';
 import { setTimeout as setTimeout$1 } from 'node:timers/promises';
 import require$$0$2 from 'stream';
 import { debuglog } from 'node:util';
-import require$$2 from 'os';
 import require$$0$3 from 'constants';
 import require$$4$2 from 'util';
 import require$$5 from 'assert';
 import { webcrypto } from 'node:crypto';
 import url, { fileURLToPath as fileURLToPath$1 } from 'url';
 import 'node:fs/promises';
+import require$$2 from 'os';
 import require$$3 from 'crypto';
 
 // like String.prototype.search but returns the last index
@@ -88,6 +88,16 @@ const dotenvExpandAll = (values = {}, { ref = process.env, progressive = false,
     });
     return acc;
 }, {});
+/**
+ * Recursively expands environment variables in a string using `process.env` as
+ * the expansion reference. Variables may be presented with optional default as
+ * `$VAR[:default]` or `${VAR[:default]}`. Unknown variables will expand to an
+ * empty string.
+ *
+ * @param value - The string to expand.
+ * @returns The expanded string.
+ */
+const dotenvExpandFromProcessEnv = (value) => dotenvExpand(value, process.env);
 
 var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
 
@@ -23230,7 +23240,7 @@ var constants = require$$0$3;
 var origCwd = process.cwd;
 var cwd = null;
 
-var platform$1 = process.env.GRACEFUL_FS_PLATFORM || process.platform;
+var platform = process.env.GRACEFUL_FS_PLATFORM || process.platform;
 
 process.cwd = function() {
   if (!cwd)
@@ -23320,7 +23330,7 @@ function patch$1 (fs) {
   // failures. Also, take care to yield the scheduler. Windows scheduling gives
   // CPU to a busy looping process, which can cause the program causing the lock
   // contention to be starved of CPU by node, so the contention doesn't resolve.
-  if (platform$1 === "win32") {
+  if (platform === "win32") {
     fs.rename = typeof fs.rename !== 'function' ? fs.rename
     : (function (fs$rename) {
       function rename (from, to, cb) {
@@ -26339,12 +26349,6 @@ const getDotenv = async (options = {}) => {
     return dotenv;
 };
 
-// Discover platform.
-const platform = require$$2.platform();
-/**
- * `dotenvExpand` function reduced to initial argument (applies default to `ref` argument).
- */
-const dotenvExpandDefault = (value) => dotenvExpand(value);
 /**
  * Generate a Commander CLI Command for get-dotenv.
  */
@@ -26362,15 +26366,15 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         .description(description)
         .enablePositionalOptions()
         .passThroughOptions()
-        .option('-e, --env <string>', `target environment (dotenv-expanded)`, dotenvExpandDefault, env)
+        .option('-e, --env <string>', `target environment (dotenv-expanded)`, dotenvExpandFromProcessEnv, env)
         .option('-v, --vars <string>', `extra variables expressed as delimited key-value pairs (dotenv-expanded): ${[
         ['KEY1', 'VAL1'],
         ['KEY2', 'VAL2'],
     ]
         .map((v) => v.join(varsAssignor))
-        .join(varsDelimiter)}`, dotenvExpandDefault)
-        .option('-c, --command <string>', 'shell command string (dotenv-expanded)', dotenvExpandDefault)
-        .option('-o, --output-path <string>', 'consolidated output file  (dotenv-expanded)', dotenvExpandDefault, outputPath)
+        .join(varsDelimiter)}`, dotenvExpandFromProcessEnv)
+        .option('-c, --command <string>', 'shell command string (dotenv-expanded)', dotenvExpandFromProcessEnv)
+        .option('-o, --output-path <string>', 'consolidated output file  (dotenv-expanded)', dotenvExpandFromProcessEnv, outputPath)
         .addOption(new Option('-p, --load-process', `load variables to process.env ON${loadProcess ? ' (default)' : ''}`).conflicts('loadProcessOff'))
         .addOption(new Option('-P, --load-process-off', `load variables to process.env OFF${!loadProcess ? ' (default)' : ''}`).conflicts('loadProcess'))
         .addOption(new Option('-a, --exclude-all', `exclude all dotenv variables from loading ON${excludeAll ? ' (default)' : ''}`).conflicts('excludeAllOff'))
@@ -26389,13 +26393,13 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         .addOption(new Option('-L, --log-off', `console log loaded variables OFF${!log ? ' (default)' : ''}`).conflicts('log'))
         .addOption(new Option('-d, --debug', `debug mode ON${debug ? ' (default)' : ''}`).conflicts('debugOff'))
         .addOption(new Option('-D, --debug-off', `debug mode OFF${!debug ? ' (default)' : ''}`).conflicts('debug'))
-        .option('--default-env <string>', 'default target environment', dotenvExpandDefault, defaultEnv)
-        .option('--dotenv-token <string>', 'dotenv-expanded token indicating a dotenv file', dotenvExpandDefault, dotenvToken)
-        .option('--dynamic-path <string>', 'dynamic variables path', dotenvExpandDefault, dynamicPath)
-        .option('--paths <string>', 'dotenv-expanded delimited list of paths to dotenv directory', dotenvExpandDefault, paths)
+        .option('--default-env <string>', 'default target environment', dotenvExpandFromProcessEnv, defaultEnv)
+        .option('--dotenv-token <string>', 'dotenv-expanded token indicating a dotenv file', dotenvExpandFromProcessEnv, dotenvToken)
+        .option('--dynamic-path <string>', 'dynamic variables path', dotenvExpandFromProcessEnv, dynamicPath)
+        .option('--paths <string>', 'dotenv-expanded delimited list of paths to dotenv directory', dotenvExpandFromProcessEnv, paths)
         .option('--paths-delimiter <string>', 'paths delimiter string', pathsDelimiter)
         .option('--paths-delimiter-pattern <string>', 'paths delimiter regex pattern', pathsDelimiterPattern)
-        .option('--private-token <string>', 'dotenv-expanded token indicating private variables', dotenvExpandDefault, privateToken)
+        .option('--private-token <string>', 'dotenv-expanded token indicating private variables', dotenvExpandFromProcessEnv, privateToken)
         .option('--vars-delimiter <string>', 'vars delimiter string', varsDelimiter)
         .option('--vars-delimiter-pattern <string>', 'vars delimiter regex pattern', varsDelimiterPattern)
         .option('--vars-assignor <string>', 'vars assignment operator string', varsAssignor)
@@ -26407,12 +26411,18 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         .enablePositionalOptions()
         .passThroughOptions()
         .action(async (options, command) => {
-        const { args } = command;
-        if (args.length)
-            await execaCommand(args.join(platform === 'win32' ? '\\ ' : ' '), {
+        const { args, getDotenvOptions: { debug }, } = command.parent;
+        if (args.length) {
+            if (debug)
+                logger.log('\n*** raw shell args ***\n', args);
+            const shellCommand = args.join(' ');
+            if (debug)
+                logger.log('\n*** shell command ***\n', shellCommand);
+            await execaCommand(shellCommand, {
                 stdio: 'inherit',
                 shell: true,
             });
+        }
     }), { isDefault: true })
         .hook('preSubcommand', async (thisCommand) => {
         const rawOptions = thisCommand.opts();
@@ -26478,8 +26488,10 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         if (postHook)
             await postHook(dotenv);
         // Execute shell command.
-        if (command)
-            await execaCommand(platform === 'win32' ? command.replace(/ /g, '\\ ') : command, {
+        if (command) {
+            if (cliOptions.debug)
+                logger.log('\n*** shell command ***\n', command);
+            await execaCommand(command, {
                 env: {
                     ...process.env,
                     getDotenvOptions: JSON.stringify(getDotenvOptions),
@@ -26487,7 +26499,8 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
                 shell: true,
                 stdio: 'inherit',
             });
+        }
     });
 };
 
-export { dotenvExpand, dotenvExpandAll, generateGetDotenvCli, getDotenv };
+export { dotenvExpand, dotenvExpandAll, dotenvExpandFromProcessEnv, generateGetDotenvCli, getDotenv };

package/package.json

@@ -75,7 +75,6 @@
   ],
   "homepage": "https://github.com/karmaniverous/get-dotenv#readme",
   "keywords": [
-    "async-programming",
     "cli",
     "configuration",
     "developer-tools",
@@ -85,11 +84,7 @@
     "environment-variables",
     "json",
     "nodejs",
-    "programming",
-    "software-development",
-    "sync-programming",
-    "typescript",
-    "yaml"
+    "typescript"
   ],
   "license": "BSD-3-Clause",
   "main": "./lib/index.js",
@@ -135,5 +130,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "4.0.0-0"
+  "version": "4.0.0-2"
 }