@netlify/build 29.0.0-rc → 29.0.0

package/lib/plugins/list.js

@@ -0,0 +1,73 @@
+import { pluginsUrl, pluginsList as oldPluginsList } from '@netlify/plugins-list';
+import got from 'got';
+import isPlainObj from 'is-plain-obj';
+import { logPluginsList, logPluginsFetchError } from '../log/messages/plugins.js';
+import { CONDITIONS } from './compatibility.js';
+// Retrieve the list of plugins officially vetted by us and displayed in our
+// plugins directory UI.
+// We fetch this list during each build (no caching) because we want new
+// versions of plugins to be available instantly to all users. The time to
+// make this request is somewhat ok (in the 100ms range).
+// We only fetch this plugins list when needed, i.e. we defer it as much as
+// possible.
+export const getPluginsList = async function ({ debug, logs, testOpts: { pluginsListUrl } }) {
+    // We try not to mock in integration tests. However, sending a request for
+    // each test would be too slow and make tests unreliable.
+    if (pluginsListUrl === 'test') {
+        return [];
+    }
+    const pluginsListUrlA = pluginsListUrl === undefined ? pluginsUrl : pluginsListUrl;
+    const pluginsList = await fetchPluginsList({ logs, pluginsListUrl: pluginsListUrlA });
+    const pluginsListA = normalizePluginsList(pluginsList);
+    logPluginsList({ pluginsList: pluginsListA, debug, logs });
+    return pluginsListA;
+};
+const fetchPluginsList = async function ({ logs, pluginsListUrl }) {
+    try {
+        const { body } = await got(pluginsListUrl, { responseType: 'json', timeout: PLUGINS_LIST_TIMEOUT });
+        if (!isValidPluginsList(body)) {
+            throw new Error(`Request succeeded but with an invalid response:\n${JSON.stringify(body, null, 2)}`);
+        }
+        return body;
+        // The Netlify Site should be up. This is a fallback.
+        // `oldPluginsList` might not contain the latest plugins versions:
+        //  - We should do `npm publish` as soon as a PR is merged in
+        //    `netlify/plugins` but it is possible we don't.
+        //  - Releasing it requires a @netlify/buld release, which requires itself a
+        //    buildbot release.
+    }
+    catch (error) {
+        logPluginsFetchError(logs, error.message);
+        return oldPluginsList;
+    }
+};
+// 1 minute HTTP request timeout
+const PLUGINS_LIST_TIMEOUT = 6e4;
+const isValidPluginsList = function (pluginsList) {
+    return Array.isArray(pluginsList) && pluginsList.every(isPlainObj);
+};
+const normalizePluginsList = function (pluginsList) {
+    return Object.fromEntries(pluginsList.map(normalizePluginItem));
+};
+// `version` in `plugins.json` is the latest version.
+// A `compatibility` array of objects can be added to specify conditions to
+// apply different versions.
+// `netlify/plugins` ensures that `compatibility`:
+//  - Has the proper shape.
+//  - Is sorted from the highest to lowest version.
+//  - Does not include the latest `version`.
+const normalizePluginItem = function ({ package: packageName, version, compatibility = [] }) {
+    const versions = compatibility.length === 0 ? [{ version }] : compatibility;
+    const versionsA = versions.map(normalizeCompatVersion);
+    return [packageName, versionsA];
+};
+const normalizeCompatVersion = function ({ version, migrationGuide, featureFlag, ...otherProperties }) {
+    const conditions = Object.entries(otherProperties).filter(isCondition).map(normalizeCondition);
+    return { version, migrationGuide, featureFlag, conditions };
+};
+const isCondition = function ([type]) {
+    return type in CONDITIONS;
+};
+const normalizeCondition = function ([type, condition]) {
+    return { type, condition };
+};

package/lib/plugins/load.js

