@karmaniverous/get-dotenv 4.1.0 → 4.2.1

package/README.md

@@ -121,7 +121,7 @@ You can also use `getdotenv` from the command line:
 #   --vars-delimiter-pattern <string>   vars delimiter regex pattern
 #   --vars-assignor <string>            vars assignment operator string (default: "=")
 #   --vars-assignor-pattern <string>    vars assignment operator regex pattern
-  -h, --help                          display help for command
+#   -h, --help                          display help for command
 #
 # Commands:
 #   batch [options]                     Batch shell commands across multiple working directories.

package/dist/getdotenv.cli.mjs

@@ -25764,6 +25764,7 @@ const defaultGetDotenvCliOptionsGlobal = {
     paths: './',
     pathsDelimiter: ' ',
     privateToken: 'local',
+    shellScripts: {},
     vars: '',
     varsAssignor: '=',
     varsDelimiter: ' ',
@@ -25800,6 +25801,10 @@ const defaultGetDotenvCliOptionsLocal = (fs$a.existsSync(defaultGetDotenvCliOpti
 const mergeGetDotenvOptions = (target = {}, source = {}) => ({
     ...source,
     ...target,
+    shellScripts: {
+        ...(source.shellScripts ?? {}),
+        ...(target.shellScripts ?? {}),
+    },
     vars: _.pickBy({
         ...(source.vars ?? {}),
         ...(target.vars ?? {}),
@@ -25832,6 +25837,10 @@ const getDotenvCliOptions2Options = ({ paths, pathsDelimiter, pathsDelimiterPatt
 const getDotenvDefaultOptions = getDotenvCliOptions2Options({
     ...defaultGetDotenvCliOptionsGlobal,
     ...defaultGetDotenvCliOptionsLocal,
+    shellScripts: {
+        ...(defaultGetDotenvCliOptionsGlobal.shellScripts ?? {}),
+        ...(defaultGetDotenvCliOptionsLocal.shellScripts ?? {}),
+    },
 });
 
 var main$1 = {exports: {}};
@@ -34108,14 +34117,14 @@ const globPaths = async ({ globs, logger, pkgCwd, rootPath, }) => {
         cwd = pkgDir;
     }
     const absRootPath = require$$0$1.posix.join(cwd.split(require$$0$1.sep).join(require$$0$1.posix.sep), rootPath.split(require$$0$1.sep).join(require$$0$1.posix.sep));
-    const paths = await globby(globs, {
+    const paths = await globby(globs.split(/\s+/), {
         cwd: absRootPath,
         expandDirectories: false,
         onlyDirectories: true,
         absolute: true,
     });
     if (!paths.length) {
-        logger.error(`No paths found for globs '${globs.toString()}' at '${absRootPath}'.`);
+        logger.error(`No paths found for globs '${globs}' at '${absRootPath}'.`);
         process.exit(0);
     }
     return { absRootPath, paths };
@@ -34136,7 +34145,7 @@ const execShellCommandBatch = async ({ command, globs, ignoreErrors, list, logge
         : 'Executing shell command batch...';
     logger.info('');
     const headerRootPath = `ROOT:  ${absRootPath}`;
-    const headerGlobs = `GLOBS: ${globs.toString()}`;
+    const headerGlobs = `GLOBS: ${globs}`;
     const headerCommand = `CMD:   ${command}`;
     logger.info('*'.repeat(Math.max(headerTitle.length, headerRootPath.length, headerGlobs.length, headerCommand.length)));
     logger.info(headerTitle);
@@ -34183,18 +34192,21 @@ const cmdCommand$1 = new Command()
         throw new Error(`unable to resolve parent command`);
     if (!thisCommand.parent.parent)
         throw new Error(`unable to resolve root command`);
-    const { getDotenvOptions: { logger = console }, } = thisCommand.parent.parent;
+    const { getDotenvOptions: { logger = console, shellScripts }, } = thisCommand.parent.parent;
     const { ignoreErrors, globs, list, pkgCwd, rootPath } = thisCommand.parent.opts();
     // Execute shell command.
-    await execShellCommandBatch({
-        command: thisCommand.args.join(' '),
-        globs,
-        ignoreErrors,
-        list,
-        logger,
-        pkgCwd,
-        rootPath,
-    });
+    {
+        const command = thisCommand.args.join(' ');
+        await execShellCommandBatch({
+            command: shellScripts?.[command] ?? command,
+            globs,
+            ignoreErrors,
+            list,
+            logger,
+            pkgCwd,
+            rootPath,
+        });
+    }
 });
 
 const batchCommand = new Command()
@@ -34204,14 +34216,14 @@ const batchCommand = new Command()
     .passThroughOptions()
     .option('-p, --pkg-cwd', 'use nearest package directory as current working directory')
     .option('-r, --root-path <string>', 'path to batch root directory from current working directory', './')
-    .option('-g, --globs <strings...>', 'space-delimited globs from root path', '*')
+    .option('-g, --globs <string>', 'space-delimited globs from root path', '*')
     .option('-c, --command <string>', 'shell command string, conflicts with cmd subcommand (dotenv-expanded)', dotenvExpandFromProcessEnv)
     .option('-l, --list', 'list working directories without executing command')
     .option('-e, --ignore-errors', 'ignore errors and continue with next path')
     .hook('preSubcommand', async (thisCommand) => {
     if (!thisCommand.parent)
         throw new Error(`unable to resolve root command`);
-    const { getDotenvOptions: { logger = console }, } = thisCommand.parent;
+    const { getDotenvOptions: { logger = console, shellScripts }, } = thisCommand.parent;
     const { command, ignoreErrors, globs, list, pkgCwd, rootPath } = thisCommand.opts();
     if (command && thisCommand.args.length) {
         logger.error(`--command option conflicts with cmd subcommand.`);
@@ -34220,7 +34232,7 @@ const batchCommand = new Command()
     // Execute shell command.
     if (command)
         await execShellCommandBatch({
-            command,
+            command: shellScripts?.[command] ?? command,
             globs,
             ignoreErrors,
             list,
@@ -34238,12 +34250,15 @@ const cmdCommand = new Command()
     .enablePositionalOptions()
     .passThroughOptions()
     .action(async (options, thisCommand) => {
+    if (thisCommand.args.length === 0)
+        return;
     if (!thisCommand.parent)
         throw new Error('parent command not found');
-    const { getDotenvOptions: { debug, logger = console }, } = thisCommand.parent;
-    const shellCommand = thisCommand.args.join(' ');
+    const { getDotenvOptions: { debug, logger = console, shellScripts }, } = thisCommand.parent;
+    const command = thisCommand.args.join(' ');
+    const shellCommand = shellScripts?.[command] ?? command;
     if (debug)
-        logger.log('\n*** shell command ***\n', shellCommand);
+        logger.log('\n*** shell command ***\n', `'${shellCommand}'`);
     await execaCommand(shellCommand, {
         shell: true,
         stdio: 'inherit',
@@ -34254,10 +34269,15 @@ const cmdCommand = new Command()
  * Generate a Commander CLI Command for get-dotenv.
  */
 const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptionsCustom } = {}) => {
-    const { alias = 'getdotenv', debug, defaultEnv, description = 'Base CLI.', dotenvToken, dynamicPath, env, excludeDynamic, excludeEnv, excludeGlobal, excludePrivate, excludePublic, loadProcess, log, outputPath, paths, pathsDelimiter, pathsDelimiterPattern, privateToken, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, } = {
+    const { alias = 'getdotenv', debug, defaultEnv, description = 'Base CLI.', dotenvToken, dynamicPath, env, excludeDynamic, excludeEnv, excludeGlobal, excludePrivate, excludePublic, loadProcess, log, outputPath, paths, pathsDelimiter, pathsDelimiterPattern, privateToken, shellScripts, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, } = {
         ...defaultGetDotenvCliOptionsGlobal,
         ...cliOptionsCustom,
         ...defaultGetDotenvCliOptionsLocal,
+        shellScripts: {
+            ...(defaultGetDotenvCliOptionsGlobal.shellScripts ?? {}),
+            ...(cliOptionsCustom.shellScripts ?? {}),
+            ...(defaultGetDotenvCliOptionsLocal.shellScripts ?? {}),
+        },
     };
     const excludeAll = !!excludeDynamic &&
         ((!!excludeEnv && !!excludeGlobal) ||
@@ -34305,6 +34325,9 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         .option('--vars-delimiter-pattern <string>', 'vars delimiter regex pattern', varsDelimiterPattern)
         .option('--vars-assignor <string>', 'vars assignment operator string', varsAssignor)
         .option('--vars-assignor-pattern <string>', 'vars assignment operator regex pattern', varsAssignorPattern)
+        .addOption(new Option('--shell-scripts <string>')
+        .default(JSON.stringify(shellScripts))
+        .hideHelp())
         .addCommand(batchCommand)
         .addCommand(cmdCommand, { isDefault: true })
         .hook('preSubcommand', async (thisCommand) => {
@@ -34312,7 +34335,12 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         if (rawOptions.debug)
             logger.log('\n*** raw cli options ***\n', { rawOptions });
         // Load options.
-        const { command, debugOff, excludeAll, excludeAllOff, excludeDynamicOff, excludeEnvOff, excludeGlobalOff, excludePrivateOff, excludePublicOff, loadProcessOff, logOff, ...cliOptions } = rawOptions;
+        const { command, debugOff, excludeAll, excludeAllOff, excludeDynamicOff, excludeEnvOff, excludeGlobalOff, excludePrivateOff, excludePublicOff, loadProcessOff, logOff, ...cliOptions } = {
+            ...rawOptions,
+            shellScripts: rawOptions.shellScripts
+                ? JSON.parse(rawOptions.shellScripts)
+                : undefined,
+        };
         // Resolve flags.
         const resolveExclusion = (exclude, excludeOff, defaultValue) => exclude
             ? true
@@ -34351,10 +34379,7 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
             ? JSON.parse(process.env.getDotenvOptions)
             : {});
         const cliGetDotenvOptions = getDotenvCliOptions2Options(cliOptions);
-        const getDotenvOptions = {
-            ...parentGetdotenvOptions,
-            ...cliGetDotenvOptions,
-        };
+        const getDotenvOptions = mergeGetDotenvOptions(cliGetDotenvOptions, parentGetdotenvOptions);
         if (cliOptions.debug)
             logger.log('\n*** getdotenv option resolution ***\n', {
                 parentGetdotenvOptions,
@@ -34362,9 +34387,9 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
                 getDotenvOptions,
             });
         // Execute getdotenv.
-        const getDotenvOptionsWithLogger = { ...getDotenvOptions, logger };
-        _.set(thisCommand, 'getDotenvOptions', getDotenvOptionsWithLogger);
-        const dotenv = await getDotenv(getDotenvOptionsWithLogger);
+        const getDotenvOptionsProp = { ...getDotenvOptions, logger };
+        _.set(thisCommand, 'getDotenvOptions', getDotenvOptionsProp);
+        const dotenv = await getDotenv(getDotenvOptionsProp);
         if (cliOptions.debug)
             logger.log('\n*** resulting dotenv values ***\n', { dotenv });
         // Execute post-hook.
@@ -34376,9 +34401,10 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
             process.exit(0);
         }
         if (command) {
+            const shellCommand = getDotenvOptionsProp.shellScripts?.[command] ?? command;
             if (cliOptions.debug)
-                logger.log('\n*** shell command ***\n', command);
-            await execaCommand(command, {
+                logger.log('\n*** shell command ***\n', shellCommand);
+            await execaCommand(shellCommand, {
                 env: {
                     ...process.env,
                     getDotenvOptions: JSON.stringify(getDotenvOptions),

package/dist/index.cjs

@@ -25766,6 +25766,7 @@ const defaultGetDotenvCliOptionsGlobal = {
     paths: './',
     pathsDelimiter: ' ',
     privateToken: 'local',
+    shellScripts: {},
     vars: '',
     varsAssignor: '=',
     varsDelimiter: ' ',
@@ -25802,6 +25803,10 @@ const defaultGetDotenvCliOptionsLocal = (fs$a.existsSync(defaultGetDotenvCliOpti
 const mergeGetDotenvOptions = (target = {}, source = {}) => ({
     ...source,
     ...target,
+    shellScripts: {
+        ...(source.shellScripts ?? {}),
+        ...(target.shellScripts ?? {}),
+    },
     vars: _.pickBy({
         ...(source.vars ?? {}),
         ...(target.vars ?? {}),
@@ -25834,6 +25839,10 @@ const getDotenvCliOptions2Options = ({ paths, pathsDelimiter, pathsDelimiterPatt
 const getDotenvDefaultOptions = getDotenvCliOptions2Options({
     ...defaultGetDotenvCliOptionsGlobal,
     ...defaultGetDotenvCliOptionsLocal,
+    shellScripts: {
+        ...(defaultGetDotenvCliOptionsGlobal.shellScripts ?? {}),
+        ...(defaultGetDotenvCliOptionsLocal.shellScripts ?? {}),
+    },
 });
 
 var main$1 = {exports: {}};
@@ -34110,14 +34119,14 @@ const globPaths = async ({ globs, logger, pkgCwd, rootPath, }) => {
         cwd = pkgDir;
     }
     const absRootPath = require$$0$1.posix.join(cwd.split(require$$0$1.sep).join(require$$0$1.posix.sep), rootPath.split(require$$0$1.sep).join(require$$0$1.posix.sep));
-    const paths = await globby(globs, {
+    const paths = await globby(globs.split(/\s+/), {
         cwd: absRootPath,
         expandDirectories: false,
         onlyDirectories: true,
         absolute: true,
     });
     if (!paths.length) {
-        logger.error(`No paths found for globs '${globs.toString()}' at '${absRootPath}'.`);
+        logger.error(`No paths found for globs '${globs}' at '${absRootPath}'.`);
         process.exit(0);
     }
     return { absRootPath, paths };
@@ -34138,7 +34147,7 @@ const execShellCommandBatch = async ({ command, globs, ignoreErrors, list, logge
         : 'Executing shell command batch...';
     logger.info('');
     const headerRootPath = `ROOT:  ${absRootPath}`;
-    const headerGlobs = `GLOBS: ${globs.toString()}`;
+    const headerGlobs = `GLOBS: ${globs}`;
     const headerCommand = `CMD:   ${command}`;
     logger.info('*'.repeat(Math.max(headerTitle.length, headerRootPath.length, headerGlobs.length, headerCommand.length)));
     logger.info(headerTitle);
@@ -34185,18 +34194,21 @@ const cmdCommand$1 = new Command()
         throw new Error(`unable to resolve parent command`);
     if (!thisCommand.parent.parent)
         throw new Error(`unable to resolve root command`);
-    const { getDotenvOptions: { logger = console }, } = thisCommand.parent.parent;
+    const { getDotenvOptions: { logger = console, shellScripts }, } = thisCommand.parent.parent;
     const { ignoreErrors, globs, list, pkgCwd, rootPath } = thisCommand.parent.opts();
     // Execute shell command.
-    await execShellCommandBatch({
-        command: thisCommand.args.join(' '),
-        globs,
-        ignoreErrors,
-        list,
-        logger,
-        pkgCwd,
-        rootPath,
-    });
+    {
+        const command = thisCommand.args.join(' ');
+        await execShellCommandBatch({
+            command: shellScripts?.[command] ?? command,
+            globs,
+            ignoreErrors,
+            list,
+            logger,
+            pkgCwd,
+            rootPath,
+        });
+    }
 });
 
 const batchCommand = new Command()
@@ -34206,14 +34218,14 @@ const batchCommand = new Command()
     .passThroughOptions()
     .option('-p, --pkg-cwd', 'use nearest package directory as current working directory')
     .option('-r, --root-path <string>', 'path to batch root directory from current working directory', './')
-    .option('-g, --globs <strings...>', 'space-delimited globs from root path', '*')
+    .option('-g, --globs <string>', 'space-delimited globs from root path', '*')
     .option('-c, --command <string>', 'shell command string, conflicts with cmd subcommand (dotenv-expanded)', dotenvExpandFromProcessEnv)
     .option('-l, --list', 'list working directories without executing command')
     .option('-e, --ignore-errors', 'ignore errors and continue with next path')
     .hook('preSubcommand', async (thisCommand) => {
     if (!thisCommand.parent)
         throw new Error(`unable to resolve root command`);
-    const { getDotenvOptions: { logger = console }, } = thisCommand.parent;
+    const { getDotenvOptions: { logger = console, shellScripts }, } = thisCommand.parent;
     const { command, ignoreErrors, globs, list, pkgCwd, rootPath } = thisCommand.opts();
     if (command && thisCommand.args.length) {
         logger.error(`--command option conflicts with cmd subcommand.`);
@@ -34222,7 +34234,7 @@ const batchCommand = new Command()
     // Execute shell command.
     if (command)
         await execShellCommandBatch({
-            command,
+            command: shellScripts?.[command] ?? command,
             globs,
             ignoreErrors,
             list,
@@ -34240,12 +34252,15 @@ const cmdCommand = new Command()
     .enablePositionalOptions()
     .passThroughOptions()
     .action(async (options, thisCommand) => {
+    if (thisCommand.args.length === 0)
+        return;
     if (!thisCommand.parent)
         throw new Error('parent command not found');
-    const { getDotenvOptions: { debug, logger = console }, } = thisCommand.parent;
-    const shellCommand = thisCommand.args.join(' ');
+    const { getDotenvOptions: { debug, logger = console, shellScripts }, } = thisCommand.parent;
+    const command = thisCommand.args.join(' ');
+    const shellCommand = shellScripts?.[command] ?? command;
     if (debug)
-        logger.log('\n*** shell command ***\n', shellCommand);
+        logger.log('\n*** shell command ***\n', `'${shellCommand}'`);
     await execaCommand(shellCommand, {
         shell: true,
         stdio: 'inherit',
@@ -34256,10 +34271,15 @@ const cmdCommand = new Command()
  * Generate a Commander CLI Command for get-dotenv.
  */
 const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptionsCustom } = {}) => {
-    const { alias = 'getdotenv', debug, defaultEnv, description = 'Base CLI.', dotenvToken, dynamicPath, env, excludeDynamic, excludeEnv, excludeGlobal, excludePrivate, excludePublic, loadProcess, log, outputPath, paths, pathsDelimiter, pathsDelimiterPattern, privateToken, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, } = {
+    const { alias = 'getdotenv', debug, defaultEnv, description = 'Base CLI.', dotenvToken, dynamicPath, env, excludeDynamic, excludeEnv, excludeGlobal, excludePrivate, excludePublic, loadProcess, log, outputPath, paths, pathsDelimiter, pathsDelimiterPattern, privateToken, shellScripts, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, } = {
         ...defaultGetDotenvCliOptionsGlobal,
         ...cliOptionsCustom,
         ...defaultGetDotenvCliOptionsLocal,
+        shellScripts: {
+            ...(defaultGetDotenvCliOptionsGlobal.shellScripts ?? {}),
+            ...(cliOptionsCustom.shellScripts ?? {}),
+            ...(defaultGetDotenvCliOptionsLocal.shellScripts ?? {}),
+        },
     };
     const excludeAll = !!excludeDynamic &&
         ((!!excludeEnv && !!excludeGlobal) ||
@@ -34307,6 +34327,9 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         .option('--vars-delimiter-pattern <string>', 'vars delimiter regex pattern', varsDelimiterPattern)
         .option('--vars-assignor <string>', 'vars assignment operator string', varsAssignor)
         .option('--vars-assignor-pattern <string>', 'vars assignment operator regex pattern', varsAssignorPattern)
+        .addOption(new Option('--shell-scripts <string>')
+        .default(JSON.stringify(shellScripts))
+        .hideHelp())
         .addCommand(batchCommand)
         .addCommand(cmdCommand, { isDefault: true })
         .hook('preSubcommand', async (thisCommand) => {
@@ -34314,7 +34337,12 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         if (rawOptions.debug)
             logger.log('\n*** raw cli options ***\n', { rawOptions });
         // Load options.
-        const { command, debugOff, excludeAll, excludeAllOff, excludeDynamicOff, excludeEnvOff, excludeGlobalOff, excludePrivateOff, excludePublicOff, loadProcessOff, logOff, ...cliOptions } = rawOptions;
+        const { command, debugOff, excludeAll, excludeAllOff, excludeDynamicOff, excludeEnvOff, excludeGlobalOff, excludePrivateOff, excludePublicOff, loadProcessOff, logOff, ...cliOptions } = {
+            ...rawOptions,
+            shellScripts: rawOptions.shellScripts
+                ? JSON.parse(rawOptions.shellScripts)
+                : undefined,
+        };
         // Resolve flags.
         const resolveExclusion = (exclude, excludeOff, defaultValue) => exclude
             ? true
@@ -34353,10 +34381,7 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
             ? JSON.parse(process.env.getDotenvOptions)
             : {});
         const cliGetDotenvOptions = getDotenvCliOptions2Options(cliOptions);
-        const getDotenvOptions = {
-            ...parentGetdotenvOptions,
-            ...cliGetDotenvOptions,
-        };
+        const getDotenvOptions = mergeGetDotenvOptions(cliGetDotenvOptions, parentGetdotenvOptions);
         if (cliOptions.debug)
             logger.log('\n*** getdotenv option resolution ***\n', {
                 parentGetdotenvOptions,
@@ -34364,9 +34389,9 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
                 getDotenvOptions,
             });
         // Execute getdotenv.
-        const getDotenvOptionsWithLogger = { ...getDotenvOptions, logger };
-        _.set(thisCommand, 'getDotenvOptions', getDotenvOptionsWithLogger);
-        const dotenv = await getDotenv(getDotenvOptionsWithLogger);
+        const getDotenvOptionsProp = { ...getDotenvOptions, logger };
+        _.set(thisCommand, 'getDotenvOptions', getDotenvOptionsProp);
+        const dotenv = await getDotenv(getDotenvOptionsProp);
         if (cliOptions.debug)
             logger.log('\n*** resulting dotenv values ***\n', { dotenv });
         // Execute post-hook.
@@ -34378,9 +34403,10 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
             process.exit(0);
         }
         if (command) {
+            const shellCommand = getDotenvOptionsProp.shellScripts?.[command] ?? command;
             if (cliOptions.debug)
-                logger.log('\n*** shell command ***\n', command);
-            await execaCommand(command, {
+                logger.log('\n*** shell command ***\n', shellCommand);
+            await execaCommand(shellCommand, {
                 env: {
                     ...process.env,
                     getDotenvOptions: JSON.stringify(getDotenvOptions),

package/dist/index.d.cts

@@ -5,7 +5,7 @@ import { Command } from '@commander-js/extra-typings';
  */
 interface GetDotenvCliOptions extends Omit<GetDotenvOptions, 'paths' | 'vars'> {
     /**
-     * Cli alias. Should align with the `bin` property in `package.json`.
+     * CLI alias. Should align with the `bin` property in `package.json`.
      */
     alias?: string;
     /**
@@ -129,6 +129,10 @@ interface GetDotenvOptions {
      * filename token indicating private variables
      */
     privateToken?: string;
+    /**
+     * Shell scripts that can be executed from the CLI, either individually or via the batch subcommand.
+     */
+    shellScripts?: Record<string, string>;
     /**
      * explicit variables to include
      */

package/dist/index.d.mts

@@ -5,7 +5,7 @@ import { Command } from '@commander-js/extra-typings';
  */
 interface GetDotenvCliOptions extends Omit<GetDotenvOptions, 'paths' | 'vars'> {
     /**
-     * Cli alias. Should align with the `bin` property in `package.json`.
+     * CLI alias. Should align with the `bin` property in `package.json`.
      */
     alias?: string;
     /**
@@ -129,6 +129,10 @@ interface GetDotenvOptions {
      * filename token indicating private variables
      */
     privateToken?: string;
+    /**
+     * Shell scripts that can be executed from the CLI, either individually or via the batch subcommand.
+     */
+    shellScripts?: Record<string, string>;
     /**
      * explicit variables to include
      */

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import { Command } from '@commander-js/extra-typings';
  */
 interface GetDotenvCliOptions extends Omit<GetDotenvOptions, 'paths' | 'vars'> {
     /**
-     * Cli alias. Should align with the `bin` property in `package.json`.
+     * CLI alias. Should align with the `bin` property in `package.json`.
      */
     alias?: string;
     /**
@@ -129,6 +129,10 @@ interface GetDotenvOptions {
      * filename token indicating private variables
      */
     privateToken?: string;
+    /**
+     * Shell scripts that can be executed from the CLI, either individually or via the batch subcommand.
+     */
+    shellScripts?: Record<string, string>;
     /**
      * explicit variables to include
      */

package/dist/index.mjs

@@ -25763,6 +25763,7 @@ const defaultGetDotenvCliOptionsGlobal = {
     paths: './',
     pathsDelimiter: ' ',
     privateToken: 'local',
+    shellScripts: {},
     vars: '',
     varsAssignor: '=',
     varsDelimiter: ' ',
@@ -25799,6 +25800,10 @@ const defaultGetDotenvCliOptionsLocal = (fs$a.existsSync(defaultGetDotenvCliOpti
 const mergeGetDotenvOptions = (target = {}, source = {}) => ({
     ...source,
     ...target,
+    shellScripts: {
+        ...(source.shellScripts ?? {}),
+        ...(target.shellScripts ?? {}),
+    },
     vars: _.pickBy({
         ...(source.vars ?? {}),
         ...(target.vars ?? {}),
@@ -25831,6 +25836,10 @@ const getDotenvCliOptions2Options = ({ paths, pathsDelimiter, pathsDelimiterPatt
 const getDotenvDefaultOptions = getDotenvCliOptions2Options({
     ...defaultGetDotenvCliOptionsGlobal,
     ...defaultGetDotenvCliOptionsLocal,
+    shellScripts: {
+        ...(defaultGetDotenvCliOptionsGlobal.shellScripts ?? {}),
+        ...(defaultGetDotenvCliOptionsLocal.shellScripts ?? {}),
+    },
 });
 
 var main$1 = {exports: {}};
@@ -34107,14 +34116,14 @@ const globPaths = async ({ globs, logger, pkgCwd, rootPath, }) => {
         cwd = pkgDir;
     }
     const absRootPath = require$$0$1.posix.join(cwd.split(require$$0$1.sep).join(require$$0$1.posix.sep), rootPath.split(require$$0$1.sep).join(require$$0$1.posix.sep));
-    const paths = await globby(globs, {
+    const paths = await globby(globs.split(/\s+/), {
         cwd: absRootPath,
         expandDirectories: false,
         onlyDirectories: true,
         absolute: true,
     });
     if (!paths.length) {
-        logger.error(`No paths found for globs '${globs.toString()}' at '${absRootPath}'.`);
+        logger.error(`No paths found for globs '${globs}' at '${absRootPath}'.`);
         process.exit(0);
     }
     return { absRootPath, paths };
@@ -34135,7 +34144,7 @@ const execShellCommandBatch = async ({ command, globs, ignoreErrors, list, logge
         : 'Executing shell command batch...';
     logger.info('');
     const headerRootPath = `ROOT:  ${absRootPath}`;
-    const headerGlobs = `GLOBS: ${globs.toString()}`;
+    const headerGlobs = `GLOBS: ${globs}`;
     const headerCommand = `CMD:   ${command}`;
     logger.info('*'.repeat(Math.max(headerTitle.length, headerRootPath.length, headerGlobs.length, headerCommand.length)));
     logger.info(headerTitle);
@@ -34182,18 +34191,21 @@ const cmdCommand$1 = new Command()
         throw new Error(`unable to resolve parent command`);
     if (!thisCommand.parent.parent)
         throw new Error(`unable to resolve root command`);
-    const { getDotenvOptions: { logger = console }, } = thisCommand.parent.parent;
+    const { getDotenvOptions: { logger = console, shellScripts }, } = thisCommand.parent.parent;
     const { ignoreErrors, globs, list, pkgCwd, rootPath } = thisCommand.parent.opts();
     // Execute shell command.
-    await execShellCommandBatch({
-        command: thisCommand.args.join(' '),
-        globs,
-        ignoreErrors,
-        list,
-        logger,
-        pkgCwd,
-        rootPath,
-    });
+    {
+        const command = thisCommand.args.join(' ');
+        await execShellCommandBatch({
+            command: shellScripts?.[command] ?? command,
+            globs,
+            ignoreErrors,
+            list,
+            logger,
+            pkgCwd,
+            rootPath,
+        });
+    }
 });
 
 const batchCommand = new Command()
@@ -34203,14 +34215,14 @@ const batchCommand = new Command()
     .passThroughOptions()
     .option('-p, --pkg-cwd', 'use nearest package directory as current working directory')
     .option('-r, --root-path <string>', 'path to batch root directory from current working directory', './')
-    .option('-g, --globs <strings...>', 'space-delimited globs from root path', '*')
+    .option('-g, --globs <string>', 'space-delimited globs from root path', '*')
     .option('-c, --command <string>', 'shell command string, conflicts with cmd subcommand (dotenv-expanded)', dotenvExpandFromProcessEnv)
     .option('-l, --list', 'list working directories without executing command')
     .option('-e, --ignore-errors', 'ignore errors and continue with next path')
     .hook('preSubcommand', async (thisCommand) => {
     if (!thisCommand.parent)
         throw new Error(`unable to resolve root command`);
-    const { getDotenvOptions: { logger = console }, } = thisCommand.parent;
+    const { getDotenvOptions: { logger = console, shellScripts }, } = thisCommand.parent;
     const { command, ignoreErrors, globs, list, pkgCwd, rootPath } = thisCommand.opts();
     if (command && thisCommand.args.length) {
         logger.error(`--command option conflicts with cmd subcommand.`);
@@ -34219,7 +34231,7 @@ const batchCommand = new Command()
     // Execute shell command.
     if (command)
         await execShellCommandBatch({
-            command,
+            command: shellScripts?.[command] ?? command,
             globs,
             ignoreErrors,
             list,
@@ -34237,12 +34249,15 @@ const cmdCommand = new Command()
     .enablePositionalOptions()
     .passThroughOptions()
     .action(async (options, thisCommand) => {
+    if (thisCommand.args.length === 0)
+        return;
     if (!thisCommand.parent)
         throw new Error('parent command not found');
-    const { getDotenvOptions: { debug, logger = console }, } = thisCommand.parent;
-    const shellCommand = thisCommand.args.join(' ');
+    const { getDotenvOptions: { debug, logger = console, shellScripts }, } = thisCommand.parent;
+    const command = thisCommand.args.join(' ');
+    const shellCommand = shellScripts?.[command] ?? command;
     if (debug)
-        logger.log('\n*** shell command ***\n', shellCommand);
+        logger.log('\n*** shell command ***\n', `'${shellCommand}'`);
     await execaCommand(shellCommand, {
         shell: true,
         stdio: 'inherit',
@@ -34253,10 +34268,15 @@ const cmdCommand = new Command()
  * Generate a Commander CLI Command for get-dotenv.
  */
 const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptionsCustom } = {}) => {
-    const { alias = 'getdotenv', debug, defaultEnv, description = 'Base CLI.', dotenvToken, dynamicPath, env, excludeDynamic, excludeEnv, excludeGlobal, excludePrivate, excludePublic, loadProcess, log, outputPath, paths, pathsDelimiter, pathsDelimiterPattern, privateToken, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, } = {
+    const { alias = 'getdotenv', debug, defaultEnv, description = 'Base CLI.', dotenvToken, dynamicPath, env, excludeDynamic, excludeEnv, excludeGlobal, excludePrivate, excludePublic, loadProcess, log, outputPath, paths, pathsDelimiter, pathsDelimiterPattern, privateToken, shellScripts, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, } = {
         ...defaultGetDotenvCliOptionsGlobal,
         ...cliOptionsCustom,
         ...defaultGetDotenvCliOptionsLocal,
+        shellScripts: {
+            ...(defaultGetDotenvCliOptionsGlobal.shellScripts ?? {}),
+            ...(cliOptionsCustom.shellScripts ?? {}),
+            ...(defaultGetDotenvCliOptionsLocal.shellScripts ?? {}),
+        },
     };
     const excludeAll = !!excludeDynamic &&
         ((!!excludeEnv && !!excludeGlobal) ||
@@ -34304,6 +34324,9 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         .option('--vars-delimiter-pattern <string>', 'vars delimiter regex pattern', varsDelimiterPattern)
         .option('--vars-assignor <string>', 'vars assignment operator string', varsAssignor)
         .option('--vars-assignor-pattern <string>', 'vars assignment operator regex pattern', varsAssignorPattern)
+        .addOption(new Option('--shell-scripts <string>')
+        .default(JSON.stringify(shellScripts))
+        .hideHelp())
         .addCommand(batchCommand)
         .addCommand(cmdCommand, { isDefault: true })
         .hook('preSubcommand', async (thisCommand) => {
@@ -34311,7 +34334,12 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
         if (rawOptions.debug)
             logger.log('\n*** raw cli options ***\n', { rawOptions });
         // Load options.
-        const { command, debugOff, excludeAll, excludeAllOff, excludeDynamicOff, excludeEnvOff, excludeGlobalOff, excludePrivateOff, excludePublicOff, loadProcessOff, logOff, ...cliOptions } = rawOptions;
+        const { command, debugOff, excludeAll, excludeAllOff, excludeDynamicOff, excludeEnvOff, excludeGlobalOff, excludePrivateOff, excludePublicOff, loadProcessOff, logOff, ...cliOptions } = {
+            ...rawOptions,
+            shellScripts: rawOptions.shellScripts
+                ? JSON.parse(rawOptions.shellScripts)
+                : undefined,
+        };
         // Resolve flags.
         const resolveExclusion = (exclude, excludeOff, defaultValue) => exclude
             ? true
@@ -34350,10 +34378,7 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
             ? JSON.parse(process.env.getDotenvOptions)
             : {});
         const cliGetDotenvOptions = getDotenvCliOptions2Options(cliOptions);
-        const getDotenvOptions = {
-            ...parentGetdotenvOptions,
-            ...cliGetDotenvOptions,
-        };
+        const getDotenvOptions = mergeGetDotenvOptions(cliGetDotenvOptions, parentGetdotenvOptions);
         if (cliOptions.debug)
             logger.log('\n*** getdotenv option resolution ***\n', {
                 parentGetdotenvOptions,
@@ -34361,9 +34386,9 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
                 getDotenvOptions,
             });
         // Execute getdotenv.
-        const getDotenvOptionsWithLogger = { ...getDotenvOptions, logger };
-        _.set(thisCommand, 'getDotenvOptions', getDotenvOptionsWithLogger);
-        const dotenv = await getDotenv(getDotenvOptionsWithLogger);
+        const getDotenvOptionsProp = { ...getDotenvOptions, logger };
+        _.set(thisCommand, 'getDotenvOptions', getDotenvOptionsProp);
+        const dotenv = await getDotenv(getDotenvOptionsProp);
         if (cliOptions.debug)
             logger.log('\n*** resulting dotenv values ***\n', { dotenv });
         // Execute post-hook.
@@ -34375,9 +34400,10 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
             process.exit(0);
         }
         if (command) {
+            const shellCommand = getDotenvOptionsProp.shellScripts?.[command] ?? command;
             if (cliOptions.debug)
-                logger.log('\n*** shell command ***\n', command);
-            await execaCommand(command, {
+                logger.log('\n*** shell command ***\n', shellCommand);
+            await execaCommand(shellCommand, {
                 env: {
                     ...process.env,
                     getDotenvOptions: JSON.stringify(getDotenvOptions),

package/package.json

@@ -131,5 +131,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "4.1.0"
+  "version": "4.2.1"
 }