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

package/dist/getdotenv.cli.mjs

@@ -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 : {};
 
@@ -26342,10 +26352,6 @@ const getDotenv = async (options = {}) => {
 
 // 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 +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'))
@@ -26390,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)

package/dist/index.cjs

@@ -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 : {};
 
@@ -26344,10 +26354,6 @@ const getDotenv = async (options = {}) => {
 
 // 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 +26371,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 +26398,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)
@@ -26495,5 +26501,6 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
 
 exports.dotenvExpand = dotenvExpand;
 exports.dotenvExpandAll = dotenvExpandAll;
+exports.dotenvExpandFromProcessEnv = dotenvExpandFromProcessEnv;
 exports.generateGetDotenvCli = generateGetDotenvCli;
 exports.getDotenv = getDotenv;

package/dist/index.d.cts

@@ -148,6 +148,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 +241,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

@@ -148,6 +148,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 +241,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

@@ -148,6 +148,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 +241,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

@@ -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 : {};
 
@@ -26341,10 +26351,6 @@ const getDotenv = async (options = {}) => {
 
 // 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 +26368,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 +26395,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)
@@ -26490,4 +26496,4 @@ const generateGetDotenvCli = ({ logger = console, preHook, postHook, ...cliOptio
     });
 };
 
-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-1"
 }