@@ -0,0 +1,50 @@
+import { addErrorInfo } from '../error/info.js';
+import { addPluginLoadErrorStatus } from '../status/load_error.js';
+import { measureDuration } from '../time/main.js';
+import { callChild } from './ipc.js';
+// Retrieve all plugins steps
+// Can use either a module name or a file path to the plugin.
+export const loadPlugins = async function ({ pluginsOptions, childProcesses, packageJson, timers, logs, debug, verbose, }) {
+    return pluginsOptions.length === 0
+        ? { pluginsSteps: [], timers }
+        : await loadAllPlugins({ pluginsOptions, childProcesses, packageJson, timers, logs, debug, verbose });
+};
+const tLoadAllPlugins = async function ({ pluginsOptions, childProcesses, packageJson, logs, debug, verbose }) {
+    const pluginsSteps = await Promise.all(pluginsOptions.map((pluginOptions, index) => loadPlugin(pluginOptions, { childProcesses, index, packageJson, logs, debug, verbose })));
+    const pluginsStepsA = pluginsSteps.flat();
+    return { pluginsSteps: pluginsStepsA };
+};
+// Only performed if there are some plugins
+const loadAllPlugins = measureDuration(tLoadAllPlugins, 'load_plugins');
+// Retrieve plugin steps for one plugin.
+// Do it by executing the plugin `load` event handler.
+const loadPlugin = async function ({ packageName, pluginPackageJson, pluginPackageJson: { version } = {}, pluginPath, inputs, loadedFrom, origin }, { childProcesses, index, packageJson, logs, debug, verbose }) {
+    const { childProcess } = childProcesses[index];
+    const loadEvent = 'load';
+    try {
+        const { events } = await callChild({
+            childProcess,
+            eventName: 'load',
+            payload: { pluginPath, inputs, packageJson, verbose },
+            logs,
+            verbose: false,
+        });
+        const pluginSteps = events.map((event) => ({
+            event,
+            packageName,
+            loadedFrom,
+            origin,
+            pluginPackageJson,
+            childProcess,
+        }));
+        return pluginSteps;
+    }
+    catch (error) {
+        addErrorInfo(error, {
+            plugin: { packageName, pluginPackageJson },
+            location: { event: loadEvent, packageName, loadedFrom, origin },
+        });
+        addPluginLoadErrorStatus({ error, packageName, version, debug });
+        throw error;
+    }
+};

package/lib/plugins/manifest/check.js

