fix(install): show dependency name when file: path resolution fails (#26340)

## Summary - When `bun install` encounters a stale lockfile with a `file:` dependency path that differs from the package.json, it now shows which dependency caused the issue instead of the misleading "Bun could not find a package.json file to install from" error. ## Test plan - Added regression test in `test/regression/issue/26337.test.ts` - Verified test fails with system bun (`USE_SYSTEM_BUN=1 bun test test/regression/issue/26337.test.ts`) - Verified test passes with debug build (`bun bd test test/regression/issue/26337.test.ts`) Fixes #26337 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Bot <claude-bot@bun.sh> Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 15:08:46 +00:00 · 2026-01-21 18:41:15 -08:00
parent 93d5cc6e56
commit 136d345752
2 changed files with 112 additions and 6 deletions
--- a/test/regression/issue/26337.test.ts
+++ b/test/regression/issue/26337.test.ts
@@ -0,0 +1,78 @@
+// https://github.com/oven-sh/bun/issues/26337
+// Test that `bun install` with a stale lockfile that has a `file:` dependency path
+// that differs from the package.json shows a helpful error message indicating which
+// dependency caused the issue, rather than the misleading "Bun could not find a
+// package.json file to install from" error.
+
+import { describe, expect, it } from "bun:test";
+import { bunEnv, bunExe, tempDir } from "harness";
+
+describe("issue #26337 - missing file: dependency error should show dependency name", () => {
+  it("should show which dependency path is missing when lockfile has stale file: path", async () => {
+    // Create a workspace with a valid file: dependency
+    using dir = tempDir("issue-26337", {
+      "package.json": JSON.stringify({
+        name: "repro",
+        dependencies: {
+          "@scope/dep": "file:./packages/@scope/dep",
+        },
+      }),
+      "packages/@scope/dep/package.json": JSON.stringify({
+        name: "@scope/dep",
+        version: "1.0.0",
+      }),
+    });
+
+    // First install to create a lockfile with the valid path
+    await using installProc = Bun.spawn({
+      cmd: [bunExe(), "install"],
+      cwd: String(dir),
+      env: bunEnv,
+      stdout: "pipe",
+      stderr: "pipe",
+    });
+
+    // Consume streams to prevent buffer filling
+    const [, , installExitCode] = await Promise.all([
+      installProc.stdout.text(),
+      installProc.stderr.text(),
+      installProc.exited,
+    ]);
+    expect(installExitCode).toBe(0);
+
+    // Now update the package.json to point to a non-existent path
+    // This creates the stale lockfile scenario
+    await Bun.write(
+      `${dir}/package.json`,
+      JSON.stringify({
+        name: "repro",
+        dependencies: {
+          "@scope/dep": "file:./nonexistent/path",
+        },
+      }),
+    );
+
+    // Run bun install again - this should show a helpful error
+    await using failProc = Bun.spawn({
+      cmd: [bunExe(), "install"],
+      cwd: String(dir),
+      env: bunEnv,
+      stdout: "pipe",
+      stderr: "pipe",
+    });
+
+    const [stdout, stderr, exitCode] = await Promise.all([
+      failProc.stdout.text(),
+      failProc.stderr.text(),
+      failProc.exited,
+    ]);
+
+    // The error output should mention the dependency name
+    const output = stdout + stderr;
+    expect(output).toContain("@scope/dep");
+    expect(output).toContain("error occurred while resolving");
+
+    // The install should fail
+    expect(exitCode).toBe(1);
+  });
+});