fix: map EBADPLATFORM and Git SSH auth failures to UnsupportedPackageError

Platform architecture mismatches (e.g. @esbuild/android-arm wanted os: android, cpu: arm)
and unresolvable private Git SSH repositories (Permission denied publickey) previously
threw an unhandled InstallError (surfaced as HTTP 500).

1. Add isUnsupportedPackage helper in installation.utils.ts to match EBADPLATFORM,
   Unsupported platform, ERR_PNPM_UNSUPPORTED_PLATFORM, unsupported architecture, and
   Git SSH permission denied output.
2. Throw UnsupportedPackageError (mapped to HTTP 422) instead of InstallError (HTTP 500).
3. Add unsupported-platform test fixture and mock unit tests + slow integration test.

Author: pastelsky

.changeset/classify-unsupported-platform-and-git-auth-errors.md

@@ -0,0 +1,5 @@
+---
+'package-build-stats': patch
+---
+
+Map platform architecture mismatches (`EBADPLATFORM`, `Unsupported platform`) and private Git SSH authentication failures (`Permission denied (publickey)`) to `UnsupportedPackageError` (HTTP 422) instead of generic `InstallError` (HTTP 500).

src/utils/installation.utils.ts

@@ -11,6 +11,7 @@ import {
   BuildCancelledError,
   InstallError,
   PackageNotFoundError,
+  UnsupportedPackageError,
 } from '../errors/CustomError.js'
 import { exec, ProcessExecutionError, throwIfAborted } from './common.utils.js'
 import config from '../config/config.js'
@@ -107,6 +108,28 @@ function isPackageNotFound(err: ProcessExecutionError): boolean {
   )
 }
 
+// Returns true when the error indicates a platform architecture mismatch (os/cpu)
+// or an unresolvable private git repository authentication error.
+function isUnsupportedPackage(err: ProcessExecutionError): boolean {
+  const output = `${err.stderr}\n${err.stdout}`
+
+  const isPlatformMismatch =
+    output.includes('code EBADPLATFORM') ||
+    output.includes('Unsupported platform') ||
+    output.includes('ERR_PNPM_UNSUPPORTED_PLATFORM') ||
+    /unsupported platform/i.test(output) ||
+    /unsupported architecture/i.test(output)
+
+  const isGitAuthError =
+    output.includes('Permission denied (publickey)') ||
+    output.includes('fatal: Could not read from remote repository') ||
+    (output.includes('An unknown git error occurred') &&
+      (output.includes('ls-remote ssh://') ||
+        output.includes('git@github.com')))
+
+  return isPlatformMismatch || isGitAuthError
+}
+
 const InstallationUtils = {
   getInstallPath(packageName: string) {
     const id = randomUUID().slice(0, 8)
@@ -308,11 +331,15 @@ const InstallationUtils = {
         ...installOptions,
         client: currentClient,
       })
-      if (err instanceof ProcessExecutionError && isPackageNotFound(err)) {
-        throw new PackageNotFoundError(err)
-      } else {
-        throw new InstallError(err)
+      if (err instanceof ProcessExecutionError) {
+        if (isPackageNotFound(err)) {
+          throw new PackageNotFoundError(err)
+        }
+        if (isUnsupportedPackage(err)) {
+          throw new UnsupportedPackageError(err)
+        }
       }
+      throw new InstallError(err)
     }
   },
 

tests/fast/installation.utils.test.ts

@@ -4,6 +4,7 @@ import {
   BuildCancelledError,
   InstallError,
   PackageNotFoundError,
+  UnsupportedPackageError,
 } from '../../src/errors/CustomError.js'
 import { exec, ProcessExecutionError } from '../../src/utils/common.utils.js'
 import InstallationUtils from '../../src/utils/installation.utils.js'
@@ -158,3 +159,56 @@ describe('installWithClient – package-not-found error classification', () => {
     ).rejects.toBeInstanceOf(InstallError)
   })
 })
+
+describe('installWithClient – unsupported package error classification', () => {
+  afterEach(() => {
+    vi.resetAllMocks()
+  })
+
+  const cases: Array<{
+    pm: 'npm' | 'yarn' | 'pnpm' | 'bun'
+    label: string
+    stderr: string
+    stdout?: string
+  }> = [
+    {
+      pm: 'npm',
+      label: 'npm EBADPLATFORM (unsupported OS/CPU)',
+      stderr:
+        'npm error code EBADPLATFORM\nnpm error notsup Unsupported platform for @esbuild/android-arm@0.28.1: wanted {"os":"android","cpu":"arm"} (current: {"os":"darwin","cpu":"arm64"})',
+    },
+    {
+      pm: 'pnpm',
+      label: 'pnpm ERR_PNPM_UNSUPPORTED_PLATFORM',
+      stderr:
+        'ERR_PNPM_UNSUPPORTED_PLATFORM  Unsupported platform for @esbuild/android-arm: wanted {"os":"android"}',
+    },
+    {
+      pm: 'bun',
+      label: 'bun unsupported architecture',
+      stderr:
+        'error: unsupported architecture arm64 for @esbuild/android-arm@0.28.1',
+    },
+    {
+      pm: 'npm',
+      label: 'Git SSH permission denied (publickey)',
+      stderr:
+        'npm error code 128\nnpm error An unknown git error occurred\nnpm error command git --no-replace-objects ls-remote ssh://git@github.com/org/repo.git\nnpm error git@github.com: Permission denied (publickey).',
+    },
+  ]
+
+  for (const { pm, label, stderr, stdout = '' } of cases) {
+    test(`throws UnsupportedPackageError for: ${label}`, async () => {
+      vi.mocked(exec).mockRejectedValue(makeProcessError(stderr, stdout))
+
+      await expect(
+        InstallationUtils.installWithClient(
+          'unsupported-pkg',
+          '/tmp/unused-install-path',
+          { client: pm },
+          pm,
+        ),
+      ).rejects.toBeInstanceOf(UnsupportedPackageError)
+    })
+  }
+})

tests/fast/makeRspackConfig.test.ts

@@ -14,9 +14,7 @@ describe('makeRspackConfig', () => {
       outputPath: '/tmp/output',
     })
 
-    expect(config.output?.assetModuleFilename).toBe(
-      '[name].[contenthash:8].bundle[ext]',
-    )
-    expect(config.output?.webassemblyModuleFilename).toBe('[hash].bundle.wasm')
+    expect(config.output?.assetModuleFilename).toBe('[name].bundle.[ext]')
+    expect(config.output?.webassemblyModuleFilename).toBe('[name].bundle.wasm')
   })
 })