@@ -0,0 +1,85 @@
+import { addErrorInfo } from '../../error/info.js';
+import { serializeObject } from '../../log/serialize.js';
+import { THEME } from '../../log/theme.js';
+// Check that plugin inputs match the validation specified in "manifest.yml"
+// Also assign default values
+export const checkInputs = function ({ inputs, manifest: { inputs: rules = [] }, packageName, pluginPackageJson, loadedFrom, origin, }) {
+    try {
+        const inputsA = addDefaults(inputs, rules);
+        checkRequiredInputs({ inputs: inputsA, rules, packageName, pluginPackageJson, loadedFrom, origin });
+        checkUnknownInputs({ inputs: inputsA, rules, packageName, pluginPackageJson, loadedFrom, origin });
+        return inputsA;
+    }
+    catch (error) {
+        error.message = `${error.message}
+
+${THEME.errorSubHeader('Plugin inputs')}
+${serializeObject(inputs)}`;
+        throw error;
+    }
+};
+// Add "inputs[*].default"
+const addDefaults = function (inputs, rules) {
+    const defaults = rules.filter(hasDefault).map(getDefault);
+    return Object.assign({}, ...defaults, inputs);
+};
+const hasDefault = function (rule) {
+    return rule.default !== undefined;
+};
+const getDefault = function ({ name, default: defaultValue }) {
+    return { [name]: defaultValue };
+};
+// Check "inputs[*].required"
+const checkRequiredInputs = function ({ inputs, rules, packageName, pluginPackageJson, loadedFrom, origin }) {
+    const missingInputs = rules.filter((rule) => isMissingRequired(inputs, rule));
+    if (missingInputs.length === 0) {
+        return;
+    }
+    const names = missingInputs.map(getName);
+    const error = new Error(`Required inputs for plugin "${packageName}": ${names.join(', ')}`);
+    addInputError({ error, name: names[0], packageName, pluginPackageJson, loadedFrom, origin });
+    throw error;
+};
+const isMissingRequired = function (inputs, { name, required }) {
+    return required && inputs[name] === undefined;
+};
+const getName = function ({ name }) {
+    return name;
+};
+// Check each "inputs[*].*" property for a specific input
+const checkUnknownInputs = function ({ inputs, rules, packageName, pluginPackageJson, loadedFrom, origin }) {
+    const knownInputs = rules.map(getName);
+    const unknownInputs = Object.keys(inputs).filter((name) => !knownInputs.includes(name));
+    if (unknownInputs.length === 0) {
+        return;
+    }
+    const unknownInputsMessage = getUnknownInputsMessage({ packageName, knownInputs, unknownInputs });
+    const error = new Error(`${unknownInputsMessage}
+Check your plugin configuration to be sure that:
+  - the input name is spelled correctly
+  - the input is included in the plugin's available configuration options
+  - the plugin's input requirements have not changed`);
+    const [name] = unknownInputs;
+    addInputError({ error, name, packageName, pluginPackageJson, loadedFrom, origin });
+    throw error;
+};
+const getUnknownInputsMessage = function ({ packageName, knownInputs, unknownInputs }) {
+    const unknownInputsStr = unknownInputs.map(quoteWord).join(', ');
+    if (knownInputs.length === 0) {
+        return `Plugin "${packageName}" does not accept any inputs but you specified: ${unknownInputsStr}`;
+    }
+    const knownInputsStr = knownInputs.map(quoteWord).join(', ');
+    return `Unknown inputs for plugin "${packageName}": ${unknownInputsStr}
+Plugin inputs should be one of: ${knownInputsStr}`;
+};
+const quoteWord = function (word) {
+    return `"${word}"`;
+};
+// Add error information
+const addInputError = function ({ error, name, packageName, pluginPackageJson, loadedFrom, origin }) {
+    addErrorInfo(error, {
+        type: 'pluginInput',
+        plugin: { packageName, pluginPackageJson },
+        location: { event: 'load', packageName, input: name, loadedFrom, origin },
+    });
+};

package/lib/plugins/manifest/load.js

@@ -0,0 +1,38 @@
+import { promises as fs } from 'fs';
+import { load as loadYaml, JSON_SCHEMA } from 'js-yaml';
+import { addErrorInfo } from '../../error/info.js';
+import { validateManifest } from './validate.js';
+// Load "manifest.yml" using its file path
+export const loadManifest = async function ({ manifestPath, packageName, pluginPackageJson, loadedFrom, origin }) {
+    try {
+        const rawManifest = await loadRawManifest(manifestPath);
+        const manifest = await parseManifest(rawManifest);
+        validateManifest(manifest, rawManifest);
+        return manifest;
+    }
+    catch (error) {
+        addErrorInfo(error, {
+            type: 'pluginValidation',
+            plugin: { packageName, pluginPackageJson },
+            location: { event: 'load', packageName, loadedFrom, origin },
+        });
+        throw error;
+    }
+};
+const loadRawManifest = async function (manifestPath) {
+    try {
+        return await fs.readFile(manifestPath, 'utf8');
+    }
+    catch (error) {
+        error.message = `Could not load plugin's "manifest.yml"\n${error.message}`;
+        throw error;
+    }
+};
+const parseManifest = async function (rawManifest) {
+    try {
+        return await loadYaml(rawManifest, { schema: JSON_SCHEMA, json: true });
+    }
+    catch (error) {
+        throw new Error(`Could not parse plugin's "manifest.yml"\n${error.message}`);
+    }
+};

package/lib/plugins/manifest/main.js

