@prosopo/dotenv 3.0.49 → 3.0.50

package/.turbo/turbo-build$colon$cjs.log

@@ -1,5 +1,5 @@
 
-> @prosopo/dotenv@3.0.49 build:cjs
+> @prosopo/dotenv@3.0.50 build:cjs
 > NODE_ENV=${NODE_ENV:-development}; vite build --config vite.cjs.config.ts --mode $NODE_ENV
 
 ViteCommonJSConfig: .
@@ -10,12 +10,15 @@ ViteCommonJSConfig: .
   ]
 }
 { externals: [ '@prosopo/logger', '@prosopo/util' ] }
-vite v6.4.1 building SSR bundle for production...
+The plugin "vite-tsconfig-paths" is detected. Vite now supports tsconfig paths resolution natively via the resolve.tsconfigPaths option. You can remove the plugin and set resolve.tsconfigPaths: true in your Vite config instead.
+vite v8.1.5 building ssr environment for production...
 Bundle build started
-transforming...
-Build end
-✓ 2 modules transformed.
+
+✓ 3 modules transformed.
 rendering chunks...
-dist/cjs/index.cjs  0.22 kB
-dist/cjs/env.cjs    2.67 kB
-✓ built in 133ms
+computing gzip size...
+dist/cjs/index.cjs                       0.23 kB │ gzip: 0.15 kB
+dist/cjs/_virtual/_rolldown/runtime.cjs  1.00 kB │ gzip: 0.50 kB
+dist/cjs/env.cjs                         2.99 kB │ gzip: 1.14 kB
+
+✓ built in 57ms

package/.turbo/turbo-build$colon$tsc.log

@@ -1,20 +1,20 @@
 
-> @prosopo/dotenv@3.0.49 build:tsc
+> @prosopo/dotenv@3.0.50 build:tsc
 > tsc --build --verbose
 
-1:21:08 PM - Projects in this build: 
+8:58:51 PM - Projects in this build: 
     * ../../dev/config/tsconfig.json
     * ../util/tsconfig.json
     * ../logger/tsconfig.json
     * tsconfig.json
 
-1:21:08 PM - Project '../../dev/config/tsconfig.json' is up to date because newest input '../../dev/config/src/webpack/webpack.config.ts' is older than output '../../dev/config/tsconfig.tsbuildinfo'
+8:58:51 PM - Project '../../dev/config/tsconfig.json' is up to date because newest input '../../dev/config/src/webpack/webpack.config.ts' is older than output '../../dev/config/tsconfig.tsbuildinfo'
 
-1:21:08 PM - Project '../util/tsconfig.json' is up to date because newest input '../util/src/url.ts' is older than output '../util/tsconfig.tsbuildinfo'
+8:58:52 PM - Project '../util/tsconfig.json' is up to date because newest input '../util/src/url.ts' is older than output '../util/tsconfig.tsbuildinfo'
 
-1:21:08 PM - Project '../logger/tsconfig.json' is up to date because newest input '../logger/src/index.ts' is older than output '../logger/tsconfig.tsbuildinfo'
+8:58:52 PM - Project '../logger/tsconfig.json' is up to date because newest input '../logger/src/index.ts' is older than output '../logger/tsconfig.tsbuildinfo'
 
-1:21:08 PM - Project 'tsconfig.json' is out of date because output file 'tsconfig.tsbuildinfo' does not exist
+8:58:52 PM - Project 'tsconfig.json' is out of date because output file 'tsconfig.tsbuildinfo' does not exist
 
-1:21:08 PM - Building project '/home/runner/work/captcha/captcha/packages/dotenv/tsconfig.json'...
+8:58:52 PM - Building project '/home/runner/work/captcha/captcha/packages/dotenv/tsconfig.json'...
 

package/.turbo/turbo-build.log

@@ -1,9 +1,9 @@
 
