@karmaniverous/get-dotenv 7.0.6 → 7.0.8

package/dist/plugins.d.ts

@@ -272,7 +272,7 @@ type ProcessEnv = Record<string, string | undefined>;
  * and the selected environment (if any), and returns either a string to set
  * or `undefined` to unset/skip the variable.
  */
-type GetDotenvDynamicFunction = (vars: ProcessEnv, env: string | undefined) => string | undefined;
+type GetDotenvDynamicFunction = (vars: ProcessEnv, env: string | undefined) => string | null | undefined;
 /**
  * A map of dynamic variable definitions.
  * Keys are variable names; values are either literal strings or functions.
@@ -358,6 +358,12 @@ interface ResolveAndLoadOptions {
      * @default true
      */
     runAfterResolve?: boolean;
+    /**
+     * Name of the invoked subcommand (plugin namespace). When provided,
+     * only the matching plugin subtree runs afterResolve hooks.
+     * When omitted, all plugins run afterResolve (backward compatibility).
+     */
+    invokedSubcommand?: string;
 }
 /**
  * Structural public interface for the host exposed to plugins.
@@ -451,6 +457,11 @@ interface GetDotenvCliPlugin<TOptions extends GetDotenvOptions = GetDotenvOption
      * After the dotenv context is resolved, initialize any clients/secrets
      * or attach per-plugin state under ctx.plugins (by convention).
      * Runs parent → children (pre-order).
+     *
+     * **Scoping**: When the host provides an invoked subcommand filter,
+     * afterResolve only fires for plugins whose namespace matches the
+     * invoked command path. A plugin's afterResolve should never produce
+     * side effects for commands outside its subtree.
      */
     afterResolve?: (cli: GetDotenvCliPublic<TOptions, TArgs, TOpts, TGlobal>, ctx: GetDotenvCliCtx<TOptions>) => void | Promise<void>;
     /** Zod schema for this plugin's config slice (from config.plugins[…]). */
