@karmaniverous/get-dotenv 7.0.2 → 7.0.4

package/dist/chunks/{parseKnownFiles-CewXrtbo.mjs → parseKnownFiles-BZNrX_JE.mjs}

@@ -1,4 +1,4 @@
-import { at as loadSharedConfigFiles } from './index-CGG9e0xu.mjs';
+import { at as loadSharedConfigFiles } from './index-BuxEK_Z4.mjs';
 
 const mergeConfigFiles = (...files) => {
     const merged = {};

package/dist/chunks/{readMergedOptions-atT1xkoe.mjs → readMergedOptions-CraAnYdB.mjs}

@@ -10,7 +10,7 @@ import 'node:buffer';
 import 'crypto';
 import { fileURLToPath } from 'url';
 import 'dotenv';
-import { g as getDotenvOptionsSchemaResolved, r as resolveGetDotenvConfigSources } from './loader-CE4HSRN4.mjs';
+import { g as getDotenvOptionsSchemaResolved, r as resolveGetDotenvConfigSources } from './loader-V1vbmtyw.mjs';
 import { packageDirectory } from 'package-directory';
 
 /**
@@ -143,6 +143,7 @@ const baseScripts = {
  * @public
  */
 const baseRootOptionDefaults = {
+    defaultEnvKey: 'DEFAULT_ENV',
     dotenvToken: '.env',
     loadProcess: true,
     logger: console,
@@ -355,8 +356,29 @@ const computeContext = async (customOptions, plugins, hostMetaUrl) => {
     const validated = getDotenvOptionsSchemaResolved.parse(optionsResolved);
     // Discover config sources.
     const sources = await resolveGetDotenvConfigSources(hostMetaUrl);
+    // Pre-pass: read global-only files to resolve defaultEnvKey (skip when env is explicit).
+    let fileDefaultEnv;
+    if (!validated.env) {
+        const defaultEnvKey = validated.defaultEnvKey ?? 'DEFAULT_ENV';
+        const prePass = await readDotenvCascadeWithProvenance({
+            paths: Array.isArray(validated.paths) ? validated.paths : [],
+            ...(typeof validated.dotenvToken === 'string'
+                ? { dotenvToken: validated.dotenvToken }
+                : {}),
+            ...(typeof validated.privateToken === 'string'
+                ? { privateToken: validated.privateToken }
+                : {}),
+            excludeEnv: true,
+        });
+        fileDefaultEnv = prePass.dotenv[defaultEnvKey];
+    }
+    // Resolution: env > fileDefaultEnv > defaultEnv
+    const envName = validated.env
+        ?? (typeof fileDefaultEnv === 'string' && fileDefaultEnv.length > 0
+            ? fileDefaultEnv
+            : undefined)
+        ?? validated.defaultEnv;
     // Base dotenv from files (with file provenance; no dynamics; no programmatic vars; no side effects).
-    const envName = validated.env ?? validated.defaultEnv;
     const fileRes = await readDotenvCascadeWithProvenance({
         paths: Array.isArray(validated.paths) ? validated.paths : [],
         ...(typeof validated.dotenvToken === 'string'
@@ -365,10 +387,7 @@ const computeContext = async (customOptions, plugins, hostMetaUrl) => {
         ...(typeof validated.privateToken === 'string'
             ? { privateToken: validated.privateToken }
             : {}),
-        ...(typeof validated.env === 'string' ? { env: validated.env } : {}),
-        ...(typeof validated.defaultEnv === 'string'
-            ? { defaultEnv: validated.defaultEnv }
-            : {}),
+        ...(typeof envName === 'string' ? { env: envName } : {}),
         ...(validated.excludeEnv === true ? { excludeEnv: true } : {}),
         ...(validated.excludeGlobal === true ? { excludeGlobal: true } : {}),
         ...(validated.excludePrivate === true ? { excludePrivate: true } : {}),
@@ -467,6 +486,7 @@ const computeContext = async (customOptions, plugins, hostMetaUrl) => {
         }
     }
     return {
+        ...(typeof envName === 'string' ? { env: envName } : {}),
         optionsResolved: validated,
         dotenv,
         dotenvProvenance,
@@ -549,7 +569,7 @@ function definePlugin(spec) {
  */
 const attachRootOptions = (program, defaults) => {
     const GROUP = 'base';
-    const { defaultEnv, dotenvToken, dynamicPath, env, outputPath, paths, pathsDelimiter, pathsDelimiterPattern, privateToken, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, } = defaults ?? {};
+    const { defaultEnv, defaultEnvKey, dotenvToken, dynamicPath, env, outputPath, paths, pathsDelimiter, pathsDelimiterPattern, privateToken, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, } = defaults ?? {};
     const va = typeof defaults?.varsAssignor === 'string' ? defaults.varsAssignor : '=';
     const vd = typeof defaults?.varsDelimiter === 'string' ? defaults.varsDelimiter : ' ';
     // Helper: append (default) tags for ON/OFF toggles
@@ -731,6 +751,12 @@ const attachRootOptions = (program, defaults) => {
             o1.default(defaultEnv);
         program.addOption(o1);
         program.setOptionGroup(o1, GROUP);
+        const o1b = new Option('--default-env-key <string>', 'env var name in global dotenv files that specifies the default environment (dotenv-expanded)');
+        o1b.argParser(dotenvExpandFromProcessEnv);
+        if (defaultEnvKey !== undefined)
+            o1b.default(defaultEnvKey);
+        program.addOption(o1b);
+        program.setOptionGroup(o1b, GROUP);
         const o2 = new Option('--dotenv-token <string>', 'dotenv-expanded token indicating a dotenv file');
         o2.argParser(dotenvExpandFromProcessEnv);
         if (dotenvToken !== undefined)

package/dist/chunks/{resolveCliOptions-BLSqCGm7.mjs → resolveCliOptions-BMBkWDYJ.mjs}

@@ -1,4 +1,4 @@
-import { c as baseRootOptionDefaults, d as defaultsDeep } from './readMergedOptions-atT1xkoe.mjs';
+import { c as baseRootOptionDefaults, d as defaultsDeep } from './readMergedOptions-CraAnYdB.mjs';
 import 'radash';
 import 'node:buffer';
 import 'fs-extra';

package/dist/chunks/{sdk-stream-mixin-CMdQ7nO8.mjs → sdk-stream-mixin-BL49AxZx.mjs}

@@ -1,5 +1,5 @@
 import { Writable, Readable } from 'node:stream';
-import { aS as toHex, a5 as fromArrayBuffer } from './index-CGG9e0xu.mjs';
+import { aS as toHex, a5 as fromArrayBuffer } from './index-BuxEK_Z4.mjs';
 
 const isReadableStream = (stream) => typeof ReadableStream === "function" &&
     (stream?.constructor?.name === ReadableStream.name || stream instanceof ReadableStream);

package/dist/chunks/{types-BdKCfPRW.mjs → types-BthqmnDr.mjs}

@@ -1,4 +1,4 @@
-import { g as definePlugin } from './readMergedOptions-atT1xkoe.mjs';
+import { g as definePlugin } from './readMergedOptions-CraAnYdB.mjs';
 
 /**
  * Create a namespace-only parent plugin (a group command) for composing plugins

package/dist/cli.d.ts

@@ -144,6 +144,7 @@ type DotenvProvenance = Record<string, DotenvProvenanceEntry[]>;
  */
 declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
     defaultEnv: z.ZodOptional<z.ZodString>;
+    defaultEnvKey: z.ZodOptional<z.ZodString>;
     dotenvToken: z.ZodOptional<z.ZodString>;
     dynamicPath: z.ZodOptional<z.ZodString>;
     dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -195,6 +196,7 @@ declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
  */
 declare const getDotenvOptionsSchemaResolved: z.ZodObject<{
     defaultEnv: z.ZodOptional<z.ZodString>;
+    defaultEnvKey: z.ZodOptional<z.ZodString>;
     dotenvToken: z.ZodOptional<z.ZodString>;
     dynamicPath: z.ZodOptional<z.ZodString>;
     dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -271,6 +273,8 @@ interface RootOptionsShape {
     redactPatterns?: string[];
     /** Default target environment when not specified. */
     defaultEnv?: string;
+    /** Env var name in global dotenv files that specifies the default environment. */
+    defaultEnvKey?: string;
     /** Token indicating a dotenv file (default: ".env"). */
     dotenvToken?: string;
     /** Path to dynamic variables module (default: undefined). */
@@ -319,6 +323,10 @@ type ScriptsTable<TShell extends string | boolean = string | boolean> = Record<s
  * @public
  */
 interface GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions> {
+    /**
+     * Effective environment name after resolution (explicit -e \> defaultEnvKey \> defaultEnv).
+     */
+    env?: string;
     /**
      * Fully resolved option bag used to compute this context.
      */

package/dist/cli.mjs

@@ -1,7 +1,7 @@
-export { c as createCli } from './chunks/createCli-wmAcTdWR.mjs';
+export { c as createCli } from './chunks/createCli-CVvh-dBp.mjs';
 import 'zod';
 import 'path';
-import './chunks/loader-CE4HSRN4.mjs';
+import './chunks/loader-V1vbmtyw.mjs';
 import 'fs-extra';
 import 'package-directory';
 import 'url';
@@ -13,16 +13,16 @@ import './chunks/loadModuleDefault-Dj8B3Stt.mjs';
 import 'crypto';
 import '@commander-js/extra-typings';
 import 'nanoid';
-import './chunks/readMergedOptions-atT1xkoe.mjs';
+import './chunks/readMergedOptions-CraAnYdB.mjs';
 import './chunks/readDotenvCascade-Dgx4SC1p.mjs';
 import 'dotenv';
 import 'execa';
 import './chunks/helpConfig-CGejgwWW.mjs';
-import './chunks/resolveCliOptions-BLSqCGm7.mjs';
+import './chunks/resolveCliOptions-BMBkWDYJ.mjs';
 import './chunks/validate-CDl0rE6k.mjs';
 import './plugins-aws.mjs';
 import './chunks/spawnEnv-CKgnHGpr.mjs';
-import './chunks/index-CGG9e0xu.mjs';
+import './chunks/index-BuxEK_Z4.mjs';
 import 'node:os';
 import 'node:fs/promises';
 import 'node:stream';
@@ -33,7 +33,7 @@ import 'node:process';
 import './plugins-batch.mjs';
 import './chunks/invoke-DuRPU1oC.mjs';
 import 'globby';
-import './chunks/index-BhMXFr37.mjs';
+import './chunks/index-Dd6S1nZ-.mjs';
 import './plugins-init.mjs';
 import 'readline/promises';
 import 'node:url';

package/dist/cliHost.d.ts

@@ -145,6 +145,7 @@ type DotenvProvenance = Record<string, DotenvProvenanceEntry[]>;
  */
 declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
     defaultEnv: z.ZodOptional<z.ZodString>;
+    defaultEnvKey: z.ZodOptional<z.ZodString>;
     dotenvToken: z.ZodOptional<z.ZodString>;
     dynamicPath: z.ZodOptional<z.ZodString>;
     dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -196,6 +197,7 @@ declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
  */
 declare const getDotenvOptionsSchemaResolved: z.ZodObject<{
     defaultEnv: z.ZodOptional<z.ZodString>;
+    defaultEnvKey: z.ZodOptional<z.ZodString>;
     dotenvToken: z.ZodOptional<z.ZodString>;
     dynamicPath: z.ZodOptional<z.ZodString>;
     dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -272,6 +274,8 @@ interface RootOptionsShape {
     redactPatterns?: string[];
     /** Default target environment when not specified. */
     defaultEnv?: string;
+    /** Env var name in global dotenv files that specifies the default environment. */
+    defaultEnvKey?: string;
     /** Token indicating a dotenv file (default: ".env"). */
     dotenvToken?: string;
     /** Path to dynamic variables module (default: undefined). */
@@ -325,6 +329,10 @@ declare const defineScripts: <TShell extends string | boolean>() => <T extends S
  * @public
  */
 interface GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions> {
+    /**
+     * Effective environment name after resolution (explicit -e \> defaultEnvKey \> defaultEnv).
+     */
+    env?: string;
     /**
      * Fully resolved option bag used to compute this context.
      */

package/dist/cliHost.mjs

@@ -1,7 +1,7 @@
-export { G as GetDotenvCli, g as definePlugin, r as readMergedOptions } from './chunks/readMergedOptions-atT1xkoe.mjs';
+export { G as GetDotenvCli, g as definePlugin, r as readMergedOptions } from './chunks/readMergedOptions-CraAnYdB.mjs';
 export { b as buildSpawnEnv, r as resolveCommand, a as resolveShell, c as runCommand, d as runCommandResult, s as shouldCapture } from './chunks/spawnEnv-CKgnHGpr.mjs';
-export { b as baseGetDotenvCliOptions, r as resolveCliOptions } from './chunks/resolveCliOptions-BLSqCGm7.mjs';
-export { d as defineScripts, g as groupPlugins } from './chunks/types-BdKCfPRW.mjs';
+export { b as baseGetDotenvCliOptions, r as resolveCliOptions } from './chunks/resolveCliOptions-BMBkWDYJ.mjs';
+export { d as defineScripts, g as groupPlugins } from './chunks/types-BthqmnDr.mjs';
 export { t as toHelpConfig } from './chunks/helpConfig-CGejgwWW.mjs';
 export { c as composeNestedEnv, m as maybePreserveNodeEvalArgv, s as stripOne } from './chunks/invoke-DuRPU1oC.mjs';
 export { z } from 'zod';
@@ -17,7 +17,7 @@ import 'path';
 import 'url';
 import 'dotenv';
 import 'nanoid';
-import './chunks/loader-CE4HSRN4.mjs';
+import './chunks/loader-V1vbmtyw.mjs';
 import 'package-directory';
 import 'yaml';
 import 'execa';

package/dist/config.d.ts

@@ -56,6 +56,8 @@ interface RootOptionsShape {
     redactPatterns?: string[];
     /** Default target environment when not specified. */
     defaultEnv?: string;
+    /** Env var name in global dotenv files that specifies the default environment. */
+    defaultEnvKey?: string;
     /** Token indicating a dotenv file (default: ".env"). */
     dotenvToken?: string;
     /** Path to dynamic variables module (default: undefined). */

package/dist/config.mjs

@@ -1,4 +1,4 @@
-export { d as discoverConfigFiles, l as loadConfigFile, r as resolveGetDotenvConfigSources, t as toFileUrl } from './chunks/loader-CE4HSRN4.mjs';
+export { d as discoverConfigFiles, l as loadConfigFile, r as resolveGetDotenvConfigSources, t as toFileUrl } from './chunks/loader-V1vbmtyw.mjs';
 export { v as validateEnvAgainstSources } from './chunks/validate-CDl0rE6k.mjs';
 import 'fs-extra';
 import 'package-directory';

package/dist/env-overlay.d.ts

@@ -56,6 +56,8 @@ interface RootOptionsShape {
     redactPatterns?: string[];
     /** Default target environment when not specified. */
     defaultEnv?: string;
+    /** Env var name in global dotenv files that specifies the default environment. */
+    defaultEnvKey?: string;
     /** Token indicating a dotenv file (default: ".env"). */
     dotenvToken?: string;
     /** Path to dynamic variables module (default: undefined). */

package/dist/getdotenv.cli.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { c as createCli } from './chunks/createCli-wmAcTdWR.mjs';
+import { c as createCli } from './chunks/createCli-CVvh-dBp.mjs';
 import 'zod';
 import 'path';
-import './chunks/loader-CE4HSRN4.mjs';
+import './chunks/loader-V1vbmtyw.mjs';
 import 'fs-extra';
 import 'package-directory';
 import 'url';
@@ -14,16 +14,16 @@ import './chunks/loadModuleDefault-Dj8B3Stt.mjs';
 import 'crypto';
 import '@commander-js/extra-typings';
 import 'nanoid';
-import './chunks/readMergedOptions-atT1xkoe.mjs';
+import './chunks/readMergedOptions-CraAnYdB.mjs';
 import './chunks/readDotenvCascade-Dgx4SC1p.mjs';
 import 'dotenv';
 import 'execa';
 import './chunks/helpConfig-CGejgwWW.mjs';
-import './chunks/resolveCliOptions-BLSqCGm7.mjs';
+import './chunks/resolveCliOptions-BMBkWDYJ.mjs';
 import './chunks/validate-CDl0rE6k.mjs';
 import './plugins-aws.mjs';
 import './chunks/spawnEnv-CKgnHGpr.mjs';
-import './chunks/index-CGG9e0xu.mjs';
+import './chunks/index-BuxEK_Z4.mjs';
 import 'node:os';
 import 'node:fs/promises';
 import 'node:stream';
@@ -34,7 +34,7 @@ import 'node:process';
 import './plugins-batch.mjs';
 import './chunks/invoke-DuRPU1oC.mjs';
 import 'globby';
-import './chunks/index-BhMXFr37.mjs';
+import './chunks/index-Dd6S1nZ-.mjs';
 import './plugins-init.mjs';
 import 'readline/promises';
 import 'node:url';

package/dist/index.d.ts

@@ -144,6 +144,7 @@ type DotenvProvenance = Record<string, DotenvProvenanceEntry[]>;
  */
 declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
     defaultEnv: z.ZodOptional<z.ZodString>;
+    defaultEnvKey: z.ZodOptional<z.ZodString>;
     dotenvToken: z.ZodOptional<z.ZodString>;
     dynamicPath: z.ZodOptional<z.ZodString>;
     dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -195,6 +196,7 @@ declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
  */
 declare const getDotenvOptionsSchemaResolved: z.ZodObject<{
     defaultEnv: z.ZodOptional<z.ZodString>;
+    defaultEnvKey: z.ZodOptional<z.ZodString>;
     dotenvToken: z.ZodOptional<z.ZodString>;
     dynamicPath: z.ZodOptional<z.ZodString>;
     dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -271,6 +273,8 @@ interface RootOptionsShape {
     redactPatterns?: string[];
     /** Default target environment when not specified. */
     defaultEnv?: string;
+    /** Env var name in global dotenv files that specifies the default environment. */
+    defaultEnvKey?: string;
     /** Token indicating a dotenv file (default: ".env"). */
     dotenvToken?: string;
     /** Path to dynamic variables module (default: undefined). */
@@ -324,6 +328,10 @@ declare const defineScripts: <TShell extends string | boolean>() => <T extends S
  * @public
  */
 interface GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions> {
+    /**
+     * Effective environment name after resolution (explicit -e \> defaultEnvKey \> defaultEnv).
+     */
+    env?: string;
     /**
      * Fully resolved option bag used to compute this context.
      */
@@ -1109,6 +1117,8 @@ interface BaseRootOptionDefaults {
     entropyMinLength: number;
     /** Regex patterns (as strings) to suppress entropy warnings by key. */
     entropyWhitelist: string[];
+    /** Env var name in global dotenv files that specifies the default environment. */
+    defaultEnvKey: string;
     /** Default dotenv search paths (stringly, CLI-compatible). */
     paths: string;
     /** Paths delimiter used for the `--paths` string. */

package/dist/index.mjs

@@ -1,8 +1,8 @@
-export { c as createCli } from './chunks/createCli-wmAcTdWR.mjs';
-import { j as resolveGetDotenvOptions, w as writeDotenvFile } from './chunks/readMergedOptions-atT1xkoe.mjs';
-export { G as GetDotenvCli, a as assertLogger, c as baseRootOptionDefaults, d as defaultsDeep, e as defineDynamic, f as defineGetDotenvConfig, g as definePlugin, h as getDotenvCliOptions2Options, i as interpolateDeep, r as readMergedOptions } from './chunks/readMergedOptions-atT1xkoe.mjs';
+export { c as createCli } from './chunks/createCli-CVvh-dBp.mjs';
+import { j as resolveGetDotenvOptions, w as writeDotenvFile } from './chunks/readMergedOptions-CraAnYdB.mjs';
+export { G as GetDotenvCli, a as assertLogger, c as baseRootOptionDefaults, d as defaultsDeep, e as defineDynamic, f as defineGetDotenvConfig, g as definePlugin, h as getDotenvCliOptions2Options, i as interpolateDeep, r as readMergedOptions } from './chunks/readMergedOptions-CraAnYdB.mjs';
 export { b as buildSpawnEnv, s as shouldCapture, t as tokenize } from './chunks/spawnEnv-CKgnHGpr.mjs';
-export { d as defineScripts, g as groupPlugins } from './chunks/types-BdKCfPRW.mjs';
+export { d as defineScripts, g as groupPlugins } from './chunks/types-BthqmnDr.mjs';
 import { omit, pick } from 'radash';
 import { Buffer } from 'node:buffer';
 export { l as loadModuleDefault } from './chunks/loadModuleDefault-Dj8B3Stt.mjs';
@@ -10,8 +10,8 @@ import { InvalidArgumentError } from '@commander-js/extra-typings';
 import 'zod';
 import { nanoid } from 'nanoid';
 import path$1 from 'path';
-import { a as redactObject, m as maybeWarnEntropy } from './chunks/index-BhMXFr37.mjs';
-export { r as redactDisplay, t as traceChildEnv } from './chunks/index-BhMXFr37.mjs';
+import { a as redactObject, m as maybeWarnEntropy } from './chunks/index-Dd6S1nZ-.mjs';
+export { r as redactDisplay, t as traceChildEnv } from './chunks/index-Dd6S1nZ-.mjs';
 import { r as readDotenv, e as dotenvExpandAll, a as applyDynamicMap, l as loadAndApplyDynamic } from './chunks/readDotenvCascade-Dgx4SC1p.mjs';
 export { d as dotenvExpand, f as dotenvExpandFromProcessEnv } from './chunks/readDotenvCascade-Dgx4SC1p.mjs';
 import fs from 'fs-extra';
@@ -19,15 +19,15 @@ import path from 'node:path';
 import 'crypto';
 import 'url';
 import 'dotenv';
-import './chunks/loader-CE4HSRN4.mjs';
+import './chunks/loader-V1vbmtyw.mjs';
 import 'package-directory';
 import 'yaml';
 import 'execa';
 import './chunks/helpConfig-CGejgwWW.mjs';
-import './chunks/resolveCliOptions-BLSqCGm7.mjs';
+import './chunks/resolveCliOptions-BMBkWDYJ.mjs';
 import './chunks/validate-CDl0rE6k.mjs';
 import './plugins-aws.mjs';
-import './chunks/index-CGG9e0xu.mjs';
+import './chunks/index-BuxEK_Z4.mjs';
 import 'node:os';
 import 'node:fs/promises';
 import 'node:stream';

package/dist/plugins-aws.d.ts

@@ -144,6 +144,7 @@ type DotenvProvenance = Record<string, DotenvProvenanceEntry[]>;
  */
 declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
     defaultEnv: z.ZodOptional<z.ZodString>;
+    defaultEnvKey: z.ZodOptional<z.ZodString>;
     dotenvToken: z.ZodOptional<z.ZodString>;
     dynamicPath: z.ZodOptional<z.ZodString>;
     dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -195,6 +196,7 @@ declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
  */
 declare const getDotenvOptionsSchemaResolved: z.ZodObject<{
     defaultEnv: z.ZodOptional<z.ZodString>;
+    defaultEnvKey: z.ZodOptional<z.ZodString>;
     dotenvToken: z.ZodOptional<z.ZodString>;
     dynamicPath: z.ZodOptional<z.ZodString>;
     dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -232,6 +234,10 @@ type ScriptsTable<TShell extends string | boolean = string | boolean> = Record<s
  * @public
  */
 interface GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions> {
+    /**
+     * Effective environment name after resolution (explicit -e \> defaultEnvKey \> defaultEnv).
+     */
+    env?: string;
     /**
      * Fully resolved option bag used to compute this context.
      */

package/dist/plugins-aws.mjs

@@ -1,4 +1,4 @@
-import { r as readMergedOptions, g as definePlugin } from './chunks/readMergedOptions-atT1xkoe.mjs';
+import { r as readMergedOptions, g as definePlugin } from './chunks/readMergedOptions-CraAnYdB.mjs';
 import 'execa';
 import { isObject } from 'radash';
 import 'node:buffer';
@@ -10,7 +10,7 @@ import 'url';
 import '@commander-js/extra-typings';
 import 'nanoid';
 import 'dotenv';
-import './chunks/loader-CE4HSRN4.mjs';
+import './chunks/loader-V1vbmtyw.mjs';
 import 'package-directory';
 import 'yaml';
 import { z } from 'zod';

package/dist/plugins-batch.d.ts

@@ -144,6 +144,7 @@ type DotenvProvenance = Record<string, DotenvProvenanceEntry[]>;
  */
 declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
     defaultEnv: z.ZodOptional<z.ZodString>;
+    defaultEnvKey: z.ZodOptional<z.ZodString>;
     dotenvToken: z.ZodOptional<z.ZodString>;
     dynamicPath: z.ZodOptional<z.ZodString>;
     dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -195,6 +196,7 @@ declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
  */
 declare const getDotenvOptionsSchemaResolved: z.ZodObject<{
     defaultEnv: z.ZodOptional<z.ZodString>;
+    defaultEnvKey: z.ZodOptional<z.ZodString>;
     dotenvToken: z.ZodOptional<z.ZodString>;
     dynamicPath: z.ZodOptional<z.ZodString>;
     dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -232,6 +234,10 @@ type ScriptsTable<TShell extends string | boolean = string | boolean> = Record<s
  * @public
  */
 interface GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions> {
+    /**
+     * Effective environment name after resolution (explicit -e \> defaultEnvKey \> defaultEnv).
+     */
+    env?: string;
     /**
      * Fully resolved option bag used to compute this context.
      */

package/dist/plugins-batch.mjs

@@ -1,4 +1,4 @@
-import { r as readMergedOptions, g as definePlugin } from './chunks/readMergedOptions-atT1xkoe.mjs';
+import { r as readMergedOptions, g as definePlugin } from './chunks/readMergedOptions-CraAnYdB.mjs';
 import 'execa';
 import 'radash';
 import 'node:buffer';
@@ -10,7 +10,7 @@ import 'url';
 import { Command } from '@commander-js/extra-typings';
 import 'nanoid';
 import 'dotenv';
-import './chunks/loader-CE4HSRN4.mjs';
+import './chunks/loader-V1vbmtyw.mjs';
 import { packageDirectory } from 'package-directory';
 import 'yaml';
 import { z } from 'zod';

package/dist/plugins-cmd.d.ts

@@ -144,6 +144,7 @@ type DotenvProvenance = Record<string, DotenvProvenanceEntry[]>;
  */
 declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
     defaultEnv: z.ZodOptional<z.ZodString>;
+    defaultEnvKey: z.ZodOptional<z.ZodString>;
     dotenvToken: z.ZodOptional<z.ZodString>;
     dynamicPath: z.ZodOptional<z.ZodString>;
     dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -195,6 +196,7 @@ declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
  */
 declare const getDotenvOptionsSchemaResolved: z.ZodObject<{
     defaultEnv: z.ZodOptional<z.ZodString>;
+    defaultEnvKey: z.ZodOptional<z.ZodString>;
     dotenvToken: z.ZodOptional<z.ZodString>;
     dynamicPath: z.ZodOptional<z.ZodString>;
     dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -232,6 +234,10 @@ type ScriptsTable<TShell extends string | boolean = string | boolean> = Record<s
  * @public
  */
 interface GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions> {
+    /**
+     * Effective environment name after resolution (explicit -e \> defaultEnvKey \> defaultEnv).
+     */
+    env?: string;
     /**
      * Fully resolved option bag used to compute this context.
      */

package/dist/plugins-cmd.mjs

@@ -1,5 +1,5 @@
 import 'radash';
-import './chunks/readMergedOptions-atT1xkoe.mjs';
+import './chunks/readMergedOptions-CraAnYdB.mjs';
 import 'execa';
 import 'node:buffer';
 import 'fs-extra';
@@ -10,13 +10,13 @@ import 'url';
 import '@commander-js/extra-typings';
 import 'nanoid';
 import 'dotenv';
-import './chunks/loader-CE4HSRN4.mjs';
+import './chunks/loader-V1vbmtyw.mjs';
 import 'package-directory';
 import 'yaml';
 import 'zod';
-export { c as cmdPlugin } from './chunks/index-BhMXFr37.mjs';
+export { c as cmdPlugin } from './chunks/index-Dd6S1nZ-.mjs';
 import './chunks/readDotenvCascade-Dgx4SC1p.mjs';
 import './chunks/loadModuleDefault-Dj8B3Stt.mjs';
 import './chunks/spawnEnv-CKgnHGpr.mjs';
 import './chunks/invoke-DuRPU1oC.mjs';
-import './chunks/resolveCliOptions-BLSqCGm7.mjs';
+import './chunks/resolveCliOptions-BMBkWDYJ.mjs';

package/dist/plugins-init.d.ts

@@ -144,6 +144,7 @@ type DotenvProvenance = Record<string, DotenvProvenanceEntry[]>;
  */
 declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
     defaultEnv: z.ZodOptional<z.ZodString>;
+    defaultEnvKey: z.ZodOptional<z.ZodString>;
     dotenvToken: z.ZodOptional<z.ZodString>;
     dynamicPath: z.ZodOptional<z.ZodString>;
     dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -195,6 +196,7 @@ declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
  */
 declare const getDotenvOptionsSchemaResolved: z.ZodObject<{
     defaultEnv: z.ZodOptional<z.ZodString>;
+    defaultEnvKey: z.ZodOptional<z.ZodString>;
     dotenvToken: z.ZodOptional<z.ZodString>;
     dynamicPath: z.ZodOptional<z.ZodString>;
     dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -232,6 +234,10 @@ type ScriptsTable<TShell extends string | boolean = string | boolean> = Record<s
  * @public
  */
 interface GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions> {
+    /**
+     * Effective environment name after resolution (explicit -e \> defaultEnvKey \> defaultEnv).
+     */
+    env?: string;
     /**
      * Fully resolved option bag used to compute this context.
      */

package/dist/plugins-init.mjs

@@ -1,4 +1,4 @@
-import { r as readMergedOptions, g as definePlugin } from './chunks/readMergedOptions-atT1xkoe.mjs';
+import { r as readMergedOptions, g as definePlugin } from './chunks/readMergedOptions-CraAnYdB.mjs';
 import 'execa';
 import 'radash';
 import 'node:buffer';
@@ -10,7 +10,7 @@ import 'url';
 import '@commander-js/extra-typings';
 import 'nanoid';
 import 'dotenv';
-import './chunks/loader-CE4HSRN4.mjs';
+import './chunks/loader-V1vbmtyw.mjs';
 import { packageDirectory } from 'package-directory';
 import 'yaml';
 import 'zod';

package/dist/plugins.d.ts

@@ -144,6 +144,7 @@ type DotenvProvenance = Record<string, DotenvProvenanceEntry[]>;
  */
 declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
     defaultEnv: z.ZodOptional<z.ZodString>;
+    defaultEnvKey: z.ZodOptional<z.ZodString>;
     dotenvToken: z.ZodOptional<z.ZodString>;
     dynamicPath: z.ZodOptional<z.ZodString>;
     dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -195,6 +196,7 @@ declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
  */
 declare const getDotenvOptionsSchemaResolved: z.ZodObject<{
     defaultEnv: z.ZodOptional<z.ZodString>;
+    defaultEnvKey: z.ZodOptional<z.ZodString>;
     dotenvToken: z.ZodOptional<z.ZodString>;
     dynamicPath: z.ZodOptional<z.ZodString>;
     dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -232,6 +234,10 @@ type ScriptsTable<TShell extends string | boolean = string | boolean> = Record<s
  * @public
  */
 interface GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions> {
+    /**
+     * Effective environment name after resolution (explicit -e \> defaultEnvKey \> defaultEnv).
+     */
+    env?: string;
     /**
      * Fully resolved option bag used to compute this context.
      */

package/dist/plugins.mjs

@@ -1,9 +1,9 @@
 export { awsPlugin, getAwsRegion } from './plugins-aws.mjs';
-export { R as awsWhoamiPlugin } from './chunks/index-CGG9e0xu.mjs';
+export { R as awsWhoamiPlugin } from './chunks/index-BuxEK_Z4.mjs';
 export { batchPlugin } from './plugins-batch.mjs';
-export { c as cmdPlugin } from './chunks/index-BhMXFr37.mjs';
+export { c as cmdPlugin } from './chunks/index-Dd6S1nZ-.mjs';
 export { initPlugin } from './plugins-init.mjs';
-import './chunks/readMergedOptions-atT1xkoe.mjs';
+import './chunks/readMergedOptions-CraAnYdB.mjs';
 import 'zod';
 import '@commander-js/extra-typings';
 import './chunks/readDotenvCascade-Dgx4SC1p.mjs';
@@ -17,7 +17,7 @@ import 'path';
 import 'url';
 import 'dotenv';
 import 'nanoid';
-import './chunks/loader-CE4HSRN4.mjs';
+import './chunks/loader-V1vbmtyw.mjs';
 import 'package-directory';
 import 'yaml';
 import 'execa';
@@ -31,6 +31,6 @@ import 'node:https';
 import 'node:process';
 import './chunks/invoke-DuRPU1oC.mjs';
 import 'globby';
-import './chunks/resolveCliOptions-BLSqCGm7.mjs';
+import './chunks/resolveCliOptions-BMBkWDYJ.mjs';
 import 'readline/promises';
 import 'node:url';