@karmaniverous/get-dotenv 5.2.5 → 6.0.0-0

package/dist/plugins-demo.cjs

@@ -139,6 +139,48 @@ const runCommand = async (command, shell, opts) => {
     }
 };
 
+const dropUndefined = (bag) => Object.fromEntries(Object.entries(bag).filter((e) => typeof e[1] === 'string'));
+/** Build a sanitized env for child processes from base + overlay. */
+const buildSpawnEnv = (base, overlay) => {
+    const raw = {
+        ...(base ?? {}),
+        ...(overlay ?? {}),
+    };
+    // Drop undefined first
+    const entries = Object.entries(dropUndefined(raw));
+    if (process.platform === 'win32') {
+        // Windows: keys are case-insensitive; collapse duplicates
+        const byLower = new Map();
+        for (const [k, v] of entries) {
+            byLower.set(k.toLowerCase(), [k, v]); // last wins; preserve latest casing
+        }
+        const out = {};
+        for (const [, [k, v]] of byLower)
+            out[k] = v;
+        // HOME fallback from USERPROFILE (common expectation)
+        if (!Object.prototype.hasOwnProperty.call(out, 'HOME')) {
+            const up = out['USERPROFILE'];
+            if (typeof up === 'string' && up.length > 0)
+                out['HOME'] = up;
+        }
+        // Normalize TMP/TEMP coherence (pick any present; reflect to both)
+        const tmp = out['TMP'] ?? out['TEMP'];
+        if (typeof tmp === 'string' && tmp.length > 0) {
+            out['TMP'] = tmp;
+            out['TEMP'] = tmp;
+        }
+        return out;
+    }
+    // POSIX: keep keys as-is
+    const out = Object.fromEntries(entries);
+    // Ensure TMPDIR exists when any temp key is present (best-effort)
+    const tmpdir = out['TMPDIR'] ?? out['TMP'] ?? out['TEMP'];
+    if (typeof tmpdir === 'string' && tmpdir.length > 0) {
+        out['TMPDIR'] = tmpdir;
+    }
+    return out;
+};
+
 /** src/cliHost/definePlugin.ts
  * Plugin contracts for the GetDotenv CLI host.
  *
@@ -249,7 +291,7 @@ const demoPlugin = () => definePlugin({
             const dotenv = (ctx?.dotenv ?? {});
             // Inherit stdio for an interactive demo. Use --capture for CI.
             await runCommand(['node', '-e', code], false, {
-                env: { ...process.env, ...dotenv },
+                env: buildSpawnEnv(process.env, dotenv),
                 stdio: 'inherit',
             });
         });
@@ -286,20 +328,23 @@ const demoPlugin = () => definePlugin({
             const ctx = cli.getCtx();
             const dotenv = (ctx?.dotenv ?? {});
             await runCommand(resolved, shell, {
-                env: { ...process.env, ...dotenv },
+                env: buildSpawnEnv(process.env, dotenv),
                 stdio: 'inherit',
             });
         });
     },
     /**
      * Optional: afterResolve can initialize per-plugin state using ctx.dotenv.
-     * For the demo we just log once to hint where such logic would live.
+     * For the demo we emit a single breadcrumb only when GETDOTENV_DEBUG is set,
+     * keeping default runs (tests/CI/smoke) quiet.
      */
     afterResolve(_cli, ctx) {
-        const keys = Object.keys(ctx.dotenv);
-        if (keys.length > 0) {
-            // Keep noise low; a single-line breadcrumb is sufficient for the demo.
-            console.error('[demo] afterResolve: dotenv keys loaded:', keys.length);
+        if (process.env.GETDOTENV_DEBUG) {
+            const keys = Object.keys(ctx.dotenv);
+            if (keys.length > 0) {
+                // Keep noise low; a single-line breadcrumb is sufficient for the demo.
+                console.error('[demo] afterResolve: dotenv keys loaded:', keys.length);
+            }
         }
     },
 });

package/dist/plugins-demo.d.cts

@@ -1,76 +1,6 @@
 import { Command } from 'commander';
 import { ZodType } from 'zod';
 