@@ -559,6 +570,7 @@ interface BatchPluginOptions {
  * - scripts/shell: used to resolve command and shell behavior per script or global default.
  */
 declare const batchPlugin: (opts?: BatchPluginOptions) => PluginWithInstanceHelpers<GetDotenvOptions, {
+    concurrency?: number | undefined;
     scripts?: Record<string, string | {
         cmd: string;
         shell?: string | boolean | undefined;
@@ -566,6 +578,7 @@ declare const batchPlugin: (opts?: BatchPluginOptions) => PluginWithInstanceHelp
     shell?: string | boolean | undefined;
     rootPath?: string | undefined;
     globs?: string | undefined;
+    parallel?: boolean | undefined;
     pkgCwd?: boolean | undefined;
 }, [], {}, {}>;
 

package/dist/plugins.mjs

@@ -1,12 +1,12 @@
 export { awsPlugin, getAwsRegion } from './plugins-aws.mjs';
-export { R as awsWhoamiPlugin } from './chunks/index-BuxEK_Z4.mjs';
+export { a as awsWhoamiPlugin } from './chunks/index-CNXekCQC.mjs';
 export { batchPlugin } from './plugins-batch.mjs';
-export { c as cmdPlugin } from './chunks/index-Dd6S1nZ-.mjs';
+export { c as cmdPlugin } from './chunks/index-DnG3N6yj.mjs';
 export { initPlugin } from './plugins-init.mjs';
-import './chunks/readMergedOptions-CraAnYdB.mjs';
+import './chunks/readMergedOptions-BT1C87_u.mjs';
 import 'zod';
 import '@commander-js/extra-typings';
-import './chunks/readDotenvCascade-Dgx4SC1p.mjs';
+import './chunks/readDotenvCascade-CfFPgLCp.mjs';
 import 'fs-extra';
 import 'radash';
 import 'node:buffer';
@@ -17,20 +17,16 @@ import 'path';
 import 'url';
 import 'dotenv';
 import 'nanoid';
-import './chunks/loader-V1vbmtyw.mjs';
+import './chunks/loader-C3DtD6HB.mjs';
 import 'package-directory';
 import 'yaml';
 import 'execa';
-import './chunks/spawnEnv-CKgnHGpr.mjs';
-import 'node:os';
-import 'node:fs/promises';
-import 'node:stream';
-import 'node:crypto';
-import 'node:fs';
-import 'node:https';
-import 'node:process';
+import './chunks/spawnEnv-DvisqPiU.mjs';
+import '@aws-sdk/client-sts';
 import './chunks/invoke-DuRPU1oC.mjs';
 import 'globby';
-import './chunks/resolveCliOptions-BMBkWDYJ.mjs';
+import 'os';
+import './chunks/resolveCliOptions-BbfouWSK.mjs';
+import 'node:process';
 import 'readline/promises';
 import 'node:url';

package/package.json

@@ -1,11 +1,5 @@
 {
   "author": "Jason Williscroft",
-  "auto-changelog": {
-    "output": "CHANGELOG.md",
-    "unreleased": true,
-    "commitLimit": false,
-    "hideCredit": true
-  },
   "bin": {
     "getdotenv": "./dist/getdotenv.cli.mjs"
   },
@@ -15,59 +9,59 @@
   "dependencies": {
     "@commander-js/extra-typings": "^14.0.0",
     "commander": "^14.0.2",
-    "dotenv": "^17.2.3",
+    "dotenv": "^17.4.2",
     "execa": "^9.6.1",
-    "fs-extra": "^11.3.3",
+    "fs-extra": "^11.3.5",
     "globby": "^16",
-    "nanoid": "^5.1.6",
-    "package-directory": "^8.1.0",
+    "nanoid": "^5.1.11",
+    "package-directory": "^8.2.0",
     "radash": "^12.1.1",
-    "yaml": "^2.8.2",
-    "zod": "^4.3.5"
+    "yaml": "^2.9.0",
+    "zod": "^4.4.3"
   },
   "description": "Process dotenv files in an arbitrary location & optionally populate environment variables.",
   "devDependencies": {
-    "@aws-sdk/client-sts": "^3.965.0",
-    "@dotenvx/dotenvx": "^1.51.4",
-    "@eslint/js": "^9.39.2",
+    "@aws-sdk/client-sts": "^3.1061.0",
+    "@dotenvx/dotenvx": "^1.71.0",
+    "@eslint/js": "^10.0.1",
     "@rollup/plugin-alias": "^6.0.0",
-    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-commonjs": "^29.0.3",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-typescript": "^12.3.0",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^25",
-    "@vitest/coverage-v8": "^4.0.16",
-    "@vitest/eslint-plugin": "^1.6.6",
-    "auto-changelog": "^2.5.0",
+    "@vitest/coverage-v8": "^4.1.8",
+    "@vitest/eslint-plugin": "^1.6.19",
     "cross-env": "^10.1.0",
     "esbuild": "^0.27.2",
-    "eslint": "^9.39.2",
+    "eslint": "^10.4.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-jsonc": "^2.21.0",
-    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-prettier": "^5.5.6",
     "eslint-plugin-simple-import-sort": "^12.1.1",
-    "eslint-plugin-tsdoc": "^0.5.0",
-    "fs-extra": "^11.3.3",
-    "globals": "^17.0.0",
+    "eslint-plugin-tsdoc": "^0.5.2",
+    "fs-extra": "^11.3.5",
+    "git-cliff": "^2.13.1",
+    "globals": "^17.6.0",
     "jsonc-eslint-parser": "^2.4.2",
     "knip": "^5.80.0",
-    "lefthook": "^2.0.13",
+    "lefthook": "^2.1.9",
     "npm-packlist": "^10.0.3",
-    "prettier": "^3.7.4",
+    "prettier": "^3.8.3",
     "release-it": "^19.2.3",
-    "rimraf": "^6.1.2",
-    "rollup": "^4.55.1",
-    "rollup-plugin-dts": "^6.3.0",
+    "rimraf": "^6.1.3",
+    "rollup": "^4.61.1",
+    "rollup-plugin-dts": "^6.4.1",
     "tslib": "^2.8.1",
-    "tsx": "^4.21.0",
-    "typedoc": "^0.28.15",
-    "typedoc-plugin-mdn-links": "^5.0.10",
+    "tsx": "^4.22.4",
+    "typedoc": "^0.28.19",
+    "typedoc-plugin-mdn-links": "^5.1.1",
     "typedoc-plugin-replace-text": "^4.2.0",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.52.0",
-    "vite-tsconfig-paths": "^6.0.3",
-    "vitest": "^4.0.16"
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.60.1",
+    "vite-tsconfig-paths": "^6.1.1",
+    "vitest": "^4.1.8"
   },
   "engines": {
     "node": ">=20"
@@ -137,6 +131,7 @@
   "files": [
     "dist",
     "getdotenv.config.json",
+    "schema",
     "templates"
   ],
   "homepage": "https://github.com/karmaniverous/get-dotenv#readme",
@@ -156,9 +151,13 @@
   "main": "dist/index.mjs",
   "name": "@karmaniverous/get-dotenv",
   "peerDependencies": {
+    "@aws-sdk/client-sts": "^3.965.0",
     "esbuild": "*"
   },
   "peerDependenciesMeta": {
+    "@aws-sdk/client-sts": {
+      "optional": true
+    },
     "esbuild": {
       "optional": true
     }
@@ -168,7 +167,7 @@
   },
   "release-it": {
     "git": {
-      "changelog": "npx auto-changelog --stdout --template https://raw.githubusercontent.com/release-it/release-it/main/templates/changelog-compact.hbs",
+      "changelog": "npx git-cliff --latest --strip header",
       "commitMessage": "chore: release v${version}",
       "requireBranch": "main"
     },
@@ -200,10 +199,11 @@
     "url": "https://github.com/karmaniverous/get-dotenv"
   },
   "scripts": {
-    "build": "rimraf dist && rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
+    "generate:schema": "tsx tools/generate-schema.js",
+    "build": "npm run generate:schema && rimraf dist && rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
     "cli": "tsx src/cli/getdotenv",
     "cli:dist": "node dist/getdotenv.cli.mjs",
-    "changelog": "auto-changelog",
+    "changelog": "git-cliff -o CHANGELOG.md",
     "docs": "typedoc",
     "pack:dry": "npm pack --dry-run",
     "knip": "knip",
@@ -221,5 +221,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "7.0.6"
+  "version": "7.0.8"
 }

package/schema/getdotenv.config.schema.json

@@ -0,0 +1,207 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "rootOptionDefaults": {
+      "type": "object",
+      "properties": {
+        "defaultEnv": {
+          "type": "string"
+        },
+        "defaultEnvKey": {
+          "type": "string"
+        },
+        "dotenvToken": {
+          "type": "string"
+        },
+        "dynamicPath": {
+          "type": "string"
+        },
+        "dynamic": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        },
+        "env": {
+          "type": "string"
+        },
+        "excludeDynamic": {
+          "type": "boolean"
+        },
+        "excludeEnv": {
+          "type": "boolean"
+        },
+        "excludeGlobal": {
+          "type": "boolean"
+        },
+        "excludePrivate": {
+          "type": "boolean"
+        },
+        "excludePublic": {
+          "type": "boolean"
+        },
+        "loadProcess": {
+          "type": "boolean"
+        },
+        "log": {
+          "type": "boolean"
+        },
+        "outputPath": {
+          "type": "string"
+        },
+        "paths": {
+          "type": "string"
+        },
+        "privateToken": {
+          "type": "string"
+        },
+        "vars": {
+          "type": "string"
+        },
+        "debug": {
+          "type": "boolean"
+        },
+        "strict": {
+          "type": "boolean"
+        },
+        "capture": {
+          "type": "boolean"
+        },
+        "trace": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ]
+        },
+        "redact": {
+          "type": "boolean"
+        },
+        "warnEntropy": {
+          "type": "boolean"
+        },
+        "entropyThreshold": {
+          "type": "number"
+        },
+        "entropyMinLength": {
+          "type": "number"
+        },
+        "entropyWhitelist": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "redactPatterns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "pathsDelimiter": {
+          "type": "string"
+        },
+        "pathsDelimiterPattern": {
+          "type": "string"
+        },
+        "scripts": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        },
+        "shell": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "string"
+            }
+          ]
+        },
+        "varsAssignor": {
+          "type": "string"
+        },
+        "varsAssignorPattern": {
+          "type": "string"
+        },
+        "varsDelimiter": {
+          "type": "string"
+        },
+        "varsDelimiterPattern": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "rootOptionVisibility": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "boolean"
+      }
+    },
+    "scripts": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {}
+    },
+    "requiredKeys": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "schema": {},
+    "vars": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "envVars": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "object",
+        "propertyNames": {
+          "type": "string"
+        },
+        "additionalProperties": {
+          "type": "string"
+        }
+      }
+    },
+    "dynamic": {},
+    "plugins": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {}
+    }
+  },
+  "additionalProperties": false,
+  "$id": "https://raw.githubusercontent.com/karmaniverous/get-dotenv/main/schema/getdotenv.config.schema.json",
+  "title": "get-dotenv Configuration",
+  "description": "Schema for getdotenv.config.json configuration files. See https://github.com/karmaniverous/get-dotenv"
+}