@karmaniverous/get-dotenv 4.4.5 → 4.5.0

package/README.md

@@ -84,14 +84,17 @@ Since keys will be evaluated progressively, each successive key function will ha
 
 Even though the rest of your project is in TypeScript, the dynamic processing module SHOULD be in JavasScript.
 
-Think about it: the module is loaded via a dynamic import, with the file name determined at run time. You will have to jump through some hoops to get your bundler to compile this file, and you'll have to be careful to set `dynamicPath` to reference the compiled file. That's a lot of work for some very simple log.
+Think about it: the module is loaded via a dynamic import, with the file name determined at run time. If you write this module in TS, you'll have to jump through some hoops to get your bundler to compile this file, and you'll have to be careful to set `dynamicPath` to reference the compiled file. That's a lot of work to do for some very simple logic.
 
 BUT... if you must, then your dynamic module's default export should be of the `GetDotenvDynamic` type, which is defined [here](./src/GetDotenvOptions.ts) and looks like this:
 
 ```ts
 export type ProcessEnv = Record<string, string | undefined>;
 
-export type GetDotenvDynamicFunction = (vars: ProcessEnv) => string | undefined;
+export type GetDotenvDynamicFunction = (
+  vars: ProcessEnv,
+  env: string | undefined,
+) => string | undefined;
 
 export type GetDotenvDynamic = Record<
   string,
@@ -99,6 +102,8 @@ export type GetDotenvDynamic = Record<
 >;
 ```
 
+The second argumnt `env` of the `GetDotenvDynamicFunction` type is the environment token (if any) specified in the controlling `getDotenv` call.
+
 ## Command Line Interface
 
 You can also use `getdotenv` from the command line:

package/dist/getdotenv.cli.mjs

@@ -32886,7 +32886,7 @@ const getDotenv = async (options = {}) => {
                 for (const key in dynamic)
                     Object.assign(dotenv, {
                         [key]: _.isFunction(dynamic[key])
-                            ? dynamic[key](dotenv)
+                            ? dynamic[key](dotenv, env ?? defaultEnv)
                             : dynamic[key],
                     });
             }

package/dist/index.cjs

@@ -32887,7 +32887,7 @@ const getDotenv = async (options = {}) => {
                 for (const key in dynamic)
                     Object.assign(dotenv, {
                         [key]: _.isFunction(dynamic[key])
-                            ? dynamic[key](dotenv)
+                            ? dynamic[key](dotenv, env ?? defaultEnv)
                             : dynamic[key],
                     });
             }

package/dist/index.d.cts

@@ -66,7 +66,7 @@ interface GetDotenvCliOptions extends Omit<GetDotenvOptions, 'paths' | 'vars'> {
 }
 
 type ProcessEnv = Record<string, string | undefined>;
-type GetDotenvDynamicFunction = (vars: ProcessEnv) => string | undefined;
+type GetDotenvDynamicFunction = (vars: ProcessEnv, env: string | undefined) => string | undefined;
 type GetDotenvDynamic = Record<string, GetDotenvDynamicFunction | ReturnType<GetDotenvDynamicFunction>>;
 type Logger = Record<string, (...args: unknown[]) => void> | typeof console;
 /**

package/dist/index.d.mts

@@ -66,7 +66,7 @@ interface GetDotenvCliOptions extends Omit<GetDotenvOptions, 'paths' | 'vars'> {
 }
 
 type ProcessEnv = Record<string, string | undefined>;
-type GetDotenvDynamicFunction = (vars: ProcessEnv) => string | undefined;
+type GetDotenvDynamicFunction = (vars: ProcessEnv, env: string | undefined) => string | undefined;
 type GetDotenvDynamic = Record<string, GetDotenvDynamicFunction | ReturnType<GetDotenvDynamicFunction>>;
 type Logger = Record<string, (...args: unknown[]) => void> | typeof console;
 /**

package/dist/index.d.ts

@@ -66,7 +66,7 @@ interface GetDotenvCliOptions extends Omit<GetDotenvOptions, 'paths' | 'vars'> {
 }
 
 type ProcessEnv = Record<string, string | undefined>;
-type GetDotenvDynamicFunction = (vars: ProcessEnv) => string | undefined;
+type GetDotenvDynamicFunction = (vars: ProcessEnv, env: string | undefined) => string | undefined;
 type GetDotenvDynamic = Record<string, GetDotenvDynamicFunction | ReturnType<GetDotenvDynamicFunction>>;
 type Logger = Record<string, (...args: unknown[]) => void> | typeof console;
 /**

package/dist/index.mjs

@@ -32885,7 +32885,7 @@ const getDotenv = async (options = {}) => {
                 for (const key in dynamic)
                     Object.assign(dotenv, {
                         [key]: _.isFunction(dynamic[key])
-                            ? dynamic[key](dotenv)
+                            ? dynamic[key](dotenv, env ?? defaultEnv)
                             : dynamic[key],
                     });
             }

package/package.json

@@ -135,5 +135,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "4.4.5"
+  "version": "4.5.0"
 }