-> @prosopo/dotenv@3.0.49 build
+> @prosopo/dotenv@3.0.50 build
 > npm run build:cross-env -- --mode ${NODE_ENV:-development}
 
 
-> @prosopo/dotenv@3.0.49 build:cross-env
+> @prosopo/dotenv@3.0.50 build:cross-env
 > vite build --config vite.esm.config.ts --mode production
 
 ViteEsmConfig: .
@@ -13,13 +13,16 @@ ViteEsmConfig: .
     '/home/runner/work/captcha/captcha/packages/util/tsconfig.json'
   ]
 }
+The plugin "vite-tsconfig-paths" is detected. Vite now supports tsconfig paths resolution natively via the resolve.tsconfigPaths option. You can remove the plugin and set resolve.tsconfigPaths: true in your Vite config instead.
 { externals: [ '@prosopo/logger', '@prosopo/util' ] }
-vite v6.4.1 building SSR bundle for production...
+vite v8.1.5 building ssr environment for production...
 Bundle build started
-transforming...
-Build end
-✓ 2 modules transformed.
+
+✓ 3 modules transformed.
 rendering chunks...
-dist/index.js  0.10 kB
-dist/env.js    2.20 kB
-✓ built in 134ms
+computing gzip size...
+dist/_virtual/_rolldown/runtime.js  0.04 kB │ gzip: 0.06 kB
+dist/index.js                       0.13 kB │ gzip: 0.10 kB
+dist/env.js                         2.44 kB │ gzip: 1.03 kB
+
+✓ built in 73ms

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @prosopo/dotenv
 
+## 3.0.50
+### Patch Changes
+
+- 4cd9035: test(dotenv): add vitest type tests for the env API
+  
+  Runtime tests cannot catch a published signature that silently widens. These
+  pin the parts consumers depend on: `getEnv` and `getEnvFile` returning a plain
+  `string` rather than `string | undefined` (both already default the absent
+  case away, so a nullable return would push work back onto every caller),
+  `loadEnv` returning the resolved path rather than void, and the optional
+  positional arguments of `loadEnv`/`getEnvFile` in order.
+- 8fba211: test(dotenv): add unit test suite covering env discovery and loading
+  
+  Adds 47 unit tests for `getEnv`, `getEnvFile` and `loadEnv`, reaching 100%
+  statement, branch, function and line coverage, and wires the package into
+  `turbo run test` so it runs in CI.
+  
+  Also fixes `getEnvFile` so that a `NODE_ENV` sanitising to the empty string
+  (e.g. `"!!!"`) falls back to the unsuffixed `.env` rather than searching for
+  the never-created `.env.` filename.
+- e14fce6: chore(deps): bump vite to 6.4.3 and mongoose to 8.24.1, and adjust types for the mongoose 8.24 Document/ObjectId changes
+  - @prosopo/logger@2.0.4
+
 ## 3.0.49
 ### Patch Changes
 

package/dist/_virtual/_rolldown/runtime.js

@@ -0,0 +1,3 @@
+import "node:module";
+//#endregion
+export {};

package/dist/cjs/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1,23 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+exports.__toESM = __toESM;

package/dist/cjs/env.cjs