@@ -0,0 +1,19 @@
+import { addPluginLoadErrorStatus } from '../../status/load_error.js';
+import { checkInputs } from './check.js';
+import { loadManifest } from './load.js';
+import { getManifestPath } from './path.js';
+/**
+ * Load plugin's `manifest.yml`
+ */
+export const useManifest = async function ({ packageName, loadedFrom, origin, inputs, }, { pluginDir, packageDir, pluginPackageJson, pluginPackageJson: { version }, debug, }) {
+    const manifestPath = await getManifestPath({ pluginDir, packageDir, packageName });
+    try {
+        const manifest = await loadManifest({ manifestPath, packageName, pluginPackageJson, loadedFrom, origin });
+        const inputsA = checkInputs({ inputs, manifest, packageName, pluginPackageJson, loadedFrom, origin });
+        return { manifest, inputs: inputsA };
+    }
+    catch (error) {
+        addPluginLoadErrorStatus({ error, packageName, version, debug });
+        throw error;
+    }
+};

package/lib/plugins/manifest/path.js

@@ -0,0 +1,24 @@
+import { locatePath } from 'locate-path';
+import { addErrorInfo } from '../../error/info.js';
+// Retrieve "manifest.yml" path for a specific plugin
+export const getManifestPath = async function ({ pluginDir, packageDir, packageName }) {
+    const dirs = [pluginDir, packageDir]
+        .filter(Boolean)
+        .flatMap((dir) => MANIFEST_FILENAMES.map((filename) => `${dir}/${filename}`));
+    const manifestPath = await locatePath(dirs);
+    validateManifestExists(manifestPath, packageName);
+    return manifestPath;
+};
+const validateManifestExists = function (manifestPath, packageName) {
+    if (manifestPath !== undefined) {
+        return;
+    }
+    const error = new Error(`The plugin "${packageName}" is missing a "manifest.yml".
+This might mean:
+  - The plugin "package" name is misspelled
+  - The plugin "package" points to a Node module that is not a Netlify Build plugin
+  - If you're developing a plugin, please see the documentation at https://docs.netlify.com/configure-builds/build-plugins/create-plugins/#anatomy-of-a-plugin`);
+    addErrorInfo(error, { type: 'resolveConfig' });
+    throw error;
+};
+const MANIFEST_FILENAMES = ['manifest.yml', 'manifest.yaml'];

package/lib/plugins/manifest/validate.js

@@ -0,0 +1,91 @@
+import isPlainObj from 'is-plain-obj';
+import { THEME } from '../../log/theme.js';
+// Validate `manifest.yml` syntax
+export const validateManifest = function (manifest, rawManifest) {
+    try {
+        validateBasic(manifest);
+        validateUnknownProps(manifest);
+        validateName(manifest);
+        validateInputs(manifest);
+    }
+    catch (error) {
+        error.message = `Plugin's "manifest.yml" ${error.message}
+
+${THEME.errorSubHeader('manifest.yml')}
+${rawManifest.trim()}`;
+        throw error;
+    }
+};
+const validateBasic = function (manifest) {
+    if (!isPlainObj(manifest)) {
+        throw new Error('must be a plain object');
+    }
+};
+const validateUnknownProps = function (manifest) {
+    const unknownProp = Object.keys(manifest).find((key) => !VALID_PROPS.has(key));
+    if (unknownProp !== undefined) {
+        throw new Error(`unknown property "${unknownProp}"`);
+    }
+};
+const VALID_PROPS = new Set(['name', 'inputs']);
+const validateName = function ({ name }) {
+    if (name === undefined) {
+        throw new Error('must contain a "name" property');
+    }
+    if (typeof name !== 'string') {
+        throw new TypeError('"name" property must be a string');
+    }
+};
+const validateInputs = function ({ inputs }) {
+    if (inputs === undefined) {
+        return;
+    }
+    if (!isArrayOfObjects(inputs)) {
+        throw new Error('"inputs" property must be an array of objects');
+    }
+    inputs.forEach(validateInput);
+};
+const isArrayOfObjects = function (objects) {
+    return Array.isArray(objects) && objects.every(isPlainObj);
+};
+const validateInput = function (input, index) {
+    try {
+        validateUnknownInputProps(input);
+        validateInputName(input);
+        validateInputDescription(input);
+        validateInputRequired(input);
+    }
+    catch (error) {
+        error.message = `"inputs" property is invalid.
+Input at position ${index} ${error.message}.`;
+        throw error;
+    }
+};
+const validateUnknownInputProps = function (input) {
+    const unknownProp = Object.keys(input).find((key) => !VALID_INPUT_PROPS.has(key));
+    if (unknownProp !== undefined) {
+        throw new Error(`has an unknown property "${unknownProp}"`);
+    }
+};
+const VALID_INPUT_PROPS = new Set(['name', 'description', 'required', 'default']);
+const validateInputName = function ({ name }) {
+    if (name === undefined) {
+        throw new Error('must contain a "name" property');
+    }
+    if (typeof name !== 'string') {
+        throw new TypeError('"name" property must be a string');
+    }
+};
+const validateInputDescription = function ({ description }) {
+    if (description === undefined) {
+        return;
+    }
+    if (typeof description !== 'string') {
+        throw new TypeError('"description" property must be a string');
+    }
+};
+const validateInputRequired = function ({ required }) {
+    if (required !== undefined && typeof required !== 'boolean') {
+        throw new Error('"required" property must be a boolean');
+    }
+};

