@karmaniverous/get-dotenv 5.2.6 → 6.0.0-1

package/dist/config.d.ts

@@ -1,8 +1,13 @@
-type Scripts = Record<string, string | {
+/**
+ * Scripts table shape (configurable shell type).
+ */
+type ScriptsTable<TShell extends string | boolean = string | boolean> = Record<string, string | {
     cmd: string;
-    shell?: string | boolean;
+    shell?: TShell | undefined;
 }>;
 
+type Scripts = ScriptsTable;
+
 type GetDotenvConfigResolved = {
     dotenvToken?: string;
     privateToken?: string;

package/dist/env-overlay.d.ts

@@ -1,12 +1,19 @@
 /**
- * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
-
-type Scripts = Record<string, string | {
+ * Scripts table shape (configurable shell type).
+ */
+type ScriptsTable<TShell extends string | boolean = string | boolean> = Record<string, string | {
     cmd: string;
-    shell?: string | boolean;
+    shell?: TShell | undefined;
 }>;
 
+type Scripts = ScriptsTable;
+
+/**
+ * A minimal representation of an environment key/value mapping.
+ * Values may be `undefined` to represent "unset".
+ */
+type ProcessEnv = Record<string, string | undefined>;
+
 type GetDotenvConfigResolved = {
     dotenvToken?: string;
     privateToken?: string;
@@ -39,12 +46,17 @@ type OverlayConfigSources = {
  * Programmatic explicit vars (if provided) override all config slices.
  * Progressive expansion is applied within each slice.
  */
-declare const overlayEnv: ({ base, env, configs, programmaticVars, }: {
-    base: ProcessEnv;
+declare function overlayEnv<B extends ProcessEnv | Readonly<Record<string, string | undefined>>>(args: {
+    base: B;
+    env: string | undefined;
+    configs: OverlayConfigSources;
+}): B;
+declare function overlayEnv<B extends ProcessEnv | Readonly<Record<string, string | undefined>>, P extends ProcessEnv | Readonly<Record<string, string | undefined>>>(args: {
+    base: B;
     env: string | undefined;
     configs: OverlayConfigSources;
-    programmaticVars?: ProcessEnv;
-}) => ProcessEnv;
+    programmaticVars: P;
+}): B & P;
 
 export { overlayEnv };
 export type { OverlayConfigSources };

package/dist/env-overlay.mjs

@@ -109,14 +109,18 @@ const dotenvExpand = (value, ref = process.env) => {
  * When `progressive` is true, each expanded key becomes available for
  * subsequent expansions in the same object (left-to-right by object key order).
  */
-const dotenvExpandAll = (values = {}, options = {}) => Object.keys(values).reduce((acc, key) => {
-    const { ref = process.env, progressive = false } = options;
-    acc[key] = dotenvExpand(values[key], {
-        ...ref,
-        ...(progressive ? acc : {}),
-    });
-    return acc;
-}, {});
+function dotenvExpandAll(values, options = {}) {
+    const { ref = process.env, progressive = false, } = options;
+    const out = Object.keys(values).reduce((acc, key) => {
+        acc[key] = dotenvExpand(values[key], {
+            ...ref,
+            ...(progressive ? acc : {}),
+        });
+        return acc;
+    }, {});
+    // Key-preserving return with a permissive index signature to allow later additions.
+    return out;
+}
 
 const applyKv = (current, kv) => {
     if (!kv || Object.keys(kv).length === 0)
@@ -132,16 +136,7 @@ const applyConfigSlice = (current, cfg, env) => {
     const envKv = env && cfg.envVars ? cfg.envVars[env] : undefined;
     return applyKv(afterGlobal, envKv);
 };
-/**
- * Overlay config-provided values onto a base ProcessEnv using precedence axes:
- * - kind: env \> global
- * - privacy: local \> public
- * - source: project \> packaged \> base
- *
- * Programmatic explicit vars (if provided) override all config slices.
- * Progressive expansion is applied within each slice.
- */
-const overlayEnv = ({ base, env, configs, programmaticVars, }) => {
+function overlayEnv({ base, env, configs, programmaticVars, }) {
     let current = { ...base };
     // Source: packaged (public -> local)
     current = applyConfigSlice(current, configs.packaged, env);
@@ -156,6 +151,6 @@ const overlayEnv = ({ base, env, configs, programmaticVars, }) => {
         current = applyKv(current, toApply);
     }
     return current;
-};
+}
 
 export { overlayEnv };