fix: stop pinning plugins with prerelease versions

packages/build/src/plugins/pinned_version.js

@@ -1,5 +1,5 @@
 import { handleBuildError } from '../error/handle.js'
-import { getMajorVersion } from '../utils/semver.js'
+import { getMajorVersion, isPrerelease } from '../utils/semver.js'
 
 // Retrieve plugin's pinned major versions by fetching the latest `PluginRun`
 // Only applies to `netlify.toml`-only installed plugins.
@@ -80,10 +80,17 @@
 //  - the plugin was installed in the UI
 //  - both the build and the plugin succeeded
 const shouldPinVersion = function ({
-  pluginOptions: { packageName, pinnedVersion, loadedFrom, origin },
+  pluginOptions: {
+    packageName,
+    pinnedVersion,
+    pluginPackageJson: { version },
+    loadedFrom,
+    origin,
+  },
   failedPlugins,
 }) {
   return (
+    !isPrerelease(version) &&
     pinnedVersion === undefined &&
     loadedFrom === 'auto_install' &&
     origin === 'ui' &&

packages/build/src/utils/semver.js

@@ -32,3 +32,9 @@ export const getMajorVersion = function (version) {
   const patchVersion = semver.patch(version)
   return `${majorVersion}.${minorVersion}.${patchVersion}`
 }
+
+export const isPrerelease = function (version) {
+  // Prerelease versions are excluded from ranges unless `includePrerelease` is
+  // set to `true`.
+  return !semver.satisfies(version, '>=0.0.0', { includePrerelease: false })
+}

packages/build/tests/plugins_list/fixtures/pin_prerelease/.netlify/plugins/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "netlify-local-plugins",
+  "description": "This directory contains Build plugins that have been automatically installed by Netlify.",
+  "version": "1.0.0",
+  "type": "module",
+  "private": true,
+  "author": "Netlify",
+  "license": "MIT",
+  "dependencies": {
+    "netlify-plugin-contextual-env": "1.2.3-rc"
+  }
+}

packages/build/tests/plugins_list/fixtures/pin_prerelease/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "module_plugin",
+  "version": "0.0.1",
+  "type": "module",
+  "description": "test",
+  "license": "MIT",
+  "repository": "test",
+  "dependencies": {}
+}

packages/build/tests/plugins_list/snapshots/tests.js.md

@@ -2641,6 +2641,65 @@ Generated by [AVA](https://avajs.dev).
     (Netlify Build completed in 1ms)␊
     Build step duration: Netlify Build completed in 1ms`
 
+## Do not pin plugin with prerelease versions
+
+> Snapshot 1
+
+    `␊
+    Netlify Build                                                 ␊
+    ────────────────────────────────────────────────────────────────␊
+    ␊
+    > Version␊
+      @netlify/build 1.0.0␊
+    ␊
+    > Flags␊
+      debug: true␊
+      repositoryRoot: packages/build/tests/plugins_list/fixtures/pin_prerelease␊
+      sendStatus: true␊
+      siteId: test␊
+      testOpts:␊
+        host: /test/socket␊
+        pluginsListUrl: /test/socket␊
+        scheme: http␊
+        silentLingeringProcesses: true␊
+    ␊
+    > Current directory␊
+      packages/build/tests/plugins_list/fixtures/pin_prerelease␊
+    ␊
+    > Config file␊
+      No config file was defined: using default values.␊
+    ␊
+    > Resolved config␊
+      build:␊
+        publish: packages/build/tests/plugins_list/fixtures/pin_prerelease␊
+        publishOrigin: default␊
+      plugins:␊
+        - inputs: {}␊
+          origin: ui␊
+          package: netlify-plugin-contextual-env␊
+    ␊
+    > Context␊
+      production␊
+    ␊
+    > Available plugins␊
+    ␊
+    > Loading plugins␊
+       - netlify-plugin-contextual-env 1-2-3-rc from Netlify app (latest 1-2-3-rc, expected 1-2-3-rc, compatible 1-2-3-rc)␊
+    ␊
+    netlify-plugin-contextual-env (onPreBuild event)              ␊
+    ────────────────────────────────────────────────────────────────␊
+    ␊
+    test␊
+    ␊
+    (netlify-plugin-contextual-env onPreBuild completed in 1ms)␊
+    Build step duration: netlify-plugin-contextual-env onPreBuild completed in 1ms␊
+    ␊
+    Netlify Build Complete                                        ␊
+    ────────────────────────────────────────────────────────────────␊
+    ␊
+    (Netlify Build completed in 1ms)␊
+    Build step duration: Netlify Build completed in 1ms`
+
 ## Pin netlify.toml-only plugin versions
 
 > Snapshot 1

packages/build/tests/plugins_list/tests.js

@@ -411,6 +411,12 @@ test('Pinning plugin versions takes into account the compatibility field', async
   })
 })
 
+test('Do not pin plugin with prerelease versions', async (t) => {
+  // By setting the status to 500 we ensure that the endpoint for pinning is
+  // not being called, otherwise an error would be thrown.
+  await runWithUpdatePluginMock(t, 'pin_prerelease', { status: 500, testPlugin: { version: '1.2.3-rc' } })
+})
+
 const runWithPluginRunsMock = async function (
   t,
   fixtureName,