@karmaniverous/get-dotenv 6.5.2 → 7.0.0

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

@@ -173,6 +173,23 @@ const baseRootOptionDefaults = {
  * - Provide Vars-aware defineDynamic and a typed config builder defineGetDotenvConfig\<Vars, Env\>().
  * - Preserve existing behavior for defaults resolution and compat converters.
  */
+/**
+ * Validate that a candidate object satisfies the {@link Logger} contract.
+ * Throws if the candidate is invalid.
+ */
+const assertLogger = (candidate) => {
+    if (!candidate || typeof candidate !== 'object') {
+        throw new Error('logger must be an object');
+    }
+    const l = candidate;
+    if (typeof l.debug !== 'function' ||
+        typeof l.info !== 'function' ||
+        typeof l.warn !== 'function' ||
+        typeof l.error !== 'function') {
+        throw new Error('logger must implement debug, info, warn, and error methods');
+    }
+    return l;
+};
 function defineDynamic(d) {
     return d;
 }
@@ -266,8 +283,12 @@ const resolveGetDotenvOptions = (customOptions) => {
     const mergedDefaults = baseRootOptionDefaults;
     const defaultsFromCli = getDotenvCliOptions2Options(mergedDefaults);
     const result = defaultsDeep(defaultsFromCli, customOptions);
+    // Validate the logger (defaults to console if missing/merged).
+    // We use the merged result, so if the user didn't provide one, we get the default (console).
+    const validatedLogger = assertLogger(result.logger);
     return Promise.resolve({
-        ...result, // Keep explicit empty strings/zeros; drop only undefined
+        ...result,
+        logger: validatedLogger,
         vars: shake(result.vars ?? {}, (v) => v === undefined),
     });
 };
@@ -396,7 +417,7 @@ const computeContext = async (customOptions, plugins, hostMetaUrl) => {
     }
     const logger = validated.logger;
     if (validated.log)
-        logger.log(dotenv);
+        logger.info(dotenv);
     if (validated.loadProcess)
         Object.assign(process.env, dotenv);
     // Merge and validate per-plugin config keyed by realized path (ns chain).
@@ -1415,4 +1436,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, defineDynamic as f, getDotenvCliOptions2Options as g, defineGetDotenvConfig as h, interpolateDeep as i, readMergedOptions as r, writeDotenvFile as w };
+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 };

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

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

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

@@ -1,4 +1,4 @@
-import { m as fromBase64, n as toBase64, o as toHex, t as toUtf8, q as fromArrayBuffer, r as streamCollector$1 } from './index-CDPFly99.mjs';
+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';
 
 const isReadableStream = (stream) => typeof ReadableStream === "function" &&

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

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

package/dist/cli.d.ts

@@ -377,9 +377,11 @@ type GetDotenvDynamicFunction = (vars: ProcessEnv, env: string | undefined) => s
  */
 type GetDotenvDynamic = Record<string, GetDotenvDynamicFunction | ReturnType<GetDotenvDynamicFunction>>;
 /**
- * Logger interface compatible with `console` or a subset thereof.
+ * Logger interface compatible with AWS SDK v3 expectations (`debug`, `info`, `warn`, `error`).
+ * Consumers must provide an object that implements these four methods.
+ * Additional methods (like `log`) are allowed but not required or used by this library.
  */
