@prosopo/dotenv 3.0.49 → 3.0.51

package/dist/tests/env.unit.test.js

@@ -0,0 +1,358 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { getEnv, getEnvFile, loadEnv } from "../index.js";
+const WORKSPACE_PKG_JSON = JSON.stringify({
+    name: "@prosopo/captcha-private",
+});
+describe("dotenv/env", () => {
+    let tmpRoot;
+    let envBackup;
+    beforeEach(() => {
+        tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), "prosopo-dotenv-test-"));
+        envBackup = { ...process.env };
+    });
+    afterEach(() => {
+        fs.rmSync(tmpRoot, { recursive: true, force: true });
+        for (const key of Object.keys(process.env)) {
+            if (!(key in envBackup))
+                delete process.env[key];
+        }
+        Object.assign(process.env, envBackup);
+        vi.restoreAllMocks();
+    });
+    const mkdir = (...segments) => {
+        const dir = path.join(tmpRoot, ...segments);
+        fs.mkdirSync(dir, { recursive: true });
+        return dir;
+    };
+    const writeFile = (dir, name, contents) => {
+        fs.mkdirSync(dir, { recursive: true });
+        const file = path.join(dir, name);
+        fs.writeFileSync(file, contents);
+        return file;
+    };
+    describe("getEnv", () => {
+        it("returns 'development' when NODE_ENV is not set", () => {
+            process.env.NODE_ENV = undefined;
+            delete process.env.NODE_ENV;
+            expect(getEnv()).toBe("development");
+        });
+        it("returns 'development' when NODE_ENV is the empty string", () => {
+            process.env.NODE_ENV = "";
+            expect(getEnv()).toBe("development");
+        });
+        it("returns NODE_ENV unchanged when it is already word characters only", () => {
+            process.env.NODE_ENV = "test";
+            expect(getEnv()).toBe("test");
+        });
+        it("strips non-word characters", () => {
+            process.env.NODE_ENV = "pro-duction!";
+            expect(getEnv()).toBe("production");
+        });
+        it("preserves digits and underscores, which are word characters", () => {
+            process.env.NODE_ENV = "staging_2";
+            expect(getEnv()).toBe("staging_2");
+        });
+        it("strips whitespace, including a value that is only whitespace", () => {
+            process.env.NODE_ENV = " test ";
+            expect(getEnv()).toBe("test");
+            process.env.NODE_ENV = "   ";
+            expect(getEnv()).toBe("");
+        });
+        it("strips non-ASCII characters", () => {
+            process.env.NODE_ENV = "tëst";
+            expect(getEnv()).toBe("tst");
+        });
+        it("returns the empty string when NODE_ENV is entirely non-word characters", () => {
+            process.env.NODE_ENV = "!!!";
+            expect(getEnv()).toBe("");
+        });
+    });
+    describe("getEnvFile", () => {
+        it("finds the env file directly in rootDir", () => {
+            const expected = writeFile(tmpRoot, ".env.test", "");
+            expect(getEnvFile(tmpRoot, ".env", undefined, "test")).toBe(expected);
+        });
+        it("walks up the tree to find the env file in an ancestor", () => {
+            const expected = writeFile(tmpRoot, ".env.test", "");
+            const deep = mkdir("a", "b", "c");
+            expect(getEnvFile(deep, ".env", undefined, "test")).toBe(expected);
+        });
+        it("returns the nearest match when the file exists at several levels", () => {
+            writeFile(tmpRoot, ".env.test", "");
+            const nearestDir = mkdir("a", "b");
+            const nearest = writeFile(nearestDir, ".env.test", "");
+            const start = mkdir("a", "b", "c");
+            expect(getEnvFile(start, ".env", undefined, "test")).toBe(nearest);
+        });
+        it("respects a custom filename", () => {
+            const expected = writeFile(tmpRoot, "custom.test", "");
+            expect(getEnvFile(tmpRoot, "custom", undefined, "test")).toBe(expected);
+        });
+        it("uses the explicit nodeEnv argument in preference to NODE_ENV", () => {
+            process.env.NODE_ENV = "development";
+            const expected = writeFile(tmpRoot, ".env.production", "");
+            expect(getEnvFile(tmpRoot, ".env", undefined, "production")).toBe(expected);
+        });
+        it("falls back to NODE_ENV when nodeEnv is the empty string", () => {
+            process.env.NODE_ENV = "staging";
+            const expected = writeFile(tmpRoot, ".env.staging", "");
+            expect(getEnvFile(tmpRoot, ".env", undefined, "")).toBe(expected);
+        });
+        it("falls back to NODE_ENV when nodeEnv is omitted", () => {
+            process.env.NODE_ENV = "staging";
+            const expected = writeFile(tmpRoot, ".env.staging", "");
+            expect(getEnvFile(tmpRoot)).toBe(expected);
+        });
+        it("resolves a relative rootDir against the current working directory", () => {
+            const cwd = process.cwd();
+            const relative = path.relative(cwd, tmpRoot);
+            const expected = writeFile(tmpRoot, ".env.test", "");
+            expect(getEnvFile(relative, ".env", undefined, "test")).toBe(expected);
+        });
+        it("treats an empty rootDir as the current working directory", () => {
+            const result = getEnvFile("", ".env", undefined, "nonexistent-env-xyz");
+            expect(path.isAbsolute(result)).toBe(true);
+            expect(result.endsWith(".env.nonexistent-env-xyz")).toBe(true);
+        });
+        it("falls back to the unsuffixed filename when the sanitised env is empty", () => {
+            process.env.NODE_ENV = "!!!";
+            const expected = writeFile(tmpRoot, ".env", "");
+            expect(getEnvFile(tmpRoot)).toBe(expected);
+        });
+        it("never appends a bare dot when the sanitised env is empty", () => {
+            process.env.NODE_ENV = "!!!";
+            const result = getEnvFile(tmpRoot);
+            expect(result).toBe(path.join(tmpRoot, ".env"));
+            expect(result.endsWith(".")).toBe(false);
+        });
+        it("uses the unsuffixed name for a custom filename when the env is empty", () => {
+            process.env.NODE_ENV = "!!!";
+            const expected = writeFile(tmpRoot, "custom", "");
+            expect(getEnvFile(tmpRoot, "custom")).toBe(expected);
+        });
+        it("prefers the unsuffixed file over a stale trailing-dot file", () => {
+            process.env.NODE_ENV = "!!!";
+            writeFile(tmpRoot, ".env.", "");
+            const expected = writeFile(tmpRoot, ".env", "");
+            expect(getEnvFile(tmpRoot)).toBe(expected);
+        });
+        describe("workspace root sentinel", () => {
+            it("stops searching at the workspace-root package.json", () => {
+                writeFile(tmpRoot, ".env.test", "");
+                const workspaceRoot = mkdir("workspace");
+                writeFile(workspaceRoot, "package.json", WORKSPACE_PKG_JSON);
+                const start = mkdir("workspace", "packages", "thing");
+                const result = getEnvFile(start, ".env", undefined, "test");
+                expect(result).toBe(path.join(start, ".env.test"));
+                expect(fs.existsSync(result)).toBe(false);
+            });
+            it("keeps walking past a package.json belonging to another project", () => {
+                const expected = writeFile(tmpRoot, ".env.test", "");
+                const intermediate = mkdir("some-package");
+                writeFile(intermediate, "package.json", JSON.stringify({ name: "@prosopo/dotenv" }));
+                const start = mkdir("some-package", "src");
+                expect(getEnvFile(start, ".env", undefined, "test")).toBe(expected);
+            });
+            it("keeps walking past a package.json with no name field", () => {
+                const expected = writeFile(tmpRoot, ".env.test", "");
+                const intermediate = mkdir("nameless");
+                writeFile(intermediate, "package.json", JSON.stringify({ version: 1 }));
+                const start = mkdir("nameless", "src");
+                expect(getEnvFile(start, ".env", undefined, "test")).toBe(expected);
+            });
+            it("keeps walking when package.json is valid JSON but not an object", () => {
+                const expected = writeFile(tmpRoot, ".env.test", "");
+                const intermediate = mkdir("weird");
+                writeFile(intermediate, "package.json", "123");
+                const start = mkdir("weird", "src");
+                expect(getEnvFile(start, ".env", undefined, "test")).toBe(expected);
+            });
+            it("finds the env file at the workspace root itself", () => {
+                const workspaceRoot = mkdir("workspace");
+                writeFile(workspaceRoot, "package.json", WORKSPACE_PKG_JSON);
+                const expected = writeFile(workspaceRoot, ".env.test", "");
+                const start = mkdir("workspace", "packages", "thing");
+                expect(getEnvFile(start, ".env", undefined, "test")).toBe(expected);
+            });
+        });
+        describe("depth limit", () => {
+            it("gives up after ascending more than 10 levels", () => {
+                const segments = Array.from({ length: 14 }, (_, i) => `d${i}`);
+                const start = mkdir(...segments);
+                const result = getEnvFile(start, ".env", undefined, "test");
+                expect(result).toBe(path.join(start, ".env.test"));
+            });
+            it("still finds a file exactly 10 levels up", () => {
+                const segments = Array.from({ length: 10 }, (_, i) => `d${i}`);
+                const expected = writeFile(tmpRoot, ".env.test", "");
+                const start = mkdir(...segments);
+                expect(getEnvFile(start, ".env", undefined, "test")).toBe(expected);
+            });
+            it("terminates at the filesystem root instead of looping forever", () => {
+                const result = getEnvFile(path.parse(tmpRoot).root, ".env", undefined, "definitely-not-a-real-env-9f3a");
+                expect(result).toBe(path.join(path.parse(tmpRoot).root, ".env.definitely-not-a-real-env-9f3a"));
+            });
+        });
+        describe("fallback path when nothing is found", () => {
+            it("falls back to rootDir when rootDir was supplied", () => {
+                const start = mkdir("a");
+                expect(getEnvFile(start, ".env", "/some/other/place", "test")).toBe(path.join(start, ".env.test"));
+            });
+            it("falls back to the filepath argument when rootDir is falsy", () => {
+                const result = getEnvFile("", ".env", tmpRoot, "nonexistent-env-xyz");
+                expect(result).toBe(path.join(tmpRoot, ".env.nonexistent-env-xyz"));
+            });
+        });
+        describe("failure modes", () => {
+            it("propagates a SyntaxError when an ancestor package.json is malformed", () => {
+                writeFile(tmpRoot, ".env.test", "");
+                const intermediate = mkdir("broken");
+                writeFile(intermediate, "package.json", "{ not valid json");
+                const start = mkdir("broken", "src");
+                expect(() => getEnvFile(start, ".env", undefined, "test")).toThrow(SyntaxError);
+            });
+            it("propagates a TypeError when an ancestor package.json contains null", () => {
+                writeFile(tmpRoot, ".env.test", "");
+                const intermediate = mkdir("nullish");
+                writeFile(intermediate, "package.json", "null");
+                const start = mkdir("nullish", "src");
+                expect(() => getEnvFile(start, ".env", undefined, "test")).toThrow(TypeError);
+            });
+            it("propagates a read error when package.json vanishes after the existence check", () => {
+                writeFile(tmpRoot, ".env.test", "");
+                const intermediate = mkdir("racy");
+                writeFile(intermediate, "package.json", WORKSPACE_PKG_JSON);
+                const start = mkdir("racy", "src");
+                const readError = Object.assign(new Error("EACCES: permission denied"), {
+                    code: "EACCES",
+                });
+                vi.spyOn(fs, "readFileSync").mockImplementation(() => {
+                    throw readError;
+                });
+                expect(() => getEnvFile(start, ".env", undefined, "test")).toThrow(readError);
+            });
+            it("propagates an error thrown by the existence check itself", () => {
+                const statError = Object.assign(new Error("EIO: i/o error"), {
+                    code: "EIO",
+                });
+                vi.spyOn(fs, "existsSync").mockImplementation(() => {
+                    throw statError;
+                });
+                expect(() => getEnvFile(tmpRoot, ".env", undefined, "test")).toThrow(statError);
+            });
+        });
+    });
+    describe("loadEnv", () => {
+        it("loads variables from the discovered file into process.env", () => {
+            writeFile(tmpRoot, ".env.test", "PROSOPO_TEST_VALUE=hello\n");
+            const returned = loadEnv(tmpRoot, ".env", undefined, "test");
+            expect(returned).toBe(path.join(tmpRoot, ".env.test"));
+            expect(process.env.PROSOPO_TEST_VALUE).toBe("hello");
+        });
+        it("loads multiple variables and ignores comments and blank lines", () => {
+            writeFile(tmpRoot, ".env.test", "# a comment\n\nPROSOPO_A=1\nPROSOPO_B=two\n");
+            loadEnv(tmpRoot, ".env", undefined, "test");
+            expect(process.env.PROSOPO_A).toBe("1");
+            expect(process.env.PROSOPO_B).toBe("two");
+        });
+        it("handles an empty env file without error", () => {
+            const expected = writeFile(tmpRoot, ".env.test", "");
+            expect(loadEnv(tmpRoot, ".env", undefined, "test")).toBe(expected);
+        });
+        it("does not overwrite existing variables by default", () => {
+            process.env.PROSOPO_TEST_VALUE = "original";
+            writeFile(tmpRoot, ".env.test", "PROSOPO_TEST_VALUE=replacement\n");
+            loadEnv(tmpRoot, ".env", undefined, "test");
+            expect(process.env.PROSOPO_TEST_VALUE).toBe("original");
+        });
+        it("overwrites existing variables when override is true", () => {
+            process.env.PROSOPO_TEST_VALUE = "original";
+            writeFile(tmpRoot, ".env.test", "PROSOPO_TEST_VALUE=replacement\n");
+            loadEnv(tmpRoot, ".env", undefined, "test", true);
+            expect(process.env.PROSOPO_TEST_VALUE).toBe("replacement");
+        });
+        it("uses the explicit nodeEnv to choose which file to load", () => {
+            process.env.NODE_ENV = "development";
+            writeFile(tmpRoot, ".env.development", "PROSOPO_WHICH=development\n");
+            writeFile(tmpRoot, ".env.production", "PROSOPO_WHICH=production\n");
+            loadEnv(tmpRoot, ".env", undefined, "production");
+            expect(process.env.PROSOPO_WHICH).toBe("production");
+        });
+        it("respects a custom filename", () => {
+            writeFile(tmpRoot, "custom.test", "PROSOPO_CUSTOM=yes\n");
+            const returned = loadEnv(tmpRoot, "custom", undefined, "test");
+            expect(returned).toBe(path.join(tmpRoot, "custom.test"));
+            expect(process.env.PROSOPO_CUSTOM).toBe("yes");
+        });
+        it("returns a path and stays silent when no env file exists", () => {
+            const start = mkdir("empty");
+            const returned = loadEnv(start, ".env", undefined, "nonexistent-env-xyz");
+            expect(returned).toBe(path.join(start, ".env.nonexistent-env-xyz"));
+            expect(fs.existsSync(returned)).toBe(false);
+        });
+        it("loads the unsuffixed file when the sanitised env is empty", () => {
+            process.env.NODE_ENV = "!!!";
+            const expected = writeFile(tmpRoot, ".env", "PROSOPO_UNSUFFIXED=yes\n");
+            expect(loadEnv(tmpRoot)).toBe(expected);
+            expect(process.env.PROSOPO_UNSUFFIXED).toBe("yes");
+        });
+        it("defaults to the current working directory when rootDir is omitted", () => {
+            const returned = loadEnv(undefined, ".env", undefined, "nonexistent-xyz");
+            expect(path.isAbsolute(returned)).toBe(true);
+            expect(returned.endsWith(".env.nonexistent-xyz")).toBe(true);
+        });
+        it("propagates errors thrown during discovery", () => {
+            const intermediate = mkdir("broken");
+            writeFile(intermediate, "package.json", "{ not valid json");
+            const start = mkdir("broken", "src");
+            expect(() => loadEnv(start, ".env", undefined, "test")).toThrow(SyntaxError);
+        });
+        it("silently ignores a read failure on the env file", () => {
+            writeFile(tmpRoot, ".env.test", "PROSOPO_TEST_VALUE=hello\n");
+            const readError = Object.assign(new Error("EACCES: permission denied"), {
+                code: "EACCES",
+            });
+            vi.spyOn(fs, "readFileSync").mockImplementation(() => {
+                throw readError;
+            });
+            const returned = loadEnv(tmpRoot, ".env", undefined, "test");
+            expect(returned).toBe(path.join(tmpRoot, ".env.test"));
+            expect(process.env.PROSOPO_TEST_VALUE).toBeUndefined();
+        });
+    });
+    describe("debug logging", () => {
+        const importAtDebugLevel = async () => {
+            process.env.PROSOPO_LOG_LEVEL = "debug";
+            vi.resetModules();
+            return import("../index.js");
+        };
+        it("builds the search payload without throwing", async () => {
+            const { getEnvFile: getEnvFileDebug } = await importAtDebugLevel();
+            const expected = writeFile(tmpRoot, ".env.test", "");
+            expect(getEnvFileDebug(tmpRoot, ".env", undefined, "test")).toBe(expected);
+        });
+        it("builds the workspace-root payload without throwing", async () => {
+            const { getEnvFile: getEnvFileDebug } = await importAtDebugLevel();
+            const workspaceRoot = mkdir("workspace");
+            writeFile(workspaceRoot, "package.json", WORKSPACE_PKG_JSON);
+            const start = mkdir("workspace", "packages", "thing");
+            expect(getEnvFileDebug(start, ".env", undefined, "test")).toBe(path.join(start, ".env.test"));
+        });
+        it("builds the depth-limit payload without throwing", async () => {
+            const { getEnvFile: getEnvFileDebug } = await importAtDebugLevel();
+            const segments = Array.from({ length: 14 }, (_, i) => `d${i}`);
+            const start = mkdir(...segments);
+            expect(getEnvFileDebug(start, ".env", undefined, "test")).toBe(path.join(start, ".env.test"));
+        });
+        it("builds the load payload without throwing", async () => {
+            const { loadEnv: loadEnvDebug } = await importAtDebugLevel();
+            const expected = writeFile(tmpRoot, ".env.test", "PROSOPO_DEBUG_V=1\n");
+            expect(loadEnvDebug(tmpRoot, ".env", undefined, "test")).toBe(expected);
+            expect(process.env.PROSOPO_DEBUG_V).toBe("1");
+        });
+    });
+});
+//# sourceMappingURL=env.unit.test.js.map