-/**
- * Minimal root options shape shared by CLI and generator layers.
- * Keep keys optional to respect exactOptionalPropertyTypes semantics.
- */
-type RootOptionsShape = {
-    env?: string;
-    vars?: string;
-    command?: string;
-    outputPath?: string;
-    shell?: string | boolean;
-    loadProcess?: boolean;
-    excludeAll?: boolean;
-    excludeDynamic?: boolean;
-    excludeEnv?: boolean;
-    excludeGlobal?: boolean;
-    excludePrivate?: boolean;
-    excludePublic?: boolean;
-    log?: boolean;
-    debug?: boolean;
-    capture?: boolean;
-    strict?: boolean;
-    redact?: boolean;
-    warnEntropy?: boolean;
-    entropyThreshold?: number;
-    entropyMinLength?: number;
-    entropyWhitelist?: string[];
-    redactPatterns?: string[];
-    defaultEnv?: string;
-    dotenvToken?: string;
-    dynamicPath?: string;
-    trace?: boolean | string[];
-    paths?: string;
-    pathsDelimiter?: string;
-    pathsDelimiterPattern?: string;
-    privateToken?: string;
-    varsDelimiter?: string;
-    varsDelimiterPattern?: string;
-    varsAssignor?: string;
-    varsAssignorPattern?: string;
-    scripts?: ScriptsTable;
-};
-/**
- * Scripts table shape (configurable shell type).
- */
-type ScriptsTable<TShell extends string | boolean = string | boolean> = Record<string, string | {
-    cmd: string;
-    shell?: TShell;
-}>;
-
-/**
- * Adapter-layer augmentation: add chainable helpers to GetDotenvCli without
- * coupling the core host to cliCore. Importing this module has side effects:
- * it extends the prototype and merges types for consumers.
- */
-declare module '../cliHost/GetDotenvCli' {
-    interface GetDotenvCli {
-        /**
-         * Attach legacy root flags to this CLI instance. Defaults come from
-         * baseRootOptionDefaults when none are provided.     */
-        attachRootOptions(defaults?: Partial<RootOptionsShape>, opts?: {
-            includeCommandOption?: boolean;
-        }): this;
-        /**
-         * Install a preSubcommand hook that merges CLI flags (including parent
-         * round-trip) and resolves the dotenv context before executing actions.
-         * Defaults come from baseRootOptionDefaults when none are provided.
-         */ passOptions(defaults?: Partial<RootOptionsShape>): this;
-    }
-}
-
 /**
  * A minimal representation of an environment key/value mapping.
  * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
@@ -165,14 +95,6 @@ interface GetDotenvOptions {
     useConfigLoader?: boolean;
 }
 
-/** * Per-invocation context shared with plugins and actions. */
-type GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions> = {
-    optionsResolved: TOptions;
-    dotenv: ProcessEnv;
-    plugins?: Record<string, unknown>;
-    pluginConfigs?: Record<string, unknown>;
-};
-
 /** src/cliHost/definePlugin.ts
  * Plugin contracts for the GetDotenv CLI host.
  *
@@ -223,6 +145,14 @@ interface GetDotenvCliPlugin {
     use: (child: GetDotenvCliPlugin) => GetDotenvCliPlugin;
 }
 
+/** * Per-invocation context shared with plugins and actions. */
+type GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions> = {
+    optionsResolved: TOptions;
+    dotenv: ProcessEnv;
+    plugins?: Record<string, unknown>;
+    pluginConfigs?: Record<string, unknown>;
+};
+
 declare const demoPlugin: () => GetDotenvCliPlugin;
 
 export { demoPlugin };

package/dist/plugins-demo.d.mts

@@ -1,76 +1,6 @@
 import { Command } from 'commander';
 import { ZodType } from 'zod';
 