package/lib/plugins/node_version.js

@@ -0,0 +1,35 @@
+import { execPath, version as currentVersion } from 'process';
+import semver from 'semver';
+import link from 'terminal-link';
+import { logWarning, logWarningSubHeader } from '../log/logger.js';
+/**
+ * This node version is minimum required to run the plugins code.
+ * If the users preferred Node.js version is below that we have to fall back to the system node version
+ */
+const MINIMUM_REQUIRED_NODE_VERSION = '^14.14.0 || >=16.0.0';
+/**
+ * Local plugins and `package.json`-installed plugins use user's preferred Node.js version if higher than our minimum
+ * supported version. Else default to the system Node version.
+ * Local and programmatic builds use `@netlify/build` Node.js version, which is
+ * usually the system's Node.js version.
+ * If the user Node version does not satisfy our supported engine range use our own system Node version
+ */
+export const addPluginsNodeVersion = function ({ pluginsOptions, nodePath, userNodeVersion, logs }) {
+    const currentNodeVersion = semver.clean(currentVersion);
+    return pluginsOptions.map((pluginOptions) => addPluginNodeVersion({ pluginOptions, currentNodeVersion, userNodeVersion, nodePath, logs }));
+};
+const addPluginNodeVersion = function ({ pluginOptions, pluginOptions: { loadedFrom, packageName }, currentNodeVersion, userNodeVersion, nodePath, logs, }) {
+    // if the plugin is a local one and the users node version does not satisfy
+    // our minimum required node version log a warning as we will default to the system node version
+    if ((loadedFrom === 'local' || loadedFrom === 'package.json') &&
+        !semver.satisfies(userNodeVersion, MINIMUM_REQUIRED_NODE_VERSION)) {
+        logWarningSubHeader(logs, `Warning: ${packageName} will be executed with Node.js version ${currentNodeVersion}`);
+        logWarning(logs, `  The plugin cannot be executed with your defined Node.js version ${userNodeVersion}
+
+  Read more about our minimum required version in our ${link('forums announcement', 'https://answers.netlify.com/t/build-plugins-dropping-support-for-node-js-12/79421')}`);
+    }
+    return (loadedFrom === 'local' || loadedFrom === 'package.json') &&
+        semver.satisfies(userNodeVersion, MINIMUM_REQUIRED_NODE_VERSION)
+        ? { ...pluginOptions, nodePath, nodeVersion: userNodeVersion }
+        : { ...pluginOptions, nodePath: execPath, nodeVersion: currentNodeVersion };
+};

package/lib/plugins/options.js