-type Logger = Record<string, (...args: unknown[]) => void> | typeof console;
+type Logger = Pick<Console, 'debug' | 'info' | 'warn' | 'error'>;
 /**
  * Canonical programmatic options type (schema-derived).
  * This type is the single source of truth for programmatic options.

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-export { c as createCli } from './chunks/createCli-pZgHlwKX.mjs';
+export { c as createCli } from './chunks/createCli-B9-MIwWj.mjs';
 import 'zod';
 import 'path';
 import './chunks/loader-CE4HSRN4.mjs';
@@ -13,16 +13,16 @@ import './chunks/loadModuleDefault-Dj8B3Stt.mjs';
 import 'crypto';
 import '@commander-js/extra-typings';
 import 'nanoid';
-import './chunks/readMergedOptions-uWSetyes.mjs';
+import './chunks/readMergedOptions-D6niy_Ep.mjs';
 import './chunks/readDotenvCascade-HLU7FsEQ.mjs';
 import 'dotenv';
 import 'execa';
 import './chunks/helpConfig-CGejgwWW.mjs';
-import './chunks/resolveCliOptions-7MwNdHqz.mjs';
+import './chunks/resolveCliOptions-PWF1aEM9.mjs';
 import './chunks/validate-CDl0rE6k.mjs';
 import './plugins-aws.mjs';
 import './chunks/spawnEnv-5kdIVv0x.mjs';
-import './chunks/index-CDPFly99.mjs';
+import './chunks/index-AssUn9IY.mjs';
 import 'buffer';
 import 'os';
 import 'node:fs/promises';
@@ -34,7 +34,7 @@ import 'node:fs';
 import './plugins-batch.mjs';
 import './chunks/invoke-DuRPU1oC.mjs';
 import 'globby';
-import './chunks/index-Cg50N4ys.mjs';
+import './chunks/index-CAtxK29A.mjs';
 import './plugins-init.mjs';
 import 'node:process';
 import 'readline/promises';

package/dist/cliHost.d.ts

@@ -383,9 +383,11 @@ type GetDotenvDynamicFunction = (vars: ProcessEnv, env: string | undefined) => s
  */
 type GetDotenvDynamic = Record<string, GetDotenvDynamicFunction | ReturnType<GetDotenvDynamicFunction>>;
 /**
- * Logger interface compatible with `console` or a subset thereof.
+ * Logger interface compatible with AWS SDK v3 expectations (`debug`, `info`, `warn`, `error`).
+ * Consumers must provide an object that implements these four methods.
+ * Additional methods (like `log`) are allowed but not required or used by this library.
  */
-type Logger = Record<string, (...args: unknown[]) => void> | typeof console;
+type Logger = Pick<Console, 'debug' | 'info' | 'warn' | 'error'>;
 /**
  * Canonical programmatic options type (schema-derived).
  * This type is the single source of truth for programmatic options.

package/dist/cliHost.mjs

@@ -1,7 +1,7 @@
-export { G as GetDotenvCli, d as definePlugin, r as readMergedOptions } from './chunks/readMergedOptions-uWSetyes.mjs';
+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-7MwNdHqz.mjs';
-export { d as defineScripts, g as groupPlugins } from './chunks/types-BSMtAo8_.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 { 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';

package/dist/getdotenv.cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { c as createCli } from './chunks/createCli-pZgHlwKX.mjs';
+import { c as createCli } from './chunks/createCli-B9-MIwWj.mjs';
 import 'zod';
 import 'path';
 import './chunks/loader-CE4HSRN4.mjs';
@@ -14,16 +14,16 @@ import './chunks/loadModuleDefault-Dj8B3Stt.mjs';
 import 'crypto';
 import '@commander-js/extra-typings';
 import 'nanoid';
-import './chunks/readMergedOptions-uWSetyes.mjs';
+import './chunks/readMergedOptions-D6niy_Ep.mjs';
 import './chunks/readDotenvCascade-HLU7FsEQ.mjs';
 import 'dotenv';
 import 'execa';
 import './chunks/helpConfig-CGejgwWW.mjs';
-import './chunks/resolveCliOptions-7MwNdHqz.mjs';
+import './chunks/resolveCliOptions-PWF1aEM9.mjs';
 import './chunks/validate-CDl0rE6k.mjs';
 import './plugins-aws.mjs';
 import './chunks/spawnEnv-5kdIVv0x.mjs';
-import './chunks/index-CDPFly99.mjs';
+import './chunks/index-AssUn9IY.mjs';
 import 'buffer';
 import 'os';
 import 'node:fs/promises';
@@ -35,7 +35,7 @@ import 'node:fs';
 import './plugins-batch.mjs';
 import './chunks/invoke-DuRPU1oC.mjs';
 import 'globby';
-import './chunks/index-Cg50N4ys.mjs';
+import './chunks/index-CAtxK29A.mjs';
 import './plugins-init.mjs';
 import 'node:process';
 import 'readline/promises';

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 import { z, ZodObject } from 'zod';
-export { z } from 'zod';
 import { OptionValues, Command, InferCommandArguments, Option, CommandUnknownOpts } from '@commander-js/extra-typings';
 
 /**
@@ -398,9 +397,16 @@ type GetDotenvDynamicFunction = (vars: ProcessEnv, env: string | undefined) => s
  */
 type GetDotenvDynamic = Record<string, GetDotenvDynamicFunction | ReturnType<GetDotenvDynamicFunction>>;
 /**
- * Logger interface compatible with `console` or a subset thereof.
+ * Logger interface compatible with AWS SDK v3 expectations (`debug`, `info`, `warn`, `error`).
+ * Consumers must provide an object that implements these four methods.
+ * Additional methods (like `log`) are allowed but not required or used by this library.
  */