@@ -1,73 +1,81 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const fs = require("node:fs");
-const path = require("node:path");
-const node_url = require("node:url");
-const logger$1 = require("@prosopo/logger");
-const dotenv = require("dotenv");
-var _documentCurrentScript = typeof document !== "undefined" ? document.currentScript : null;
-const __filename$1 = node_url.fileURLToPath(typeof document === "undefined" ? require("url").pathToFileURL(__filename).href : _documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === "SCRIPT" && _documentCurrentScript.src || new URL("env.cjs", document.baseURI).href);
-const __dirname$1 = path.dirname(__filename$1);
-const logger = logger$1.getLogger(
-  logger$1.parseLogLevel(process.env.PROSOPO_LOG_LEVEL, logger$1.LogLevel.enum.info),
-  "dotenv"
-);
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let node_url = require("node:url");
+let _prosopo_logger = require("@prosopo/logger");
+let dotenv = require("dotenv");
+dotenv = require_runtime.__toESM(dotenv, 1);
+//#region src/env.ts
+var __filename$1 = (0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href);
+var __dirname$1 = node_path.default.dirname(__filename$1);
+var logger = (0, _prosopo_logger.getLogger)((0, _prosopo_logger.parseLogLevel)(process.env.PROSOPO_LOG_LEVEL, _prosopo_logger.LogLevel.enum.info), "dotenv");
 function getEnv() {
-  if (process.env.NODE_ENV) {
-    return process.env.NODE_ENV.replace(/\W/g, "");
-  }
-  return "development";
+	if (process.env.NODE_ENV) return process.env.NODE_ENV.replace(/\W/g, "");
+	return "development";
 }
 function loadEnv(rootDir, filename, filePath, nodeEnv, override = false) {
-  const envPath = getEnvFile(
-    path.resolve(rootDir || "."),
-    filename,
-    filePath,
-    nodeEnv
-  );
-  const args = { path: envPath, override };
-  logger.debug(() => ({
-    data: { envPath },
-    msg: "Loading env"
-  }));
-  dotenv.config(args);
-  return envPath;
+	const envPath = getEnvFile(node_path.default.resolve(rootDir || "."), filename, filePath, nodeEnv);
+	const args = {
+		path: envPath,
+		override
+	};
+	logger.debug(() => ({
+		data: { envPath },
+		msg: "Loading env"
+	}));
+	dotenv.default.config(args);
+	return envPath;
 }