@@ -0,0 +1,70 @@
+import { dirname } from 'path';
+import semver from 'semver';
+import { addErrorInfo } from '../error/info.js';
+import { installLocalPluginsDependencies } from '../install/local.js';
+import { measureDuration } from '../time/main.js';
+import { ROOT_PACKAGE_JSON } from '../utils/json.js';
+import { getPackageJson } from '../utils/package.js';
+import { useManifest } from './manifest/main.js';
+import { resolvePluginsPath } from './resolve.js';
+// Load core plugins and user plugins
+const tGetPluginsOptions = async function ({ pluginsOptions, netlifyConfig: { plugins }, siteInfo, buildDir, nodePath, packageJson, userNodeVersion, mode, api, logs, debug, sendStatus, testOpts, featureFlags, }) {
+    const pluginsOptionsA = await resolvePluginsPath({
+        pluginsOptions,
+        siteInfo,
+        buildDir,
+        nodePath,
+        packageJson,
+        userNodeVersion,
+        mode,
+        api,
+        logs,
+        debug,
+        sendStatus,
+        testOpts,
+        featureFlags,
+    });
+    const pluginsOptionsB = await Promise.all(pluginsOptionsA.map((pluginOptions) => loadPluginFiles({ pluginOptions, debug })));
+    const pluginsOptionsC = pluginsOptionsB.filter(isNotRedundantCorePlugin);
+    await installLocalPluginsDependencies({ plugins, pluginsOptions: pluginsOptionsC, buildDir, mode, logs });
+    return { pluginsOptions: pluginsOptionsC };
+};
+export const getPluginsOptions = measureDuration(tGetPluginsOptions, 'get_plugins_options');
+// Retrieve plugin's main file path.
+// Then load plugin's `package.json` and `manifest.yml`.
+const loadPluginFiles = async function ({ pluginOptions, pluginOptions: { pluginPath, nodeVersion, packageName }, debug, }) {
+    const pluginDir = dirname(pluginPath);
+    const { packageDir, packageJson: pluginPackageJson } = await getPackageJson(pluginDir);
+    // Ensure Node.js version is compatible with plugin's `engines.node`
+    const pluginNodeVersionRange = pluginPackageJson?.engines?.node;
+    if (pluginNodeVersionRange && !semver.satisfies(nodeVersion, pluginNodeVersionRange)) {
+        throwUserError(`The Node.js version is ${nodeVersion} but the plugin "${packageName}" requires ${pluginNodeVersionRange}`);
+    }
+    const { manifest, inputs } = await useManifest(pluginOptions, { pluginDir, packageDir, pluginPackageJson, debug });
+    return { ...pluginOptions, pluginDir, packageDir, pluginPackageJson, manifest, inputs };
+};
+// Core plugins can only be included once.
+// For example, when testing core plugins, they might be included as local plugins,
+// in which case they should not be included twice.
+const isNotRedundantCorePlugin = function (pluginOptionsA, index, pluginsOptions) {
+    return (pluginOptionsA.loadedFrom !== 'core' ||
+        pluginsOptions.every((pluginOptionsB) => pluginOptionsA.manifest.name !== pluginOptionsB.manifest.name || pluginOptionsA === pluginOptionsB));
+};
+/**
+ * Retrieve information about @netlify/build when an error happens there and not
+ * in a plugin
+ */
+export const getSpawnInfo = () => {
+    // we know that this package.json has a name as it's ours
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    const packageName = ROOT_PACKAGE_JSON.name;
+    return {
+        plugin: { packageName, pluginPackageJson: ROOT_PACKAGE_JSON },
+        location: { event: 'load', packageName, loadedFrom: 'core', origin: 'core' },
+    };
+};
+const throwUserError = function (message) {
+    const error = new Error(message);
+    addErrorInfo(error, { type: 'resolveConfig' });
+    throw error;
+};

package/lib/plugins/pinned_version.js

