@karmaniverous/get-dotenv 5.0.0 → 5.2.0

package/dist/index.d.cts

@@ -20,6 +20,13 @@ type RootOptionsShape = {
     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;
@@ -234,6 +241,23 @@ interface GetDotenvCliOptions extends Omit<GetDotenvOptions, 'paths' | 'vars'> {
      * Logs CLI internals when true.
      */
     debug?: boolean;
+    /**
+     * Strict mode: fail the run when env validation issues are detected
+     * (schema or requiredKeys). Warns by default when false or unset.
+     */
+    strict?: boolean;
+    /**
+     * Redaction (presentation): mask secret-like values in logs/trace.
+     */
+    redact?: boolean;
+    /**
+     * Entropy warnings (presentation): emit once-per-key warnings for high-entropy values.
+     */
+    warnEntropy?: boolean;
+    entropyThreshold?: number;
+    entropyMinLength?: number;
+    entropyWhitelist?: string[];
+    redactPatterns?: string[];
     /**
      * When true, capture child stdout/stderr and re-emit after completion.
      * Useful for tests/CI. Default behavior is streaming via stdio: 'inherit'.
@@ -380,5 +404,16 @@ declare const generateGetDotenvCli: (customOptions: Pick<GetDotenvCliGenerateOpt
  */
 declare const getDotenv: (options?: Partial<GetDotenvOptions>) => Promise<ProcessEnv>;
 
-export { defineDynamic, dotenvExpand, dotenvExpandAll, dotenvExpandFromProcessEnv, generateGetDotenvCli, getDotenv, getDotenvCliOptions2Options };
+/**
+ * Deeply interpolate string leaves against envRef.
+ * Arrays are not recursed into; they are returned unchanged.
+ *
+ * @typeParam T - Shape of the input value.
+ * @param value - Input value (object/array/primitive).
+ * @param envRef - Reference environment for interpolation.
+ * @returns A new value with string leaves interpolated.
+ */
+declare const interpolateDeep: <T>(value: T, envRef: ProcessEnv) => T;
+
+export { defineDynamic, dotenvExpand, dotenvExpandAll, dotenvExpandFromProcessEnv, generateGetDotenvCli, getDotenv, getDotenvCliOptions2Options, interpolateDeep };
 export type { GetDotenvDynamic, GetDotenvOptions, ProcessEnv };

package/dist/index.d.mts

@@ -20,6 +20,13 @@ type RootOptionsShape = {
     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;
@@ -234,6 +241,23 @@ interface GetDotenvCliOptions extends Omit<GetDotenvOptions, 'paths' | 'vars'> {
      * Logs CLI internals when true.
      */
     debug?: boolean;
+    /**
+     * Strict mode: fail the run when env validation issues are detected
+     * (schema or requiredKeys). Warns by default when false or unset.
+     */
+    strict?: boolean;
+    /**
+     * Redaction (presentation): mask secret-like values in logs/trace.
+     */
+    redact?: boolean;
+    /**
+     * Entropy warnings (presentation): emit once-per-key warnings for high-entropy values.
+     */
+    warnEntropy?: boolean;
+    entropyThreshold?: number;
+    entropyMinLength?: number;
+    entropyWhitelist?: string[];
+    redactPatterns?: string[];
     /**
      * When true, capture child stdout/stderr and re-emit after completion.
      * Useful for tests/CI. Default behavior is streaming via stdio: 'inherit'.
@@ -380,5 +404,16 @@ declare const generateGetDotenvCli: (customOptions: Pick<GetDotenvCliGenerateOpt
  */
 declare const getDotenv: (options?: Partial<GetDotenvOptions>) => Promise<ProcessEnv>;
 
-export { defineDynamic, dotenvExpand, dotenvExpandAll, dotenvExpandFromProcessEnv, generateGetDotenvCli, getDotenv, getDotenvCliOptions2Options };
+/**
+ * Deeply interpolate string leaves against envRef.
+ * Arrays are not recursed into; they are returned unchanged.
+ *
+ * @typeParam T - Shape of the input value.
+ * @param value - Input value (object/array/primitive).
+ * @param envRef - Reference environment for interpolation.
+ * @returns A new value with string leaves interpolated.
+ */
+declare const interpolateDeep: <T>(value: T, envRef: ProcessEnv) => T;
+
+export { defineDynamic, dotenvExpand, dotenvExpandAll, dotenvExpandFromProcessEnv, generateGetDotenvCli, getDotenv, getDotenvCliOptions2Options, interpolateDeep };
 export type { GetDotenvDynamic, GetDotenvOptions, ProcessEnv };

package/dist/index.d.ts

@@ -20,6 +20,13 @@ type RootOptionsShape = {
     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;
@@ -234,6 +241,23 @@ interface GetDotenvCliOptions extends Omit<GetDotenvOptions, 'paths' | 'vars'> {
      * Logs CLI internals when true.
      */
     debug?: boolean;
+    /**
+     * Strict mode: fail the run when env validation issues are detected
+     * (schema or requiredKeys). Warns by default when false or unset.
+     */
+    strict?: boolean;
+    /**
+     * Redaction (presentation): mask secret-like values in logs/trace.
+     */
+    redact?: boolean;
+    /**
+     * Entropy warnings (presentation): emit once-per-key warnings for high-entropy values.
+     */
+    warnEntropy?: boolean;
+    entropyThreshold?: number;
+    entropyMinLength?: number;
+    entropyWhitelist?: string[];
+    redactPatterns?: string[];
     /**
      * When true, capture child stdout/stderr and re-emit after completion.
      * Useful for tests/CI. Default behavior is streaming via stdio: 'inherit'.
@@ -380,5 +404,16 @@ declare const generateGetDotenvCli: (customOptions: Pick<GetDotenvCliGenerateOpt
  */
 declare const getDotenv: (options?: Partial<GetDotenvOptions>) => Promise<ProcessEnv>;
 
-export { defineDynamic, dotenvExpand, dotenvExpandAll, dotenvExpandFromProcessEnv, generateGetDotenvCli, getDotenv, getDotenvCliOptions2Options };
+/**
+ * Deeply interpolate string leaves against envRef.
+ * Arrays are not recursed into; they are returned unchanged.
+ *
+ * @typeParam T - Shape of the input value.
+ * @param value - Input value (object/array/primitive).
+ * @param envRef - Reference environment for interpolation.
+ * @returns A new value with string leaves interpolated.
+ */
+declare const interpolateDeep: <T>(value: T, envRef: ProcessEnv) => T;
+
+export { defineDynamic, dotenvExpand, dotenvExpandAll, dotenvExpandFromProcessEnv, generateGetDotenvCli, getDotenv, getDotenvCliOptions2Options, interpolateDeep };
 export type { GetDotenvDynamic, GetDotenvOptions, ProcessEnv };