@karmaniverous/get-dotenv 7.0.1 → 7.0.3

package/dist/chunks/{readMergedOptions-D6niy_Ep.mjs → readMergedOptions-BRLqvCpt.mjs}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { Option, Command } from '@commander-js/extra-typings';
-import { h as dotenvExpand, r as readDotenvCascadeWithProvenance, o as overlayEnvWithProvenance, b as applyDynamicMapWithProvenance, l as loadDynamicModuleDefault, f as dotenvExpandFromProcessEnv } from './readDotenvCascade-HLU7FsEQ.mjs';
+import { d as dotenvExpand, h as readDotenvCascadeWithProvenance, o as overlayEnvWithProvenance, b as applyDynamicMapWithProvenance, g as loadDynamicModuleDefault, f as dotenvExpandFromProcessEnv } from './readDotenvCascade-Dgx4SC1p.mjs';
 import fs from 'fs-extra';
 import 'node:path';
 import 'nanoid';
@@ -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 } : {}),
@@ -549,7 +568,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 +750,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)
@@ -1264,7 +1289,9 @@ class GetDotenvCli extends Command {
     }
     /** Internal: climb to the true root (host) command. */
     _root() {
-        let node = this;
+        let node = this.parent;
+        if (!node)
+            return this;
         while (node.parent) {
             node = node.parent;
         }
@@ -1436,4 +1463,4 @@ const readMergedOptions = (cmd) => {
     return bag;
 };
 
-export { GetDotenvCli as G, defaultsDeep as a, baseRootOptionDefaults as b, attachRootOptions as c, definePlugin as d, resolveGetDotenvOptions as e, assertLogger as f, getDotenvCliOptions2Options as g, defineDynamic as h, defineGetDotenvConfig as i, interpolateDeep as j, readMergedOptions as r, writeDotenvFile as w };
+export { GetDotenvCli as G, assertLogger as a, attachRootOptions as b, baseRootOptionDefaults as c, defaultsDeep as d, defineDynamic as e, defineGetDotenvConfig as f, definePlugin as g, getDotenvCliOptions2Options as h, interpolateDeep as i, resolveGetDotenvOptions as j, readMergedOptions as r, writeDotenvFile as w };

package/dist/chunks/{resolveCliOptions-PWF1aEM9.mjs → resolveCliOptions-Bbv0tNSF.mjs}

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

package/dist/chunks/{sdk-stream-mixin-blFikF4G.mjs → sdk-stream-mixin-pKJE9QhL.mjs}

@@ -1,10 +1,102 @@
-import { m as fromBase64, n as toBase64, o as toHex, t as toUtf8, q as fromArrayBuffer, r as streamCollector$1 } from './index-AssUn9IY.mjs';
-import { Readable } from 'stream';
+import { Writable, Readable } from 'node:stream';
+import { aS as toHex, a5 as fromArrayBuffer } from './index-DbDfog26.mjs';
 
 const isReadableStream = (stream) => typeof ReadableStream === "function" &&
     (stream?.constructor?.name === ReadableStream.name || stream instanceof ReadableStream);
 
-const streamCollector = async (stream) => {
+const fromUtf8 = (input) => new TextEncoder().encode(input);
+
+const chars = `ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/`;
+const alphabetByEncoding = Object.entries(chars).reduce((acc, [i, c]) => {
+    acc[c] = Number(i);
+    return acc;
+}, {});
+const alphabetByValue = chars.split("");
+const bitsPerLetter = 6;
+const bitsPerByte = 8;
+const maxLetterValue = 0b111111;
+
+function toBase64(_input) {
+    let input;
+    if (typeof _input === "string") {
+        input = fromUtf8(_input);
+    }
+    else {
+        input = _input;
+    }
+    const isArrayLike = typeof input === "object" && typeof input.length === "number";
+    const isUint8Array = typeof input === "object" &&
+        typeof input.byteOffset === "number" &&
+        typeof input.byteLength === "number";
+    if (!isArrayLike && !isUint8Array) {
+        throw new Error("@smithy/util-base64: toBase64 encoder function only accepts string | Uint8Array.");
+    }
+    let str = "";
+    for (let i = 0; i < input.length; i += 3) {
+        let bits = 0;
+        let bitLength = 0;
+        for (let j = i, limit = Math.min(i + 3, input.length); j < limit; j++) {
+            bits |= input[j] << ((limit - j - 1) * bitsPerByte);
+            bitLength += bitsPerByte;
+        }
+        const bitClusterCount = Math.ceil(bitLength / bitsPerLetter);
+        bits <<= bitClusterCount * bitsPerLetter - bitLength;
+        for (let k = 1; k <= bitClusterCount; k++) {
+            const offset = (bitClusterCount - k) * bitsPerLetter;
+            str += alphabetByValue[(bits & (maxLetterValue << offset)) >> offset];
+        }
+        str += "==".slice(0, 4 - bitClusterCount);
+    }
+    return str;
+}
+
+const toUtf8 = (input) => {
+    if (typeof input === "string") {
+        return input;
+    }
+    if (typeof input !== "object" || typeof input.byteOffset !== "number" || typeof input.byteLength !== "number") {
+        throw new Error("@smithy/util-utf8: toUtf8 encoder function only accepts string | Uint8Array.");
+    }
+    return new TextDecoder("utf-8").decode(input);
+};
+
+const fromBase64 = (input) => {
+    let totalByteLength = (input.length / 4) * 3;
+    if (input.slice(-2) === "==") {
+        totalByteLength -= 2;
+    }
+    else if (input.slice(-1) === "=") {
+        totalByteLength--;
+    }
+    const out = new ArrayBuffer(totalByteLength);
+    const dataView = new DataView(out);
+    for (let i = 0; i < input.length; i += 4) {
+        let bits = 0;
+        let bitLength = 0;
+        for (let j = i, limit = i + 3; j <= limit; j++) {
+            if (input[j] !== "=") {
+                if (!(input[j] in alphabetByEncoding)) {
+                    throw new TypeError(`Invalid character ${input[j]} in base64 string.`);
+                }
+                bits |= alphabetByEncoding[input[j]] << ((limit - j) * bitsPerLetter);
+                bitLength += bitsPerLetter;
+            }
+            else {
+                bits >>= bitsPerLetter;
+            }
+        }
+        const chunkOffset = (i / 4) * 3;
+        bits >>= bitLength % bitsPerByte;
+        const byteLength = Math.floor(bitLength / bitsPerByte);
+        for (let k = 0; k < byteLength; k++) {
+            const offset = (byteLength - k - 1) * bitsPerByte;
+            dataView.setUint8(chunkOffset + k, (bits & (255 << offset)) >> offset);
+        }
+    }
+    return new Uint8Array(out);
+};
+
+const streamCollector$1 = async (stream) => {
     if ((typeof Blob === "function" && stream instanceof Blob) || stream.constructor?.name === "Blob") {
         if (Blob.prototype.arrayBuffer !== undefined) {
             return new Uint8Array(await stream.arrayBuffer());
@@ -69,7 +161,7 @@ const sdkStreamMixin$1 = (stream) => {
             throw new Error(ERR_MSG_STREAM_HAS_BEEN_TRANSFORMED$1);
         }
         transformed = true;
-        return await streamCollector(stream);
+        return await streamCollector$1(stream);
     };
     const blobToWebStream = (blob) => {
         if (typeof blob.stream !== "function") {
@@ -117,6 +209,54 @@ const sdkStreamMixin$1 = (stream) => {
 };
 const isBlobInstance = (stream) => typeof Blob === "function" && stream instanceof Blob;
 
+class Collector extends Writable {
+    bufferedBytes = [];
+    _write(chunk, encoding, callback) {
+        this.bufferedBytes.push(chunk);
+        callback();
+    }
+}
+const isReadableStreamInstance = (stream) => typeof ReadableStream === "function" && stream instanceof ReadableStream;
+async function collectReadableStream(stream) {
+    const chunks = [];
+    const reader = stream.getReader();
+    let isDone = false;
+    let length = 0;
+    while (!isDone) {
+        const { done, value } = await reader.read();
+        if (value) {
+            chunks.push(value);
+            length += value.length;
+        }
+        isDone = done;
+    }
+    const collected = new Uint8Array(length);
+    let offset = 0;
+    for (const chunk of chunks) {
+        collected.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return collected;
+}
+const streamCollector = (stream) => {
+    if (isReadableStreamInstance(stream)) {
+        return collectReadableStream(stream);
+    }
+    return new Promise((resolve, reject) => {
+        const collector = new Collector();
+        stream.pipe(collector);
+        stream.on("error", (err) => {
+            collector.end();
+            reject(err);
+        });
+        collector.on("error", reject);
+        collector.on("finish", function () {
+            const bytes = new Uint8Array(Buffer.concat(this.bufferedBytes));
+            resolve(bytes);
+        });
+    });
+};
+
 const ERR_MSG_STREAM_HAS_BEEN_TRANSFORMED = "The stream has already been transformed.";
 const sdkStreamMixin = (stream) => {
     if (!(stream instanceof Readable)) {
@@ -134,7 +274,7 @@ const sdkStreamMixin = (stream) => {
             throw new Error(ERR_MSG_STREAM_HAS_BEEN_TRANSFORMED);
         }
         transformed = true;
-        return await streamCollector$1(stream);
+        return await streamCollector(stream);
     };
     return Object.assign(stream, {
         transformToByteArray,

package/dist/chunks/{spawnEnv-5kdIVv0x.mjs → spawnEnv-CKgnHGpr.mjs}

@@ -143,12 +143,12 @@ async function _execNormalized(command, shell, opts = {}) {
             return { exitCode: 0, stdout: '', stderr: '' };
         dbg('exec (plain)', { file, args, stdio });
         try {
-            const ok = pickResult((await execa(file, args, {
+            const ok = pickResult(await execa(file, args, {
                 ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
                 ...(envSan !== undefined ? { env: envSan } : {}),
                 stdio,
                 ...timeoutBits,
-            })));
+            }));
             dbg('exit (plain)', { exitCode: ok.exitCode });
             return ok;
         }
@@ -166,13 +166,13 @@ async function _execNormalized(command, shell, opts = {}) {
         stdio,
     });
     try {
-        const ok = pickResult((await execaCommand(commandStr, {
+        const ok = pickResult(await execaCommand(commandStr, {
             shell,
             ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
             ...(envSan !== undefined ? { env: envSan } : {}),
             stdio,
             ...timeoutBits,
-        })));
+        }));
         dbg('exit (shell)', { exitCode: ok.exitCode });
         return ok;
     }
@@ -307,4 +307,4 @@ const buildSpawnEnv = (base, overlay) => {
     return out;
 };
 
-export { runCommandResult as a, resolveCommand as b, resolveShell as c, buildSpawnEnv as d, runCommand as r, shouldCapture as s, tokenize as t };
+export { resolveShell as a, buildSpawnEnv as b, runCommand as c, runCommandResult as d, resolveCommand as r, shouldCapture as s, tokenize as t };

package/dist/chunks/{types-Bp3u5-IH.mjs → types-BfKw9R-k.mjs}

@@ -1,4 +1,4 @@
-import { d as definePlugin } from './readMergedOptions-D6niy_Ep.mjs';
+import { g as definePlugin } from './readMergedOptions-BRLqvCpt.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). */

package/dist/cli.mjs

@@ -1,7 +1,7 @@
-export { c as createCli } from './chunks/createCli-B9-MIwWj.mjs';
+export { c as createCli } from './chunks/createCli-B9De0dbB.mjs';
 import 'zod';
 import 'path';
-import './chunks/loader-CE4HSRN4.mjs';
+import './chunks/loader-V1vbmtyw.mjs';
 import 'fs-extra';
 import 'package-directory';
 import 'url';
@@ -13,29 +13,27 @@ import './chunks/loadModuleDefault-Dj8B3Stt.mjs';
 import 'crypto';
 import '@commander-js/extra-typings';
 import 'nanoid';
-import './chunks/readMergedOptions-D6niy_Ep.mjs';
-import './chunks/readDotenvCascade-HLU7FsEQ.mjs';
+import './chunks/readMergedOptions-BRLqvCpt.mjs';
+import './chunks/readDotenvCascade-Dgx4SC1p.mjs';
 import 'dotenv';
 import 'execa';
 import './chunks/helpConfig-CGejgwWW.mjs';
-import './chunks/resolveCliOptions-PWF1aEM9.mjs';
+import './chunks/resolveCliOptions-Bbv0tNSF.mjs';
 import './chunks/validate-CDl0rE6k.mjs';
 import './plugins-aws.mjs';
-import './chunks/spawnEnv-5kdIVv0x.mjs';
-import './chunks/index-AssUn9IY.mjs';
-import 'buffer';
-import 'os';
+import './chunks/spawnEnv-CKgnHGpr.mjs';
+import './chunks/index-DbDfog26.mjs';
+import 'node:os';
 import 'node:fs/promises';
-import 'http';
-import 'https';
-import 'stream';
-import 'process';
+import 'node:stream';
+import 'node:crypto';
 import 'node:fs';
+import 'node:https';
+import 'node:process';
 import './plugins-batch.mjs';
 import './chunks/invoke-DuRPU1oC.mjs';
 import 'globby';
-import './chunks/index-CAtxK29A.mjs';
+import './chunks/index-CcxIt23B.mjs';
 import './plugins-init.mjs';
-import 'node:process';
 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). */

package/dist/cliHost.mjs

@@ -1,12 +1,12 @@
-export { G as GetDotenvCli, d as definePlugin, r as readMergedOptions } from './chunks/readMergedOptions-D6niy_Ep.mjs';
-export { d as buildSpawnEnv, b as resolveCommand, c as resolveShell, r as runCommand, a as runCommandResult, s as shouldCapture } from './chunks/spawnEnv-5kdIVv0x.mjs';
-export { b as baseGetDotenvCliOptions, r as resolveCliOptions } from './chunks/resolveCliOptions-PWF1aEM9.mjs';
-export { d as defineScripts, g as groupPlugins } from './chunks/types-Bp3u5-IH.mjs';
+export { G as GetDotenvCli, g as definePlugin, r as readMergedOptions } from './chunks/readMergedOptions-BRLqvCpt.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-Bbv0tNSF.mjs';
+export { d as defineScripts, g as groupPlugins } from './chunks/types-BfKw9R-k.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';
 import '@commander-js/extra-typings';
-import './chunks/readDotenvCascade-HLU7FsEQ.mjs';
+import './chunks/readDotenvCascade-Dgx4SC1p.mjs';
 import 'fs-extra';
 import 'radash';
 import 'node:buffer';
@@ -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/env-overlay.mjs

@@ -1,5 +1,5 @@
-import { d as dotenvExpandAll } from './chunks/readDotenvCascade-HLU7FsEQ.mjs';
-export { a as applyDynamicMap, b as applyDynamicMapWithProvenance, e as createDotenvProvenance, c as loadAndApplyDynamic, l as loadDynamicModuleDefault, o as overlayEnvWithProvenance, p as pushDotenvProvenance, r as readDotenvCascadeWithProvenance } from './chunks/readDotenvCascade-HLU7FsEQ.mjs';
+import { e as dotenvExpandAll } from './chunks/readDotenvCascade-Dgx4SC1p.mjs';
+export { a as applyDynamicMap, b as applyDynamicMapWithProvenance, c as createDotenvProvenance, l as loadAndApplyDynamic, g as loadDynamicModuleDefault, o as overlayEnvWithProvenance, p as pushDotenvProvenance, h as readDotenvCascadeWithProvenance } from './chunks/readDotenvCascade-Dgx4SC1p.mjs';
 import 'fs-extra';
 import 'node:path';
 import 'radash';

package/dist/getdotenv.cli.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { c as createCli } from './chunks/createCli-B9-MIwWj.mjs';
+import { c as createCli } from './chunks/createCli-B9De0dbB.mjs';
 import 'zod';
 import 'path';
-import './chunks/loader-CE4HSRN4.mjs';
+import './chunks/loader-V1vbmtyw.mjs';
 import 'fs-extra';
 import 'package-directory';
 import 'url';
@@ -14,30 +14,28 @@ import './chunks/loadModuleDefault-Dj8B3Stt.mjs';
 import 'crypto';
 import '@commander-js/extra-typings';
 import 'nanoid';
-import './chunks/readMergedOptions-D6niy_Ep.mjs';
-import './chunks/readDotenvCascade-HLU7FsEQ.mjs';
+import './chunks/readMergedOptions-BRLqvCpt.mjs';
+import './chunks/readDotenvCascade-Dgx4SC1p.mjs';
 import 'dotenv';
 import 'execa';
 import './chunks/helpConfig-CGejgwWW.mjs';
-import './chunks/resolveCliOptions-PWF1aEM9.mjs';
+import './chunks/resolveCliOptions-Bbv0tNSF.mjs';
 import './chunks/validate-CDl0rE6k.mjs';
 import './plugins-aws.mjs';
-import './chunks/spawnEnv-5kdIVv0x.mjs';
-import './chunks/index-AssUn9IY.mjs';
-import 'buffer';
-import 'os';
+import './chunks/spawnEnv-CKgnHGpr.mjs';
+import './chunks/index-DbDfog26.mjs';
+import 'node:os';
 import 'node:fs/promises';
-import 'http';
-import 'https';
-import 'stream';
-import 'process';
+import 'node:stream';
+import 'node:crypto';
 import 'node:fs';
+import 'node:https';
+import 'node:process';
 import './plugins-batch.mjs';
 import './chunks/invoke-DuRPU1oC.mjs';
 import 'globby';
-import './chunks/index-CAtxK29A.mjs';
+import './chunks/index-CcxIt23B.mjs';
 import './plugins-init.mjs';
-import 'node:process';
 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). */
@@ -1109,6 +1113,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-B9-MIwWj.mjs';
-import { e as resolveGetDotenvOptions, w as writeDotenvFile } from './chunks/readMergedOptions-D6niy_Ep.mjs';
-export { G as GetDotenvCli, f as assertLogger, b as baseRootOptionDefaults, a as defaultsDeep, h as defineDynamic, i as defineGetDotenvConfig, d as definePlugin, g as getDotenvCliOptions2Options, j as interpolateDeep, r as readMergedOptions } from './chunks/readMergedOptions-D6niy_Ep.mjs';
-export { d as buildSpawnEnv, s as shouldCapture, t as tokenize } from './chunks/spawnEnv-5kdIVv0x.mjs';
-export { d as defineScripts, g as groupPlugins } from './chunks/types-Bp3u5-IH.mjs';
+export { c as createCli } from './chunks/createCli-B9De0dbB.mjs';
+import { j as resolveGetDotenvOptions, w as writeDotenvFile } from './chunks/readMergedOptions-BRLqvCpt.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-BRLqvCpt.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-BfKw9R-k.mjs';
 import { omit, pick } from 'radash';
 import { Buffer } from 'node:buffer';
 export { l as loadModuleDefault } from './chunks/loadModuleDefault-Dj8B3Stt.mjs';
@@ -10,37 +10,35 @@ import { InvalidArgumentError } from '@commander-js/extra-typings';
 import 'zod';
 import { nanoid } from 'nanoid';
 import path$1 from 'path';
-import { r as redactObject, m as maybeWarnEntropy } from './chunks/index-CAtxK29A.mjs';
-export { a as redactDisplay, t as traceChildEnv } from './chunks/index-CAtxK29A.mjs';
-import { g as readDotenv, d as dotenvExpandAll, a as applyDynamicMap, c as loadAndApplyDynamic } from './chunks/readDotenvCascade-HLU7FsEQ.mjs';
-export { h as dotenvExpand, f as dotenvExpandFromProcessEnv } from './chunks/readDotenvCascade-HLU7FsEQ.mjs';
+import { a as redactObject, m as maybeWarnEntropy } from './chunks/index-CcxIt23B.mjs';
+export { r as redactDisplay, t as traceChildEnv } from './chunks/index-CcxIt23B.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';
 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-PWF1aEM9.mjs';
+import './chunks/resolveCliOptions-Bbv0tNSF.mjs';
 import './chunks/validate-CDl0rE6k.mjs';
 import './plugins-aws.mjs';
-import './chunks/index-AssUn9IY.mjs';
-import 'buffer';
-import 'os';
+import './chunks/index-DbDfog26.mjs';
+import 'node:os';
 import 'node:fs/promises';
-import 'http';
-import 'https';
-import 'stream';
-import 'process';
+import 'node:stream';
+import 'node:crypto';
 import 'node:fs';
+import 'node:https';
+import 'node:process';
 import './plugins-batch.mjs';
 import './chunks/invoke-DuRPU1oC.mjs';
 import 'globby';
 import './plugins-init.mjs';
-import 'node:process';
 import 'readline/promises';
 import 'node:url';