@@ -0,0 +1,83 @@
+import { handleBuildError } from '../error/handle.js';
+import { getMajorVersion } from '../utils/semver.js';
+// Retrieve plugin's pinned major versions by fetching the latest `PluginRun`
+// Only applies to `netlify.toml`-only installed plugins.
+export const addPinnedVersions = async function ({ pluginsOptions, api, siteInfo: { id: siteId }, sendStatus }) {
+    if (!sendStatus || api === undefined || !siteId) {
+        return pluginsOptions;
+    }
+    const packages = pluginsOptions.filter(shouldFetchPinVersion).map(getPackageName);
+    if (packages.length === 0) {
+        return pluginsOptions;
+    }
+    const pluginRuns = await api.getLatestPluginRuns({ site_id: siteId, packages, state: 'success' });
+    const pluginsOptionsA = pluginsOptions.map((pluginOption) => addPinnedVersion(pluginOption, pluginRuns));
+    return pluginsOptionsA;
+};
+const shouldFetchPinVersion = function ({ pinnedVersion, loadedFrom, origin }) {
+    return pinnedVersion === undefined && loadedFrom === 'auto_install' && origin === 'config';
+};
+const getPackageName = function ({ packageName }) {
+    return packageName;
+};
+const addPinnedVersion = function (pluginOptions, pluginRuns) {
+    const foundPluginRun = pluginRuns.find((pluginRun) => pluginRun.package === pluginOptions.packageName);
+    if (foundPluginRun === undefined) {
+        return pluginOptions;
+    }
+    const pinnedVersion = getMajorVersion(foundPluginRun.version);
+    return pinnedVersion === undefined ? pluginOptions : { ...pluginOptions, pinnedVersion };
+};
+// Send an API request to pin plugins' major versions.
+// Only applies to UI-installed plugins.
+export const pinPlugins = async function ({ pluginsOptions, failedPlugins, api, siteInfo: { id: siteId }, childEnv, mode, netlifyConfig, errorMonitor, logs, debug, testOpts, sendStatus, }) {
+    if ((mode !== 'buildbot' && !sendStatus) || api === undefined || !siteId) {
+        return;
+    }
+    const pluginsOptionsA = pluginsOptions.filter((pluginOptions) => shouldPinVersion({ pluginOptions, failedPlugins }));
+    await Promise.all(pluginsOptionsA.map((pluginOptions) => pinPlugin({
+        pluginOptions,
+        api,
+        childEnv,
+        mode,
+        netlifyConfig,
+        errorMonitor,
+        logs,
+        debug,
+        testOpts,
+        siteId,
+    })));
+};
+// Only pin version if:
+//  - the plugin's version has not been pinned yet
+//  - the plugin was installed in the UI
+//  - both the build and the plugin succeeded
+const shouldPinVersion = function ({ pluginOptions: { packageName, pinnedVersion, loadedFrom, origin }, failedPlugins, }) {
+    return (pinnedVersion === undefined &&
+        loadedFrom === 'auto_install' &&
+        origin === 'ui' &&
+        !failedPlugins.includes(packageName));
+};
+const pinPlugin = async function ({ pluginOptions: { packageName, pluginPackageJson: { version }, }, api, childEnv, mode, netlifyConfig, errorMonitor, logs, debug, testOpts, siteId, }) {
+    const pinnedVersion = getMajorVersion(version);
+    try {
+        await api.updatePlugin({
+            package: encodeURIComponent(packageName),
+            site_id: siteId,
+            body: { pinned_version: pinnedVersion },
+        });
+        // Bitballoon API randomly fails with 502.
+        // Builds should be successful when this API call fails, but we still want
+        // to report the error both in logs and in error monitoring.
+    }
+    catch (error) {
+        if (shouldIgnoreError(error)) {
+            return;
+        }
+        await handleBuildError(error, { errorMonitor, netlifyConfig, childEnv, mode, logs, debug, testOpts });
+    }
+};
+// Status is 404 if the plugin is uninstalled while the build is ongoing.
+const shouldIgnoreError = function ({ status }) {
+    return status === 404;
+};