-/**
- * Minimal root options shape shared by CLI and generator layers.
- * Keep keys optional to respect exactOptionalPropertyTypes semantics.
- */
-type RootOptionsShape = {
-    env?: string;
-    vars?: string;
-    command?: string;
-    outputPath?: string;
-    shell?: string | boolean;
-    loadProcess?: boolean;
-    excludeAll?: boolean;
-    excludeDynamic?: boolean;
-    excludeEnv?: boolean;
-    excludeGlobal?: boolean;
-    excludePrivate?: boolean;
-    excludePublic?: boolean;
-    log?: boolean;
-    debug?: boolean;
-    capture?: boolean;
-    strict?: boolean;
-    redact?: boolean;
-    warnEntropy?: boolean;
-    entropyThreshold?: number;
-    entropyMinLength?: number;
-    entropyWhitelist?: string[];
-    redactPatterns?: string[];
-    defaultEnv?: string;
-    dotenvToken?: string;
-    dynamicPath?: string;
-    trace?: boolean | string[];
-    paths?: string;
-    pathsDelimiter?: string;
-    pathsDelimiterPattern?: string;
-    privateToken?: string;
-    varsDelimiter?: string;
-    varsDelimiterPattern?: string;
-    varsAssignor?: string;
-    varsAssignorPattern?: string;
-    scripts?: ScriptsTable;
-};
-/**
- * Scripts table shape (configurable shell type).
- */
-type ScriptsTable<TShell extends string | boolean = string | boolean> = Record<string, string | {
-    cmd: string;
-    shell?: TShell;
-}>;
-
-/**
- * Adapter-layer augmentation: add chainable helpers to GetDotenvCli without
- * coupling the core host to cliCore. Importing this module has side effects:
- * it extends the prototype and merges types for consumers.
- */
-declare module '../cliHost/GetDotenvCli' {
-    interface GetDotenvCli {
-        /**
-         * Attach legacy root flags to this CLI instance. Defaults come from
-         * baseRootOptionDefaults when none are provided.     */
-        attachRootOptions(defaults?: Partial<RootOptionsShape>, opts?: {
-            includeCommandOption?: boolean;
-        }): this;
-        /**
-         * Install a preSubcommand hook that merges CLI flags (including parent
-         * round-trip) and resolves the dotenv context before executing actions.
-         * Defaults come from baseRootOptionDefaults when none are provided.
-         */ passOptions(defaults?: Partial<RootOptionsShape>): this;
-    }
-}
-
 /**
  * A minimal representation of an environment key/value mapping.
  * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
@@ -165,14 +95,6 @@ interface GetDotenvOptions {
     useConfigLoader?: boolean;
 }
 
-/** * Per-invocation context shared with plugins and actions. */
-type GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions> = {
-    optionsResolved: TOptions;
-    dotenv: ProcessEnv;
-    plugins?: Record<string, unknown>;
-    pluginConfigs?: Record<string, unknown>;
-};
-
 /** src/cliHost/definePlugin.ts
  * Plugin contracts for the GetDotenv CLI host.
  *
@@ -223,6 +145,14 @@ interface GetDotenvCliPlugin {
     use: (child: GetDotenvCliPlugin) => GetDotenvCliPlugin;
 }
 
+/** * Per-invocation context shared with plugins and actions. */
+type GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions> = {
+    optionsResolved: TOptions;
+    dotenv: ProcessEnv;
+    plugins?: Record<string, unknown>;
+    pluginConfigs?: Record<string, unknown>;
+};
+
 declare const demoPlugin: () => GetDotenvCliPlugin;
 
 export { demoPlugin };

package/dist/plugins-demo.d.ts

@@ -1,76 +1,6 @@
 import { Command } from 'commander';
 import { ZodType } from 'zod';
 
-/**
- * Minimal root options shape shared by CLI and generator layers.
- * Keep keys optional to respect exactOptionalPropertyTypes semantics.
- */
-type RootOptionsShape = {
-    env?: string;
-    vars?: string;
-    command?: string;
-    outputPath?: string;
-    shell?: string | boolean;
-    loadProcess?: boolean;
-    excludeAll?: boolean;
-    excludeDynamic?: boolean;
-    excludeEnv?: boolean;
-    excludeGlobal?: boolean;
-    excludePrivate?: boolean;
-    excludePublic?: boolean;
-    log?: boolean;
-    debug?: boolean;
-    capture?: boolean;
-    strict?: boolean;
-    redact?: boolean;
-    warnEntropy?: boolean;
-    entropyThreshold?: number;
-    entropyMinLength?: number;
-    entropyWhitelist?: string[];
-    redactPatterns?: string[];
-    defaultEnv?: string;
-    dotenvToken?: string;
-    dynamicPath?: string;
-    trace?: boolean | string[];
-    paths?: string;
-    pathsDelimiter?: string;
-    pathsDelimiterPattern?: string;
-    privateToken?: string;
-    varsDelimiter?: string;
-    varsDelimiterPattern?: string;
-    varsAssignor?: string;
-    varsAssignorPattern?: string;
-    scripts?: ScriptsTable;
-};
-/**
- * Scripts table shape (configurable shell type).
- */
-type ScriptsTable<TShell extends string | boolean = string | boolean> = Record<string, string | {
-    cmd: string;
-    shell?: TShell;
-}>;
-
-/**
- * Adapter-layer augmentation: add chainable helpers to GetDotenvCli without
- * coupling the core host to cliCore. Importing this module has side effects:
- * it extends the prototype and merges types for consumers.
- */
-declare module '../cliHost/GetDotenvCli' {
-    interface GetDotenvCli {
-        /**
-         * Attach legacy root flags to this CLI instance. Defaults come from
-         * baseRootOptionDefaults when none are provided.     */
-        attachRootOptions(defaults?: Partial<RootOptionsShape>, opts?: {
-            includeCommandOption?: boolean;
-        }): this;
-        /**
-         * Install a preSubcommand hook that merges CLI flags (including parent
-         * round-trip) and resolves the dotenv context before executing actions.
-         * Defaults come from baseRootOptionDefaults when none are provided.
-         */ passOptions(defaults?: Partial<RootOptionsShape>): this;
-    }
-}
-
 /**
  * A minimal representation of an environment key/value mapping.
  * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
@@ -165,14 +95,6 @@ interface GetDotenvOptions {
     useConfigLoader?: boolean;
 }
 
-/** * Per-invocation context shared with plugins and actions. */
-type GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions> = {
-    optionsResolved: TOptions;
-    dotenv: ProcessEnv;
-    plugins?: Record<string, unknown>;
-    pluginConfigs?: Record<string, unknown>;
-};
-
 /** src/cliHost/definePlugin.ts
  * Plugin contracts for the GetDotenv CLI host.
  *
@@ -223,6 +145,14 @@ interface GetDotenvCliPlugin {
     use: (child: GetDotenvCliPlugin) => GetDotenvCliPlugin;
 }
 
+/** * Per-invocation context shared with plugins and actions. */
+type GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions> = {
+    optionsResolved: TOptions;
+    dotenv: ProcessEnv;
+    plugins?: Record<string, unknown>;
+    pluginConfigs?: Record<string, unknown>;
+};
+
 declare const demoPlugin: () => GetDotenvCliPlugin;
 
 export { demoPlugin };