-type Logger = Record<string, (...args: unknown[]) => void> | typeof console;
+type Logger = Pick<Console, 'debug' | 'info' | 'warn' | 'error'>;
+/**
+ * Validate that a candidate object satisfies the {@link Logger} contract.
+ * Throws if the candidate is invalid.
+ */
+declare const assertLogger: (candidate: unknown) => Logger;
 /**
  * Canonical programmatic options type (schema-derived).
  * This type is the single source of truth for programmatic options.
@@ -1094,7 +1100,7 @@ interface BaseRootOptionDefaults {
     /** When true, load composed values into `process.env`. */
     loadProcess: boolean;
     /** Logger used by the host and plugins (console-compatible). */
-    logger: typeof console;
+    logger: Pick<Console, 'debug' | 'info' | 'warn' | 'error'>;
     /** Enable entropy warnings (presentation-only). */
     warnEntropy: boolean;
     /** Entropy threshold (bits/char) used for warnings. */
@@ -1923,5 +1929,5 @@ interface TokenizeOptions {
  */
 declare const tokenize: (command: string, opts?: TokenizeOptions) => string[];
 
-export { GetDotenvCli, applyDotenvEdits, applyIncludeExclude, assertByteLimit, baseRootOptionDefaults, buildSpawnEnv, createCli, defaultsDeep, defineDynamic, defineGetDotenvConfig, definePlugin, defineScripts, dotenvExpand, dotenvExpandAll, dotenvExpandFromProcessEnv, editDotenvFile, editDotenvText, getDotenv, getDotenvCliOptions2Options, groupPlugins, interpolateDeep, loadModuleDefault, maybeWarnEntropy, parseDotenvDocument, parseFiniteNumber, parseNonNegativeInt, parsePositiveInt, readMergedOptions, redactDisplay, redactObject, renderDotenvDocument, requireString, shouldCapture, silentLogger, toNumber, tokenize, traceChildEnv, writeDotenvFile };
+export { GetDotenvCli, applyDotenvEdits, applyIncludeExclude, assertByteLimit, assertLogger, baseRootOptionDefaults, buildSpawnEnv, createCli, defaultsDeep, defineDynamic, defineGetDotenvConfig, definePlugin, defineScripts, dotenvExpand, dotenvExpandAll, dotenvExpandFromProcessEnv, editDotenvFile, editDotenvText, getDotenv, getDotenvCliOptions2Options, groupPlugins, interpolateDeep, loadModuleDefault, maybeWarnEntropy, parseDotenvDocument, parseFiniteNumber, parseNonNegativeInt, parsePositiveInt, readMergedOptions, redactDisplay, redactObject, renderDotenvDocument, requireString, shouldCapture, silentLogger, toNumber, tokenize, traceChildEnv, writeDotenvFile };
 export type { CreateCliOptions, DotenvAssignmentSegment, DotenvBareKeySegment, DotenvConfigProvenanceEntry, DotenvDocument, DotenvDuplicateKeyStrategy, DotenvDynamicProvenanceEntry, DotenvDynamicSource, DotenvEditMode, DotenvEditOptions, DotenvEolMode, DotenvFileProvenanceEntry, DotenvFs, DotenvPathSearchOrder, DotenvProvenance, DotenvProvenanceEntry, DotenvProvenanceEntryBase, DotenvProvenanceKind, DotenvProvenanceOp, DotenvSegment, DotenvTargetPrivacy, DotenvTargetScope, DotenvUpdateMap, DotenvUpdateValue, DotenvVarsProvenanceEntry, DynamicFn, DynamicMap, EditDotenvFileOptions, EditDotenvFileResult, EntropyOptions, GetDotenvCliOptions, GetDotenvCliPlugin, GetDotenvCliPublic, GetDotenvConfig, GetDotenvDynamic, GetDotenvOptions, InferGetDotenvVarsFromConfig, InferPluginConfig, PluginWithInstanceHelpers, ProcessEnv, RedactOptions, ScriptsTable, TokenizeOptions, TraceChildEnvOptions };

package/dist/index.mjs

@@ -1,17 +1,17 @@
-export { c as createCli } from './chunks/createCli-pZgHlwKX.mjs';
-import { e as resolveGetDotenvOptions, w as writeDotenvFile } from './chunks/readMergedOptions-uWSetyes.mjs';
-export { G as GetDotenvCli, b as baseRootOptionDefaults, a as defaultsDeep, f as defineDynamic, h as defineGetDotenvConfig, d as definePlugin, g as getDotenvCliOptions2Options, i as interpolateDeep, r as readMergedOptions } from './chunks/readMergedOptions-uWSetyes.mjs';
+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-BSMtAo8_.mjs';
+export { d as defineScripts, g as groupPlugins } from './chunks/types-Bp3u5-IH.mjs';
 import { omit, pick } from 'radash';
 import { Buffer } from 'node:buffer';
 export { l as loadModuleDefault } from './chunks/loadModuleDefault-Dj8B3Stt.mjs';
 import { InvalidArgumentError } from '@commander-js/extra-typings';
-export { z } from 'zod';
+import 'zod';
 import { nanoid } from 'nanoid';
 import path$1 from 'path';
-import { r as redactObject, m as maybeWarnEntropy } from './chunks/index-Cg50N4ys.mjs';
-export { a as redactDisplay, t as traceChildEnv } from './chunks/index-Cg50N4ys.mjs';
+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 fs from 'fs-extra';
@@ -24,10 +24,10 @@ import 'package-directory';
 import 'yaml';
 import 'execa';
 import './chunks/helpConfig-CGejgwWW.mjs';
-import './chunks/resolveCliOptions-7MwNdHqz.mjs';
+import './chunks/resolveCliOptions-PWF1aEM9.mjs';
 import './chunks/validate-CDl0rE6k.mjs';
 import './plugins-aws.mjs';
-import './chunks/index-CDPFly99.mjs';
+import './chunks/index-AssUn9IY.mjs';
 import 'buffer';
 import 'os';
 import 'node:fs/promises';
@@ -834,7 +834,6 @@ const silentLogger = {
     info: () => { },
     warn: () => { },
     error: () => { },
-    log: () => { },
 };
 
 /**
@@ -891,7 +890,7 @@ const parseNonNegativeInt = (label) => (raw) => {
 
 async function getDotenv(options = {}) {
     // Apply defaults.
-    const { defaultEnv, dotenvToken = '.env', dynamicPath, env, excludeDynamic = false, excludeEnv = false, excludeGlobal = false, excludePrivate = false, excludePublic = false, loadProcess = false, log = false, logger = console, outputPath, paths = [], privateToken = 'local', vars = {}, } = await resolveGetDotenvOptions(options);
+    const { defaultEnv, dotenvToken = '.env', dynamicPath, env, excludeDynamic = false, excludeEnv = false, excludeGlobal = false, excludePrivate = false, excludePublic = false, loadProcess = false, log = false, logger, outputPath, paths = [], privateToken = 'local', vars = {}, } = await resolveGetDotenvOptions(options);
     // Read .env files.
     const loaded = paths.length
         ? await paths.reduce(async (e, p) => {
@@ -968,7 +967,7 @@ async function getDotenv(options = {}) {
         const bag = redactFlag
             ? redactObject(resultDotenv, redOpts)
             : { ...resultDotenv };
-        logger.log(bag);
+        logger.info(bag);
         // Entropy warnings: once-per-key-per-run (presentation only)
         const warnEntropyVal = options.warnEntropy ?? true;
         const entropyThresholdVal = options
@@ -987,7 +986,7 @@ async function getDotenv(options = {}) {
             entOpts.entropyWhitelist = entropyWhitelistVal;
         for (const [k, v] of Object.entries(resultDotenv)) {
             maybeWarnEntropy(k, v, v !== undefined ? 'dotenv' : 'unset', entOpts, (line) => {
-                logger.log(line);
+                logger.info(line);
             });
         }
     }

package/dist/plugins-aws.d.ts

@@ -273,9 +273,11 @@ type GetDotenvDynamicFunction = (vars: ProcessEnv, env: string | undefined) => s
  */
 type GetDotenvDynamic = Record<string, GetDotenvDynamicFunction | ReturnType<GetDotenvDynamicFunction>>;
 /**
- * Logger interface compatible with `console` or a subset thereof.
+ * Logger interface compatible with AWS SDK v3 expectations (`debug`, `info`, `warn`, `error`).
+ * Consumers must provide an object that implements these four methods.
+ * Additional methods (like `log`) are allowed but not required or used by this library.
  */
-type Logger = Record<string, (...args: unknown[]) => void> | typeof console;
+type Logger = Pick<Console, 'debug' | 'info' | 'warn' | 'error'>;
 /**
  * Canonical programmatic options type (schema-derived).
  * This type is the single source of truth for programmatic options.

package/dist/plugins-aws.mjs

@@ -1,4 +1,4 @@
-import { r as readMergedOptions, d as definePlugin } from './chunks/readMergedOptions-uWSetyes.mjs';
+import { r as readMergedOptions, d as definePlugin } from './chunks/readMergedOptions-D6niy_Ep.mjs';
 import 'execa';
 import { isObject } from 'radash';
 import 'node:buffer';

package/dist/plugins-batch.d.ts

@@ -273,9 +273,11 @@ type GetDotenvDynamicFunction = (vars: ProcessEnv, env: string | undefined) => s
  */
 type GetDotenvDynamic = Record<string, GetDotenvDynamicFunction | ReturnType<GetDotenvDynamicFunction>>;
 /**
- * Logger interface compatible with `console` or a subset thereof.
+ * Logger interface compatible with AWS SDK v3 expectations (`debug`, `info`, `warn`, `error`).
+ * Consumers must provide an object that implements these four methods.
+ * Additional methods (like `log`) are allowed but not required or used by this library.
  */
-type Logger = Record<string, (...args: unknown[]) => void> | typeof console;
+type Logger = Pick<Console, 'debug' | 'info' | 'warn' | 'error'>;
 /**
  * Canonical programmatic options type (schema-derived).
  * This type is the single source of truth for programmatic options.

package/dist/plugins-batch.mjs

@@ -1,4 +1,4 @@
-import { r as readMergedOptions, d as definePlugin } from './chunks/readMergedOptions-uWSetyes.mjs';
+import { r as readMergedOptions, d as definePlugin } from './chunks/readMergedOptions-D6niy_Ep.mjs';
 import 'execa';
 import 'radash';
 import 'node:buffer';

package/dist/plugins-cmd.d.ts

@@ -273,9 +273,11 @@ type GetDotenvDynamicFunction = (vars: ProcessEnv, env: string | undefined) => s
  */
 type GetDotenvDynamic = Record<string, GetDotenvDynamicFunction | ReturnType<GetDotenvDynamicFunction>>;
 /**
- * Logger interface compatible with `console` or a subset thereof.
+ * Logger interface compatible with AWS SDK v3 expectations (`debug`, `info`, `warn`, `error`).
+ * Consumers must provide an object that implements these four methods.
+ * Additional methods (like `log`) are allowed but not required or used by this library.
  */
-type Logger = Record<string, (...args: unknown[]) => void> | typeof console;
+type Logger = Pick<Console, 'debug' | 'info' | 'warn' | 'error'>;
 /**
  * Canonical programmatic options type (schema-derived).
  * This type is the single source of truth for programmatic options.

package/dist/plugins-cmd.mjs

@@ -1,5 +1,5 @@
 import 'radash';
-import './chunks/readMergedOptions-uWSetyes.mjs';
+import './chunks/readMergedOptions-D6niy_Ep.mjs';
 import 'execa';
 import 'node:buffer';
 import 'fs-extra';
@@ -14,9 +14,9 @@ import './chunks/loader-CE4HSRN4.mjs';
 import 'package-directory';
 import 'yaml';
 import 'zod';
-export { c as cmdPlugin } from './chunks/index-Cg50N4ys.mjs';
+export { c as cmdPlugin } from './chunks/index-CAtxK29A.mjs';
 import './chunks/readDotenvCascade-HLU7FsEQ.mjs';
 import './chunks/loadModuleDefault-Dj8B3Stt.mjs';
 import './chunks/spawnEnv-5kdIVv0x.mjs';
 import './chunks/invoke-DuRPU1oC.mjs';
-import './chunks/resolveCliOptions-7MwNdHqz.mjs';
+import './chunks/resolveCliOptions-PWF1aEM9.mjs';

package/dist/plugins-init.d.ts

@@ -273,9 +273,11 @@ type GetDotenvDynamicFunction = (vars: ProcessEnv, env: string | undefined) => s
  */
 type GetDotenvDynamic = Record<string, GetDotenvDynamicFunction | ReturnType<GetDotenvDynamicFunction>>;
 /**
- * Logger interface compatible with `console` or a subset thereof.
+ * Logger interface compatible with AWS SDK v3 expectations (`debug`, `info`, `warn`, `error`).
+ * Consumers must provide an object that implements these four methods.
+ * Additional methods (like `log`) are allowed but not required or used by this library.
  */
-type Logger = Record<string, (...args: unknown[]) => void> | typeof console;
+type Logger = Pick<Console, 'debug' | 'info' | 'warn' | 'error'>;
 /**
  * Canonical programmatic options type (schema-derived).
  * This type is the single source of truth for programmatic options.

package/dist/plugins-init.mjs

@@ -1,4 +1,4 @@
-import { r as readMergedOptions, d as definePlugin } from './chunks/readMergedOptions-uWSetyes.mjs';
+import { r as readMergedOptions, d as definePlugin } from './chunks/readMergedOptions-D6niy_Ep.mjs';
 import 'execa';
 import 'radash';
 import 'node:buffer';
@@ -229,14 +229,14 @@ const isNonInteractive = () => {
  * @returns A single-character decision code.
  */
 const promptDecision = async (filePath, logger, rl) => {
-    logger.log(`File exists: ${filePath}\nChoose: [o]verwrite, [e]xample, [s]kip, [O]verwrite All, [E]xample All, [S]kip All`);
+    logger.info(`File exists: ${filePath}\nChoose: [o]verwrite, [e]xample, [s]kip, [O]verwrite All, [E]xample All, [S]kip All`);
     // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
     while (true) {
         const a = (await rl.question('> ')).trim();
         const valid = ['o', 'e', 's', 'O', 'E', 'S'];
         if (valid.includes(a))
             return a;
-        logger.log('Please enter one of: o e s O E S');
+        logger.info('Please enter one of: o e s O E S');
     }
 };
 
@@ -289,18 +289,18 @@ function attachInitDefaultAction(cli) {
                 if (!exists) {
                     const subs = item.subs ?? {};
                     await copyTextFile(item.src, item.dest, subs);
-                    logger.log(`Created ${path$1.relative(cwd, item.dest)}`);
+                    logger.info(`Created ${path$1.relative(cwd, item.dest)}`);
                     continue;
                 }
                 // Collision
                 if (force) {
                     const subs = item.subs ?? {};
                     await copyTextFile(item.src, item.dest, subs);
-                    logger.log(`Overwrote ${path$1.relative(cwd, item.dest)}`);
+                    logger.info(`Overwrote ${path$1.relative(cwd, item.dest)}`);
                     continue;
                 }
                 if (yes) {
-                    logger.log(`Skipped ${path$1.relative(cwd, item.dest)}`);
+                    logger.info(`Skipped ${path$1.relative(cwd, item.dest)}`);
                     continue;
                 }
                 let decision = globalDecision;
@@ -325,16 +325,16 @@ function attachInitDefaultAction(cli) {
                 if (decision === 'overwrite') {
                     const subs = item.subs ?? {};
                     await copyTextFile(item.src, item.dest, subs);
-                    logger.log(`Overwrote ${path$1.relative(cwd, item.dest)}`);
+                    logger.info(`Overwrote ${path$1.relative(cwd, item.dest)}`);
                 }
                 else if (decision === 'example') {
                     const destEx = `${item.dest}.example`;
                     const subs = item.subs ?? {};
                     await copyTextFile(item.src, destEx, subs);
-                    logger.log(`Wrote example ${path$1.relative(cwd, destEx)}`);
+                    logger.info(`Wrote example ${path$1.relative(cwd, destEx)}`);
                 }
                 else {
-                    logger.log(`Skipped ${path$1.relative(cwd, item.dest)}`);
+                    logger.info(`Skipped ${path$1.relative(cwd, item.dest)}`);
                 }
             }
             // Ensure .gitignore includes local config patterns.
@@ -344,10 +344,10 @@ function attachInitDefaultAction(cli) {
                 '*.local',
             ]);
             if (created) {
-                logger.log(`Created ${path$1.relative(cwd, giPath)}`);
+                logger.info(`Created ${path$1.relative(cwd, giPath)}`);
             }
             else if (changed) {
-                logger.log(`Updated ${path$1.relative(cwd, giPath)}`);
+                logger.info(`Updated ${path$1.relative(cwd, giPath)}`);
             }
         }
         finally {

package/dist/plugins.d.ts

@@ -273,9 +273,11 @@ type GetDotenvDynamicFunction = (vars: ProcessEnv, env: string | undefined) => s
  */
 type GetDotenvDynamic = Record<string, GetDotenvDynamicFunction | ReturnType<GetDotenvDynamicFunction>>;
 /**
- * Logger interface compatible with `console` or a subset thereof.
+ * Logger interface compatible with AWS SDK v3 expectations (`debug`, `info`, `warn`, `error`).
+ * Consumers must provide an object that implements these four methods.
+ * Additional methods (like `log`) are allowed but not required or used by this library.
  */
-type Logger = Record<string, (...args: unknown[]) => void> | typeof console;
+type Logger = Pick<Console, 'debug' | 'info' | 'warn' | 'error'>;
 /**
  * Canonical programmatic options type (schema-derived).
  * This type is the single source of truth for programmatic options.

package/dist/plugins.mjs

@@ -1,9 +1,9 @@
 export { awsPlugin, getAwsRegion } from './plugins-aws.mjs';
-export { a as awsWhoamiPlugin } from './chunks/index-CDPFly99.mjs';
+export { a as awsWhoamiPlugin } from './chunks/index-AssUn9IY.mjs';
 export { batchPlugin } from './plugins-batch.mjs';
-export { c as cmdPlugin } from './chunks/index-Cg50N4ys.mjs';
+export { c as cmdPlugin } from './chunks/index-CAtxK29A.mjs';
 export { initPlugin } from './plugins-init.mjs';
-import './chunks/readMergedOptions-uWSetyes.mjs';
+import './chunks/readMergedOptions-D6niy_Ep.mjs';
 import 'zod';
 import '@commander-js/extra-typings';
 import './chunks/readDotenvCascade-HLU7FsEQ.mjs';
@@ -32,7 +32,7 @@ import 'process';
 import 'node:fs';
 import './chunks/invoke-DuRPU1oC.mjs';
 import 'globby';
-import './chunks/resolveCliOptions-7MwNdHqz.mjs';
+import './chunks/resolveCliOptions-PWF1aEM9.mjs';
 import 'node:process';
 import 'readline/promises';
 import 'node:url';

package/package.json

@@ -17,18 +17,18 @@
     "commander": "^14.0.2",
     "dotenv": "^17.2.3",
     "execa": "^9.6.1",
-    "fs-extra": "^11.3.2",
+    "fs-extra": "^11.3.3",
     "globby": "^16",
     "nanoid": "^5.1.6",
     "package-directory": "^8.1.0",
     "radash": "^12.1.1",
     "yaml": "^2.8.2",
-    "zod": "^4.1.13"
+    "zod": "^4.3.5"
   },
   "description": "Process dotenv files in an arbitrary location & optionally populate environment variables.",
   "devDependencies": {
-    "@aws-sdk/client-sts": "^3.948.0",
-    "@dotenvx/dotenvx": "^1.51.2",
+    "@aws-sdk/client-sts": "^3.965.0",
+    "@dotenvx/dotenvx": "^1.51.4",
     "@eslint/js": "^9.39.2",
     "@rollup/plugin-alias": "^6.0.0",
     "@rollup/plugin-commonjs": "^29.0.0",
@@ -37,27 +37,27 @@
     "@rollup/plugin-typescript": "^12.3.0",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^25",
-    "@vitest/coverage-v8": "^4.0.15",
-    "@vitest/eslint-plugin": "^1.5.2",
+    "@vitest/coverage-v8": "^4.0.16",
+    "@vitest/eslint-plugin": "^1.6.6",
     "auto-changelog": "^2.5.0",
     "cross-env": "^10.1.0",
-    "esbuild": "^0.27.1",
+    "esbuild": "^0.27.2",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-jsonc": "^2.21.0",
     "eslint-plugin-prettier": "^5.5.4",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "eslint-plugin-tsdoc": "^0.5.0",
-    "fs-extra": "^11.3.2",
-    "globals": "^16.5.0",
+    "fs-extra": "^11.3.3",
+    "globals": "^17.0.0",
     "jsonc-eslint-parser": "^2.4.2",
-    "knip": "^5.73.4",
-    "lefthook": "^2.0.11",
+    "knip": "^5.80.0",
+    "lefthook": "^2.0.13",
     "npm-packlist": "^10.0.3",
     "prettier": "^3.7.4",
-    "release-it": "^19.1.0",
+    "release-it": "^19.2.3",
     "rimraf": "^6.1.2",
-    "rollup": "^4.53.3",
+    "rollup": "^4.55.1",
     "rollup-plugin-dts": "^6.3.0",
     "tslib": "^2.8.1",
     "tsx": "^4.21.0",
@@ -65,9 +65,9 @@
     "typedoc-plugin-mdn-links": "^5.0.10",
     "typedoc-plugin-replace-text": "^4.2.0",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.49.0",
-    "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^4.0.15"
+    "typescript-eslint": "^8.52.0",
+    "vite-tsconfig-paths": "^6.0.3",
+    "vitest": "^4.0.16"
   },
   "engines": {
     "node": ">=20"
@@ -221,5 +221,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "6.5.2"
+  "version": "7.0.0"
 }