-function getEnvFile(rootDir, filename = ".env", filepath = path.join(__dirname$1, "../.."), nodeEnv) {
-  const env = nodeEnv || getEnv();
-  const fileNameFull = `${filename}.${env}`;
-  let searchPath = path.resolve(rootDir || ".");
-  logger.debug(() => ({
-    data: { fileName: fileNameFull, searchPath },
-    msg: "Searching"
-  }));
-  let levelCount = 0;
-  while (!fs.existsSync(path.join(searchPath, fileNameFull))) {
-    if (fs.existsSync(path.join(searchPath, "package.json"))) {
-      const pkgJson = JSON.parse(
-        fs.readFileSync(path.join(searchPath, "package.json"), "utf8")
-      );
-      if (pkgJson.name === "@prosopo/captcha-private") {
-        logger.debug(() => ({
-          data: { fileName: fileNameFull },
-          msg: "Reached the workspace root package.json, stopping search."
-        }));
-        break;
-      }
-    }
-    searchPath = path.resolve(searchPath, "..");
-    levelCount += 1;
-    if (levelCount > 10) {
-      logger.debug(() => ({
-        data: { fileName: fileNameFull, levelCount },
-        msg: "Checked directories above, stopping search."
-      }));
-      break;
-    }
-  }
-  const foundPath = path.join(searchPath, fileNameFull);
-  return fs.existsSync(foundPath) ? foundPath : path.join(rootDir || filepath, fileNameFull);
+/**
+* Get the path to the .env file. Search up directories until `${filename}.${env}`
+* is found — or, when `env` sanitises to the empty string, plain `filename`.
+* If not found, look in the root directory, if specified, or 2 directories up from this file.
+* @param rootDir
+* @param filename
+* @param filepath
+* @param nodeEnv Environment override
+*/
+function getEnvFile(rootDir, filename = ".env", filepath = node_path.default.join(__dirname$1, "../.."), nodeEnv) {
+	const env = nodeEnv || getEnv();
+	const fileNameFull = env ? `${filename}.${env}` : filename;
+	let searchPath = node_path.default.resolve(rootDir || ".");
+	logger.debug(() => ({
+		data: {
+			fileName: fileNameFull,
+			searchPath
+		},
+		msg: "Searching"
+	}));
+	let levelCount = 0;
+	while (!node_fs.default.existsSync(node_path.default.join(searchPath, fileNameFull))) {
+		if (node_fs.default.existsSync(node_path.default.join(searchPath, "package.json"))) {
+			if (JSON.parse(node_fs.default.readFileSync(node_path.default.join(searchPath, "package.json"), "utf8")).name === "@prosopo/captcha-private") {
+				logger.debug(() => ({
+					data: { fileName: fileNameFull },
+					msg: "Reached the workspace root package.json, stopping search."
+				}));
+				break;
+			}
+		}
+		searchPath = node_path.default.resolve(searchPath, "..");
+		levelCount += 1;
+		if (levelCount > 10) {
+			logger.debug(() => ({
+				data: {
+					fileName: fileNameFull,
+					levelCount
+				},
+				msg: "Checked directories above, stopping search."
+			}));
+			break;
+		}
+	}
+	const foundPath = node_path.default.join(searchPath, fileNameFull);
+	return node_fs.default.existsSync(foundPath) ? foundPath : node_path.default.join(rootDir || filepath, fileNameFull);
 }
+//#endregion
 exports.getEnv = getEnv;
 exports.getEnvFile = getEnvFile;
 exports.loadEnv = loadEnv;

package/dist/cjs/index.cjs

@@ -1,6 +1,5 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const env = require("./env.cjs");
-exports.getEnv = env.getEnv;
-exports.getEnvFile = env.getEnvFile;
-exports.loadEnv = env.loadEnv;
+const require_env = require("./env.cjs");
+exports.getEnv = require_env.getEnv;
+exports.getEnvFile = require_env.getEnvFile;
+exports.loadEnv = require_env.loadEnv;

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AA2BA,wBAAgB,MAAM,WAKrB;AAED,wBAAgB,OAAO,CACtB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,UAAQ,GACd,MAAM,CAcR;AAUD,wBAAgB,UAAU,CACzB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,SAAS,EACjB,QAAQ,SAAgC,EACxC,OAAO,CAAC,EAAE,MAAM,UA0ChB"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AA2BA,wBAAgB,MAAM,WAKrB;AAED,wBAAgB,OAAO,CACtB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,UAAQ,GACd,MAAM,CAcR;AAWD,wBAAgB,UAAU,CACzB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,SAAS,EACjB,QAAQ,SAAgC,EACxC,OAAO,CAAC,EAAE,MAAM,UA6ChB"}

package/dist/env.js

@@ -1,72 +1,75 @@
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { getLogger, parseLogLevel, LogLevel } from "@prosopo/logger";
+import { LogLevel, getLogger, parseLogLevel } from "@prosopo/logger";
 import dotenv from "dotenv";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const logger = getLogger(
-  parseLogLevel(process.env.PROSOPO_LOG_LEVEL, LogLevel.enum.info),
-  "dotenv"
-);
+//#region src/env.ts
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = path.dirname(__filename);
+var logger = getLogger(parseLogLevel(process.env.PROSOPO_LOG_LEVEL, LogLevel.enum.info), "dotenv");
 function getEnv() {
-  if (process.env.NODE_ENV) {
-    return process.env.NODE_ENV.replace(/\W/g, "");
-  }
-  return "development";
+	if (process.env.NODE_ENV) return process.env.NODE_ENV.replace(/\W/g, "");
+	return "development";
 }
 function loadEnv(rootDir, filename, filePath, nodeEnv, override = false) {
-  const envPath = getEnvFile(
-    path.resolve(rootDir || "."),
-    filename,
-    filePath,
-    nodeEnv
-  );
-  const args = { path: envPath, override };
-  logger.debug(() => ({
-    data: { envPath },
-    msg: "Loading env"
-  }));
-  dotenv.config(args);
-  return envPath;
+	const envPath = getEnvFile(path.resolve(rootDir || "."), filename, filePath, nodeEnv);
+	const args = {
+		path: envPath,
+		override
+	};
+	logger.debug(() => ({
+		data: { envPath },
+		msg: "Loading env"
+	}));
+	dotenv.config(args);
+	return envPath;
 }