package/dist/plugins-demo.mjs

@@ -137,6 +137,48 @@ const runCommand = async (command, shell, opts) => {
     }
 };
 
+const dropUndefined = (bag) => Object.fromEntries(Object.entries(bag).filter((e) => typeof e[1] === 'string'));
+/** Build a sanitized env for child processes from base + overlay. */
+const buildSpawnEnv = (base, overlay) => {
+    const raw = {
+        ...(base ?? {}),
+        ...(overlay ?? {}),
+    };
+    // Drop undefined first
+    const entries = Object.entries(dropUndefined(raw));
+    if (process.platform === 'win32') {
+        // Windows: keys are case-insensitive; collapse duplicates
+        const byLower = new Map();
+        for (const [k, v] of entries) {
+            byLower.set(k.toLowerCase(), [k, v]); // last wins; preserve latest casing
+        }
+        const out = {};
+        for (const [, [k, v]] of byLower)
+            out[k] = v;
+        // HOME fallback from USERPROFILE (common expectation)
+        if (!Object.prototype.hasOwnProperty.call(out, 'HOME')) {
+            const up = out['USERPROFILE'];
+            if (typeof up === 'string' && up.length > 0)
+                out['HOME'] = up;
+        }
+        // Normalize TMP/TEMP coherence (pick any present; reflect to both)
+        const tmp = out['TMP'] ?? out['TEMP'];
+        if (typeof tmp === 'string' && tmp.length > 0) {
+            out['TMP'] = tmp;
+            out['TEMP'] = tmp;
+        }
+        return out;
+    }
+    // POSIX: keep keys as-is
+    const out = Object.fromEntries(entries);
+    // Ensure TMPDIR exists when any temp key is present (best-effort)
+    const tmpdir = out['TMPDIR'] ?? out['TMP'] ?? out['TEMP'];
+    if (typeof tmpdir === 'string' && tmpdir.length > 0) {
+        out['TMPDIR'] = tmpdir;
+    }
+    return out;
+};
+
 /** src/cliHost/definePlugin.ts
  * Plugin contracts for the GetDotenv CLI host.
  *
@@ -247,7 +289,7 @@ const demoPlugin = () => definePlugin({
             const dotenv = (ctx?.dotenv ?? {});
             // Inherit stdio for an interactive demo. Use --capture for CI.
             await runCommand(['node', '-e', code], false, {
-                env: { ...process.env, ...dotenv },
+                env: buildSpawnEnv(process.env, dotenv),
                 stdio: 'inherit',
             });
         });
@@ -284,20 +326,23 @@ const demoPlugin = () => definePlugin({
             const ctx = cli.getCtx();
             const dotenv = (ctx?.dotenv ?? {});
             await runCommand(resolved, shell, {
-                env: { ...process.env, ...dotenv },
+                env: buildSpawnEnv(process.env, dotenv),
                 stdio: 'inherit',
             });
         });
     },
     /**
      * Optional: afterResolve can initialize per-plugin state using ctx.dotenv.
-     * For the demo we just log once to hint where such logic would live.
+     * For the demo we emit a single breadcrumb only when GETDOTENV_DEBUG is set,
+     * keeping default runs (tests/CI/smoke) quiet.
      */
     afterResolve(_cli, ctx) {
-        const keys = Object.keys(ctx.dotenv);
-        if (keys.length > 0) {
-            // Keep noise low; a single-line breadcrumb is sufficient for the demo.
-            console.error('[demo] afterResolve: dotenv keys loaded:', keys.length);
+        if (process.env.GETDOTENV_DEBUG) {
+            const keys = Object.keys(ctx.dotenv);
+            if (keys.length > 0) {
+                // Keep noise low; a single-line breadcrumb is sufficient for the demo.
+                console.error('[demo] afterResolve: dotenv keys loaded:', keys.length);
+            }
         }
     },
 });