package/dist/tests/env.unit.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@prosopo/dotenv",
-	"version": "3.0.49",
+	"version": "3.0.51",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
 	"exports": {
@@ -24,25 +24,26 @@
 		"build:tsc": "tsc --build --verbose",
 		"build:cjs": "NODE_ENV=${NODE_ENV:-development}; vite build --config vite.cjs.config.ts --mode $NODE_ENV",
 		"typecheck": "tsc --project tsconfig.types.json",
+		"test": "NODE_ENV=${NODE_ENV:-test}; npx vitest run --config ./vite.test.config.ts",
 		"cli": "node ./dist/js/cli.js"
 	},
 	"type": "module",
 	"dependencies": {
-		"@prosopo/logger": "2.0.3",
+		"@prosopo/logger": "2.0.5",
 		"dotenv": "16.4.5"
 	},
 	"devDependencies": {
-		"@prosopo/config": "3.3.4",
+		"@prosopo/config": "3.3.7",
 		"@types/node": "22.10.2",
-		"@vitest/coverage-v8": "3.2.4",
+		"@vitest/coverage-v8": "4.1.10",
 		"concurrently": "9.0.1",
 		"del-cli": "6.0.0",
 		"npm-run-all": "4.1.5",
 		"tslib": "2.7.0",
 		"tsx": "4.20.3",
 		"typescript": "5.6.2",
-		"vite": "6.4.1",
-		"vitest": "3.2.4"
+		"vite": "8.1.5",
+		"vitest": "4.1.10"
 	},
 	"repository": {
 		"type": "git",

package/src/env.ts

@@ -55,7 +55,8 @@ export function loadEnv(
 }
 
 /**
- * Get the path to the .env file. Search up directories until `.env.${env}` is found.
+ * 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
@@ -69,7 +70,10 @@ export function getEnvFile(
 	nodeEnv?: string,
 ) {
 	const env = nodeEnv || getEnv();
-	const fileNameFull = `${filename}.${env}`;
+	// getEnv strips non-word characters, so a NODE_ENV of e.g. "!!!" sanitises
+	// to the empty string. Suffixing that would look for ".env." — a file nobody
+	// creates — so fall back to the unsuffixed filename instead.
+	const fileNameFull = env ? `${filename}.${env}` : filename;
 
 	let searchPath = path.resolve(rootDir || ".");
 

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

@@ -0,0 +1,113 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import { describe, expectTypeOf, it } from "vitest";
+// Imported from the package entrypoint, not ../env.js: these assertions exist
+// to pin what consumers actually receive, so a barrel that stops re-exporting
+// something — or narrows it — must fail here.
+import { getEnv, getEnvFile, loadEnv } from "../index.js";
+
+describe("getEnv", () => {
+	it("always yields a string, since it falls back to development", () => {
+		// A `string | undefined` return would force every caller to handle an
+		// absent NODE_ENV that this function has already defaulted away.
+		expectTypeOf(getEnv).returns.toEqualTypeOf<string>();
+	});
+
+	it("takes no arguments: it reads process.env directly", () => {
+		expectTypeOf(getEnv).parameters.toEqualTypeOf<[]>();
+	});
+});
+
+describe("loadEnv", () => {
+	it("returns the resolved env path rather than void", () => {
+		// Callers log and assert on which file was actually loaded.
+		expectTypeOf(loadEnv).returns.toEqualTypeOf<string>();
+	});
+
+	it("is callable with no arguments at all", () => {
+		expectTypeOf(loadEnv).toBeCallableWith();
+	});
+
+	it("takes every argument as optional, in order", () => {
+		expectTypeOf(loadEnv).parameters.toEqualTypeOf<
+			[
+				(string | undefined)?,
+				(string | undefined)?,
+				(string | undefined)?,
+				(string | undefined)?,
+				(boolean | undefined)?,
+			]
+		>();
+	});
+
+	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", () => {
+		// @ts-expect-error override is a boolean flag
+		loadEnv("/root", ".env", "/root/.env", "test", "yes");
+	});
+
+	it("rejects a numeric root directory", () => {
+		// @ts-expect-error rootDir is a path string
+		loadEnv(1);
+	});
+});
+
+describe("getEnvFile", () => {
+	it("always resolves to a path string", () => {
+		// It returns a best-effort path even when nothing was found on disk, so
+		// the caller never has to handle undefined.
+		expectTypeOf(getEnvFile).returns.toEqualTypeOf<string>();
+	});
+
+	it("is callable with no arguments, defaulting filename and search root", () => {
+		expectTypeOf(getEnvFile).toBeCallableWith();
+	});
+
+	it("takes four optional positional arguments", () => {
+		expectTypeOf(getEnvFile).parameters.toEqualTypeOf<
+			[
+				(string | undefined)?,
+				(string | undefined)?,
+				(string | undefined)?,
+				(string | undefined)?,
+			]
+		>();
+	});
+
+	it("accepts an explicit nodeEnv override in last position", () => {
+		expectTypeOf(getEnvFile).toBeCallableWith(
+			"/root",
+			".env",
+			"/fallback",
+			"production",
+		);
+	});
+
+	it("rejects an extra argument", () => {
+		// @ts-expect-error there is no fifth parameter
+		getEnvFile("/root", ".env", "/fallback", "production", true);
+	});
+});