refactor: replace parent-module with process.cwd() for path resolution (#3)

Author: koistya

.pnp.cjs

@@ -11,8 +11,8 @@ export type SecretSource = "google" | "aws" | "azure";
  * @see https://cloud.google.com/secret-manager
  * @example
  *   const [env, secrets] = await loadEnv("development", {
- *     root: "..",
- *     schema: "./core/env.ts",
+ *     root: "./apps/backend",  // relative to process.cwd()
+ *     schema: "./env.ts",      // relative to process.cwd()
  *     mergeTo: process.env,
  *   });
  *
@@ -21,9 +21,9 @@ export type SecretSource = "google" | "aws" | "azure";
  */
 export function loadEnv(
   environment: string | undefined,
-  options: {
+  options?: {
     /**
-     * Where to look for `.env` files. Defaults to the current working directory.
+     * Where to look for `.env` files. Defaults to the current working directory (process.cwd()).
      */
     root?: string;
     /**
@@ -39,7 +39,7 @@ export function loadEnv(
     files?: string[] | string;
     /**
      * Path to the environment schema file exporting environment variables
-     * required by the app at runtime.
+     * required by the app at runtime. The path is resolved relative to process.cwd().
      *
      * @example
      *   // env.ts

index.d.ts

@@ -7,9 +7,7 @@ import { expand } from "dotenv-expand";
 import { build } from "esbuild";
 import { importFromString } from "module-from-string";
 import { readFile } from "node:fs/promises";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import parentModule from "parent-module";
+import { resolve } from "node:path";
 import { readPackageUp } from "read-pkg-up";
 
 // Matches the following patterns:
@@ -26,8 +24,8 @@ const secretRegExp = /^secret:\/\/(\w+)\/(.*)$/;
  * @see https://cloud.google.com/secret-manager
  * @example
  *   const [env, secrets] = await loadEnv("development", {
- *     root: "..",
- *     schema: "./core/env.ts",
+ *     root: "./apps/backend",  // relative to process.cwd()
+ *     schema: "./env.ts",      // relative to process.cwd()
  *     mergeTo: process.env,
  *   });
  *
@@ -37,7 +35,7 @@ const secretRegExp = /^secret:\/\/(\w+)\/(.*)$/;
  *  files?: string[] | string;
  *  schema?: string;
  *  mergeTo?: Record<string, unknown>;
- * }} options Loading options
+ * }} options Loading options. The `root` defaults to `process.cwd()`, and `schema` is resolved relative to `process.cwd()`.
  * @return {Promise<[env: Record<string, string>, secrets: Map<string, { ref: string; source: "google" | "aws" | "azure" }]>}
  */
 export async function loadEnv(environment, options) {
@@ -59,11 +57,7 @@ export async function loadEnv(environment, options) {
   }
 
   // Load environment variables from the `.env` files
-  const parentFile = parentModule();
-  const parentDir = dirname(
-    parentFile.startsWith("file://") ? fileURLToPath(parentFile) : parentFile,
-  );
-  const rootDir = resolve(parentDir, options?.root ?? ".");
+  const rootDir = resolve(options?.root ?? process.cwd());
   const encoding = options?.encoding ?? "utf-8";
   const parsed = await Promise.all(
     files.map((file) => {
@@ -98,8 +92,8 @@ export async function loadEnv(environment, options) {
 
   if (options?.schema) {
     // Transpile the schema file into ESM code
-    const schemaFile = resolve(parentDir, options?.schema);
-    const { packageJson } = await readPackageUp({ cwd: parentDir });
+    const schemaFile = resolve(process.cwd(), options.schema);
+    const { packageJson } = await readPackageUp({ cwd: process.cwd() });
     const {
       outputFiles: [{ text: contents }],
     } = await build({
@@ -118,7 +112,7 @@ export async function loadEnv(environment, options) {
 
     // Import env schema
     const envObj = await importFromString(contents, {
-      dirname: parentDir,
+      dirname: process.cwd(),
       filename: schemaFile,
       useCurrentGlobal: true,
     }).then((module) => module.env ?? module.default);

index.js

@@ -54,7 +54,6 @@
     "dotenv-expand": "^12.0.1",
     "esbuild": "^0.24.2",
     "module-from-string": "^3.3.1",
-    "parent-module": "^3.1.0",
     "read-pkg-up": "^11.0.0"
   },
   "devDependencies": {

package.json

@@ -1189,7 +1189,7 @@ __metadata:
   languageName: node
   linkType: hard
 
-"callsites@npm:^4.1.0, callsites@npm:^4.2.0":
+"callsites@npm:^4.2.0":
   version: 4.2.0
   resolution: "callsites@npm:4.2.0"
   checksum: 10/9a740675712076a38208967d7f80b525c9c7f4524c2af5d3936c5e278a601af0423a07e91f79679fec0546f3a52514d56969c6fe65f84d794e64a36b1f5eda8a
@@ -1518,7 +1518,6 @@ __metadata:
     eslint-config-prettier: "npm:^9.1.0"
     globals: "npm:^15.14.0"
     module-from-string: "npm:^3.3.1"
-    parent-module: "npm:^3.1.0"
     prettier: "npm:^3.4.2"
     read-pkg-up: "npm:^11.0.0"
     typescript: "npm:^5.7.2"
@@ -2837,15 +2836,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"parent-module@npm:^3.1.0":
-  version: 3.1.0
-  resolution: "parent-module@npm:3.1.0"
-  dependencies:
-    callsites: "npm:^4.1.0"
-  checksum: 10/8c089b0077b45f13f17acaa9e4fca34d76c6eba3c628778b54a8caf6bdafeb63fbce2f082063841df279cad427e3ac9a202f69dbf56d68bb9e17473268dbd10c
-  languageName: node
-  linkType: hard
-
 "parse-json@npm:^8.0.0":
   version: 8.1.0
   resolution: "parse-json@npm:8.1.0"