package/dist/plugins-init.d.cts

@@ -1,76 +1,6 @@
 import { Command } from 'commander';
 import { ZodType } from 'zod';
 
-/**
- * Minimal root options shape shared by CLI and generator layers.
- * Keep keys optional to respect exactOptionalPropertyTypes semantics.
- */
-type RootOptionsShape = {
-    env?: string;
-    vars?: string;
-    command?: string;
-    outputPath?: string;
-    shell?: string | boolean;
-    loadProcess?: boolean;
-    excludeAll?: boolean;
-    excludeDynamic?: boolean;
-    excludeEnv?: boolean;
-    excludeGlobal?: boolean;
-    excludePrivate?: boolean;
-    excludePublic?: boolean;
-    log?: boolean;
-    debug?: boolean;
-    capture?: boolean;
-    strict?: boolean;
-    redact?: boolean;
-    warnEntropy?: boolean;
-    entropyThreshold?: number;
-    entropyMinLength?: number;
-    entropyWhitelist?: string[];
-    redactPatterns?: string[];
-    defaultEnv?: string;
-    dotenvToken?: string;
-    dynamicPath?: string;
-    trace?: boolean | string[];
-    paths?: string;
-    pathsDelimiter?: string;
-    pathsDelimiterPattern?: string;
-    privateToken?: string;
-    varsDelimiter?: string;
-    varsDelimiterPattern?: string;
-    varsAssignor?: string;
-    varsAssignorPattern?: string;
-    scripts?: ScriptsTable;
-};
-/**
- * Scripts table shape (configurable shell type).
- */
-type ScriptsTable<TShell extends string | boolean = string | boolean> = Record<string, string | {
-    cmd: string;
-    shell?: TShell;
-}>;
-
-/**
- * Adapter-layer augmentation: add chainable helpers to GetDotenvCli without
- * coupling the core host to cliCore. Importing this module has side effects:
- * it extends the prototype and merges types for consumers.
- */
-declare module '../cliHost/GetDotenvCli' {
-    interface GetDotenvCli {
-        /**
-         * Attach legacy root flags to this CLI instance. Defaults come from
-         * baseRootOptionDefaults when none are provided.     */
-        attachRootOptions(defaults?: Partial<RootOptionsShape>, opts?: {
-            includeCommandOption?: boolean;
-        }): this;
-        /**
-         * Install a preSubcommand hook that merges CLI flags (including parent
-         * round-trip) and resolves the dotenv context before executing actions.
-         * Defaults come from baseRootOptionDefaults when none are provided.
-         */ passOptions(defaults?: Partial<RootOptionsShape>): this;
-    }
-}
-
 /**
  * A minimal representation of an environment key/value mapping.
  * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
@@ -165,14 +95,6 @@ interface GetDotenvOptions {
     useConfigLoader?: boolean;
 }
 
-/** * Per-invocation context shared with plugins and actions. */
-type GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions> = {
-    optionsResolved: TOptions;
-    dotenv: ProcessEnv;
-    plugins?: Record<string, unknown>;
-    pluginConfigs?: Record<string, unknown>;
-};
-
 /** src/cliHost/definePlugin.ts
  * Plugin contracts for the GetDotenv CLI host.
  *
@@ -223,6 +145,14 @@ interface GetDotenvCliPlugin {
     use: (child: GetDotenvCliPlugin) => GetDotenvCliPlugin;
 }
 
+/** * Per-invocation context shared with plugins and actions. */
+type GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions> = {
+    optionsResolved: TOptions;
+    dotenv: ProcessEnv;
+    plugins?: Record<string, unknown>;
+    pluginConfigs?: Record<string, unknown>;
+};
+
 type InitPluginOptions = {
     logger?: Logger;
 };