+/**
+* Get the path to the .env file. Search up directories until `${filename}.${env}`
+* is found — or, when `env` sanitises to the empty string, plain `filename`.
+* If not found, look in the root directory, if specified, or 2 directories up from this file.
+* @param rootDir
+* @param filename
+* @param filepath
+* @param nodeEnv Environment override
+*/
 function getEnvFile(rootDir, filename = ".env", filepath = path.join(__dirname, "../.."), nodeEnv) {
-  const env = nodeEnv || getEnv();
-  const fileNameFull = `${filename}.${env}`;
-  let searchPath = path.resolve(rootDir || ".");
-  logger.debug(() => ({
-    data: { fileName: fileNameFull, searchPath },
-    msg: "Searching"
-  }));
-  let levelCount = 0;
-  while (!fs.existsSync(path.join(searchPath, fileNameFull))) {
-    if (fs.existsSync(path.join(searchPath, "package.json"))) {
-      const pkgJson = JSON.parse(
-        fs.readFileSync(path.join(searchPath, "package.json"), "utf8")
-      );
-      if (pkgJson.name === "@prosopo/captcha-private") {
-        logger.debug(() => ({
-          data: { fileName: fileNameFull },
-          msg: "Reached the workspace root package.json, stopping search."
-        }));
-        break;
-      }
-    }
-    searchPath = path.resolve(searchPath, "..");
-    levelCount += 1;
-    if (levelCount > 10) {
-      logger.debug(() => ({
-        data: { fileName: fileNameFull, levelCount },
-        msg: "Checked directories above, stopping search."
-      }));
-      break;
-    }
-  }
-  const foundPath = path.join(searchPath, fileNameFull);
-  return fs.existsSync(foundPath) ? foundPath : path.join(rootDir || filepath, fileNameFull);
+	const env = nodeEnv || getEnv();
+	const fileNameFull = env ? `${filename}.${env}` : filename;
+	let searchPath = path.resolve(rootDir || ".");
+	logger.debug(() => ({
+		data: {
+			fileName: fileNameFull,
+			searchPath
+		},
+		msg: "Searching"
+	}));
+	let levelCount = 0;
+	while (!fs.existsSync(path.join(searchPath, fileNameFull))) {
+		if (fs.existsSync(path.join(searchPath, "package.json"))) {
+			if (JSON.parse(fs.readFileSync(path.join(searchPath, "package.json"), "utf8")).name === "@prosopo/captcha-private") {
+				logger.debug(() => ({
+					data: { fileName: fileNameFull },
+					msg: "Reached the workspace root package.json, stopping search."
+				}));
+				break;
+			}
+		}
+		searchPath = path.resolve(searchPath, "..");
+		levelCount += 1;
+		if (levelCount > 10) {
+			logger.debug(() => ({
+				data: {
+					fileName: fileNameFull,
+					levelCount
+				},
+				msg: "Checked directories above, stopping search."
+			}));
+			break;
+		}
+	}
+	const foundPath = path.join(searchPath, fileNameFull);
+	return fs.existsSync(foundPath) ? foundPath : path.join(rootDir || filepath, fileNameFull);
 }
-export {
-  getEnv,
-  getEnvFile,
-  loadEnv
-};
+//#endregion
+export { getEnv, getEnvFile, loadEnv };

package/dist/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,6 +1,3 @@
+import "./_virtual/_rolldown/runtime.js";
 import { getEnv, getEnvFile, loadEnv } from "./env.js";
-export {
-  getEnv,
-  getEnvFile,
-  loadEnv
-};
+export { getEnv, getEnvFile, loadEnv };

package/dist/tests/env.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=env.test-d.d.ts.map

package/dist/tests/env.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.test-d.d.ts","sourceRoot":"","sources":["../../src/tests/env.test-d.ts"],"names":[],"mappings":""}

package/dist/tests/env.test-d.js

@@ -0,0 +1,50 @@
+import { describe, expectTypeOf, it } from "vitest";
+import { getEnv, getEnvFile, loadEnv } from "../index.js";
+describe("getEnv", () => {
+    it("always yields a string, since it falls back to development", () => {
+        expectTypeOf(getEnv).returns.toEqualTypeOf();
+    });
+    it("takes no arguments: it reads process.env directly", () => {
+        expectTypeOf(getEnv).parameters.toEqualTypeOf();
+    });
+});
+describe("loadEnv", () => {
+    it("returns the resolved env path rather than void", () => {
+        expectTypeOf(loadEnv).returns.toEqualTypeOf();
+    });
+    it("is callable with no arguments at all", () => {
+        expectTypeOf(loadEnv).toBeCallableWith();
+    });
+    it("takes every argument as optional, in order", () => {
+        expectTypeOf(loadEnv).parameters.toEqualTypeOf();
+    });
+    it("accepts a partially specified call", () => {
+        expectTypeOf(loadEnv).toBeCallableWith("/root");
+        expectTypeOf(loadEnv).toBeCallableWith("/root", ".env");
+        expectTypeOf(loadEnv).toBeCallableWith("/root", ".env", "/root/.env", "test", true);
+    });
+    it("keeps override a boolean, not a truthy anything", () => {
+        loadEnv("/root", ".env", "/root/.env", "test", "yes");
+    });
+    it("rejects a numeric root directory", () => {
+        loadEnv(1);
+    });
+});
+describe("getEnvFile", () => {
+    it("always resolves to a path string", () => {
+        expectTypeOf(getEnvFile).returns.toEqualTypeOf();
+    });
+    it("is callable with no arguments, defaulting filename and search root", () => {
+        expectTypeOf(getEnvFile).toBeCallableWith();
+    });
+    it("takes four optional positional arguments", () => {
+        expectTypeOf(getEnvFile).parameters.toEqualTypeOf();
+    });
+    it("accepts an explicit nodeEnv override in last position", () => {
+        expectTypeOf(getEnvFile).toBeCallableWith("/root", ".env", "/fallback", "production");
+    });
+    it("rejects an extra argument", () => {
+        getEnvFile("/root", ".env", "/fallback", "production", true);
+    });
+});
+//# sourceMappingURL=env.test-d.js.map

package/dist/tests/env.test-d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.test-d.js","sourceRoot":"","sources":["../../src/tests/env.test-d.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAIpD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE1D,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QAGrE,YAAY,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,aAAa,EAAU,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC5D,YAAY,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,aAAa,EAAM,CAAC;IACrD,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QAEzD,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,aAAa,EAAU,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC/C,YAAY,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACrD,YAAY,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,aAAa,EAQ3C,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC7C,YAAY,CAAC,OAAO,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAChD,YAAY,CAAC,OAAO,CAAC,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxD,YAAY,CAAC,OAAO,CAAC,CAAC,gBAAgB,CACrC,OAAO,EACP,MAAM,EACN,YAAY,EACZ,MAAM,EACN,IAAI,CACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QAE1D,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAE3C,OAAO,CAAC,CAAC,CAAC,CAAC;IACZ,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAG3C,YAAY,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,aAAa,EAAU,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC7E,YAAY,CAAC,UAAU,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QACnD,YAAY,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,aAAa,EAO9C,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAChE,YAAY,CAAC,UAAU,CAAC,CAAC,gBAAgB,CACxC,OAAO,EACP,MAAM,EACN,WAAW,EACX,YAAY,CACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QAEpC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/tests/env.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=env.unit.test.d.ts.map

package/dist/tests/env.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.unit.test.d.ts","sourceRoot":"","sources":["../../src/tests/env.unit.test.ts"],"names":[],"mappings":""}