@vercel/build-utils 2.12.3-canary.40 → 2.12.3-canary.44

package/dist/convert-runtime-to-plugin.js

@@ -78,7 +78,6 @@ function convertRuntimeToPlugin(buildRuntime, packageName, ext) {
         // need to be able to easily inspect the output.
         `api-routes-${pluginName}`);
         await fs_extra_1.default.ensureDir(traceDir);
-        let newPathsRuntime = new Set();
         const entryRoot = path_1.join(outputPath, 'server', 'pages');
         for (const entrypoint of Object.keys(entrypoints)) {
             const { output } = await buildRuntime({
@@ -93,13 +92,6 @@ function convertRuntimeToPlugin(buildRuntime, packageName, ext) {
                     skipDownload: true,
                 },
             });
-            // Legacy Runtimes tend to pollute the `workPath` with compiled results,
-            // because the `workPath` used to be a place that was a place where they could
-            // just put anything, but nowadays it's the working directory of the `vercel build`
-            // command, which is the place where the developer keeps their source files,
-            // so we don't want to pollute this space unnecessarily. That means we have to clean
-            // up files that were created by the build, which is done further below.
-            const sourceFilesAfterBuild = await getSourceFiles(workPath, ignoreFilter);
             // @ts-ignore This symbol is a private API
             const lambdaFiles = output[lambda_1.FILES_SYMBOL];
             // When deploying, the `files` that are passed to the Legacy Runtimes already
@@ -134,12 +126,9 @@ function convertRuntimeToPlugin(buildRuntime, packageName, ext) {
             const entryBase = path_1.basename(entrypoint).replace(ext, handlerExtName);
             const entryPath = path_1.join(path_1.dirname(entrypoint), entryBase);
             const entry = path_1.join(entryRoot, entryPath);
-            // We never want to link here, only copy, because the launcher
-            // file often has the same name for every entrypoint, which means that
-            // every build for every entrypoint overwrites the launcher of the previous
-            // one, so linking would end with a broken reference.
+            // Create the parent directory of the API Route that will be created
+            // for the current entrypoint inside of `.output/server/pages/api`.
             await fs_extra_1.default.ensureDir(path_1.dirname(entry));
-            await fs_extra_1.default.copy(handlerFile.fsPath, entry);
             // For compiled languages, the launcher file will be binary and therefore
             // won't try to import a user-provided request handler (instead, it will
             // contain it). But for interpreted languages, the launcher might try to
@@ -156,8 +145,12 @@ function convertRuntimeToPlugin(buildRuntime, packageName, ext) {
                 const locationPrefix = path_1.relative(entry, outputPath);
                 let handlerContent = await fs_extra_1.default.readFile(fsPath, encoding);
                 const importPaths = [
-                    // This is the full entrypoint path, like `./api/test.py`
-                    `./${entrypoint}`,
+                    // This is the full entrypoint path, like `./api/test.py`. In our tests
+                    // Python didn't support importing from a parent directory without using different
+                    // code in the launcher that registers it as a location for modules and then changing
+                    // the importing syntax, but continuing to import it like before seems to work. If
+                    // other languages need this, we should consider excluding Python explicitly.
+                    // `./${entrypoint}`,
                     // This is the entrypoint path without extension, like `api/test`
                     entrypoint.slice(0, -ext.length),
                 ];
@@ -187,52 +180,15 @@ function convertRuntimeToPlugin(buildRuntime, packageName, ext) {
             else {
                 await fs_extra_1.default.copy(handlerFile.fsPath, entry);
             }
-            const newFilesEntrypoint = [];
-            const newDirectoriesEntrypoint = [];
-            const preBuildFiles = Object.values(sourceFilesPreBuild).map(file => {
-                return file.fsPath;
-            });
-            // Generate a list of directories and files that weren't present
-            // before the entrypoint was processed by the Legacy Runtime, so
-            // that we can perform a cleanup later. We need to divide into files
-            // and directories because only cleaning up files might leave empty
-            // directories, and listing directories separately also speeds up the
-            // build because we can just delete them, which wipes all of their nested
-            // paths, instead of iterating through all files that should be deleted.
-            for (const file in sourceFilesAfterBuild) {
-                if (!sourceFilesPreBuild[file]) {
-                    const path = sourceFilesAfterBuild[file].fsPath;
-                    const dirPath = path_1.dirname(path);
-                    // If none of the files that were present before the entrypoint
-                    // was processed are contained within the directory we're looking
-                    // at right now, then we know it's a newly added directory
-                    // and it can therefore be removed later on.
-                    const isNewDir = !preBuildFiles.some(filePath => {
-                        return path_1.dirname(filePath).startsWith(dirPath);
-                    });
-                    // Check out the list of tracked directories that were
-                    // newly added and see if one of them contains the path
-                    // we're looking at.
-                    const hasParentDir = newDirectoriesEntrypoint.some(dir => {
-                        return path.startsWith(dir);
-                    });
-                    // If we have already tracked a directory that was newly
-                    // added that sits above the file or directory that we're
-                    // looking at, we don't need to add more entries to the list
-                    // because when the parent will get removed in the future,
-                    // all of its children (and therefore the path we're looking at)
-                    // will automatically get removed anyways.
-                    if (hasParentDir) {
-                        continue;
-                    }
-                    if (isNewDir) {
-                        newDirectoriesEntrypoint.push(dirPath);
-                    }
-                    else {
-                        newFilesEntrypoint.push(path);
-                    }
-                }
-            }
+            // Legacy Runtimes based on interpreted languages will create a new launcher file
+            // for every entrypoint, but they will create each one inside `workPath`, which means that
+            // the launcher for one entrypoint will overwrite the launcher provided for the previous
+            // entrypoint. That's why, above, we copy the file contents into the new destination (and
+            // optionally transform them along the way), instead of linking. We then also want to remove
+            // the copy origin right here, so that the `workPath` doesn't contain a useless launcher file
+            // once the build has finished running.
+            await fs_extra_1.default.remove(handlerFile.fsPath);
+            _1.debug(`Removed temporary file "${handlerFile.fsPath}"`);
             const nft = `${entry}.nft.json`;
             const json = JSON.stringify({
                 version: 2,
@@ -250,16 +206,7 @@ function convertRuntimeToPlugin(buildRuntime, packageName, ext) {
                 })
                     .filter(Boolean),
             });
-            await fs_extra_1.default.ensureDir(path_1.dirname(nft));
             await fs_extra_1.default.writeFile(nft, json);
-            // Extend the list of directories and files that were created by the
-            // Legacy Runtime with the list of directories and files that were
-            // created for the entrypoint that was just processed above.
-            newPathsRuntime = new Set([
-                ...newPathsRuntime,
-                ...newFilesEntrypoint,
-                ...newDirectoriesEntrypoint,
-            ]);
             // Add an entry that will later on be added to the `functions-manifest.json`
             // file that is placed inside of the `.output` directory.
             pages[normalize_path_1.normalizePath(entryPath)] = {
@@ -275,18 +222,6 @@ function convertRuntimeToPlugin(buildRuntime, packageName, ext) {
                 allowQuery: output.allowQuery,
             };
         }
-        // A list of all the files that were created by the Legacy Runtime,
-        // which we'd like to remove from the File System.
-        const toRemove = Array.from(newPathsRuntime).map(path => {
-            _1.debug(`Removing ${path} as part of cleanup`);
-            return fs_extra_1.default.remove(path);
-        });
-        // Once all the entrypoints have been processed, we'd like to
-        // remove all the files from `workPath` that originally weren't present
-        // before the Legacy Runtime began running, because the `workPath`
-        // is nowadays the directory in which the user keeps their source code, since
-        // we're no longer running separate parallel builds for every Legacy Runtime.
-        await Promise.all(toRemove);
         // Add any Serverless Functions that were exposed by the Legacy Runtime
         // to the `functions-manifest.json` file provided in `.output`.
         await updateFunctionsManifest({ workPath, pages });

package/dist/detect-builders.d.ts

@@ -1,5 +1,5 @@
 import { Route } from '@vercel/routing-utils';
-import { PackageJson, Builder, BuilderFunctions } from './types';
+import { PackageJson, Builder, BuilderFunctions, ProjectSettings } from './types';
 interface ErrorResponse {
     code: string;
     message: string;
@@ -10,14 +10,7 @@ interface Options {
     tag?: 'canary' | 'latest' | string;
     functions?: BuilderFunctions;
     ignoreBuildScript?: boolean;
-    projectSettings?: {
-        framework?: string | null;
-        devCommand?: string | null;
-        installCommand?: string | null;
-        buildCommand?: string | null;
-        outputDirectory?: string | null;
-        createdAt?: number;
-    };
+    projectSettings?: ProjectSettings;
     cleanUrls?: boolean;
     trailingSlash?: boolean;
     featHandleMiss?: boolean;

package/dist/detect-file-system-api.d.ts

@@ -0,0 +1,34 @@
+import type { Builder, BuilderFunctions, PackageJson, ProjectSettings } from './types';
+interface Metadata {
+    plugins: string[];
+    hasDotOutput: boolean;
+    hasMiddleware: boolean;
+}
+/**
+ * If the Deployment can be built with the new File System API,
+ * return the new Builder. Otherwise an "Exclusion Condition"
+ * was hit so return `null` builder with a `reason` for exclusion.
+ */
+export declare function detectFileSystemAPI({ files, projectSettings, builders, vercelConfig, pkg, tag, enableFlag, }: {
+    files: {
+        [relPath: string]: any;
+    };
+    projectSettings: ProjectSettings;
+    builders: Builder[];
+    vercelConfig: {
+        builds?: Builder[];
+        functions?: BuilderFunctions;
+    } | null | undefined;
+    pkg: PackageJson | null | undefined;
+    tag: string | undefined;
+    enableFlag: boolean | undefined;
+}): Promise<{
+    metadata: Metadata;
+    fsApiBuilder: Builder;
+    reason: null;
+} | {
+    metadata: Metadata;
+    fsApiBuilder: null;
+    reason: string;
+}>;
+export {};

package/dist/detect-file-system-api.js

@@ -0,0 +1,173 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectFileSystemAPI = void 0;
+const semver_1 = __importDefault(require("semver"));
+const _1 = require("./");
+const enableFileSystemApiFrameworks = new Set(['solidstart']);
+/**
+ * If the Deployment can be built with the new File System API,
+ * return the new Builder. Otherwise an "Exclusion Condition"
+ * was hit so return `null` builder with a `reason` for exclusion.
+ */
+async function detectFileSystemAPI({ files, projectSettings, builders, vercelConfig, pkg, tag, enableFlag = false, }) {
+    const framework = projectSettings.framework || '';
+    const deps = Object.assign({}, pkg === null || pkg === void 0 ? void 0 : pkg.dependencies, pkg === null || pkg === void 0 ? void 0 : pkg.devDependencies);
+    const plugins = Object.keys(deps).filter(dep => dep.startsWith('vercel-plugin-'));
+    const hasDotOutput = Object.keys(files).some(file => file.startsWith('.output/'));
+    const hasMiddleware = Boolean(files['_middleware.js'] || files['_middleware.ts']);
+    const metadata = {
+        plugins,
+        hasDotOutput,
+        hasMiddleware,
+    };
+    const isEnabled = enableFlag ||
+        hasMiddleware ||
+        hasDotOutput ||
+        enableFileSystemApiFrameworks.has(framework);
+    if (!isEnabled) {
+        return { metadata, fsApiBuilder: null, reason: 'Flag not enabled.' };
+    }
+    if ((vercelConfig === null || vercelConfig === void 0 ? void 0 : vercelConfig.builds) && vercelConfig.builds.length > 0) {
+        return {
+            metadata,
+            fsApiBuilder: null,
+            reason: 'Detected `builds` in vercel.json. Please remove it in favor of CLI plugins.',
+        };
+    }
+    if (Object.values((vercelConfig === null || vercelConfig === void 0 ? void 0 : vercelConfig.functions) || {}).some(fn => !!fn.runtime)) {
+        return {
+            metadata,
+            fsApiBuilder: null,
+            reason: 'Detected `functions.runtime` in vercel.json. Please remove it in favor of CLI plugins.',
+        };
+    }
+    if (process.env.HUGO_VERSION) {
+        return {
+            metadata,
+            fsApiBuilder: null,
+            reason: 'Detected `HUGO_VERSION` environment variable. Please remove it.',
+        };
+    }
+    if (process.env.ZOLA_VERSION) {
+        return {
+            metadata,
+            fsApiBuilder: null,
+            reason: 'Detected `ZOLA_VERSION` environment variable. Please remove it.',
+        };
+    }
+    if (process.env.GUTENBERG_VERSION) {
+        return {
+            metadata,
+            fsApiBuilder: null,
+            reason: 'Detected `GUTENBERG_VERSION` environment variable. Please remove it.',
+        };
+    }
+    const invalidBuilder = builders.find(({ use }) => {
+        const valid = _1.isOfficialRuntime('go', use) ||
+            _1.isOfficialRuntime('python', use) ||
+            _1.isOfficialRuntime('ruby', use) ||
+            _1.isOfficialRuntime('node', use) ||
+            _1.isOfficialRuntime('next', use) ||
+            _1.isOfficialRuntime('static', use) ||
+            _1.isOfficialRuntime('static-build', use);
+        return !valid;
+    });
+    if (invalidBuilder) {
+        return {
+            metadata,
+            fsApiBuilder: null,
+            reason: `Detected \`${invalidBuilder.use}\` in vercel.json. Please remove it in favor of CLI plugins.`,
+        };
+    }
+    for (const lang of ['go', 'python', 'ruby']) {
+        for (const { use } of builders) {
+            const plugin = 'vercel-plugin-' + lang;
+            if (_1.isOfficialRuntime(lang, use) && !deps[plugin]) {
+                return {
+                    metadata,
+                    fsApiBuilder: null,
+                    reason: `Detected \`${lang}\` Serverless Function usage without plugin \`${plugin}\`. Please run \`npm i ${plugin}\`.`,
+                };
+            }
+        }
+    }
+    if (framework === 'nuxtjs' ||
+        framework === 'sveltekit' ||
+        framework === 'redwoodjs') {
+        return {
+            metadata,
+            fsApiBuilder: null,
+            reason: `Detected framework \`${framework}\` that only supports legacy File System API. Please contact the framework author.`,
+        };
+    }
+    if (framework === 'nextjs' && !hasDotOutput) {
+        // Use the old pipeline if a custom output directory was specified for Next.js
+        // because `vercel build` cannot ensure that the directory will be in the same
+        // location as `.output`, which can break imports (not just nft.json files).
+        if (projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.outputDirectory) {
+            return {
+                metadata,
+                fsApiBuilder: null,
+                reason: `Detected Next.js with Output Directory \`${projectSettings.outputDirectory}\` override. Please change it back to the default.`,
+            };
+        }
+        const nextVersion = deps['next'];
+        if (!nextVersion) {
+            return {
+                metadata,
+                fsApiBuilder: null,
+                reason: `Detected Next.js in Project Settings but missing \`next\` package.json dependencies. Please run \`npm i next\`.`,
+            };
+        }
+        // TODO: Read version from lockfile instead of package.json
+        if (nextVersion !== 'latest' && nextVersion !== 'canary') {
+            const fixedVersion = semver_1.default.valid(semver_1.default.coerce(nextVersion) || '');
+            if (!fixedVersion || !semver_1.default.gte(fixedVersion, '12.0.0')) {
+                return {
+                    metadata,
+                    fsApiBuilder: null,
+                    reason: `Detected legacy Next.js version "${nextVersion}" in package.json. Please run \`npm i next@latest\` to upgrade.`,
+                };
+            }
+        }
+    }
+    if (!hasDotOutput) {
+        // TODO: Read version from lockfile instead of package.json
+        const vercelCliVersion = deps['vercel'];
+        if (vercelCliVersion &&
+            vercelCliVersion !== 'latest' &&
+            vercelCliVersion !== 'canary') {
+            const fixedVersion = semver_1.default.valid(semver_1.default.coerce(vercelCliVersion) || '');
+            // TODO: we might want to use '24.0.0' once its released
+            if (!fixedVersion || !semver_1.default.gte(fixedVersion, '23.1.3-canary.68')) {
+                return {
+                    metadata,
+                    fsApiBuilder: null,
+                    reason: `Detected legacy Vercel CLI version "${vercelCliVersion}" in package.json. Please run \`npm i vercel@latest\` to upgrade.`,
+                };
+            }
+        }
+    }
+    const frontendBuilder = builders.find(({ use }) => _1.isOfficialRuntime('next', use) ||
+        _1.isOfficialRuntime('static', use) ||
+        _1.isOfficialRuntime('static-build', use));
+    const config = (frontendBuilder === null || frontendBuilder === void 0 ? void 0 : frontendBuilder.config) || {};
+    const withTag = tag ? `@${tag}` : '';
+    const fsApiBuilder = {
+        use: `@vercelruntimes/file-system-api${withTag}`,
+        src: '**',
+        config: {
+            ...config,
+            fileSystemAPI: true,
+            framework: config.framework || framework || null,
+            projectSettings,
+            hasMiddleware,
+            hasDotOutput,
+        },
+    };
+    return { metadata, fsApiBuilder, reason: null };
+}
+exports.detectFileSystemAPI = detectFileSystemAPI;

package/dist/index.d.ts

@@ -16,6 +16,7 @@ import debug from './debug';
 import getIgnoreFilter from './get-ignore-filter';
 export { FileBlob, FileFsRef, FileRef, Lambda, createLambda, Prerender, download, DownloadedFiles, getWriteableDirectory, glob, GlobOptions, rename, execAsync, spawnAsync, getScriptName, installDependencies, runPackageJsonScript, execCommand, spawnCommand, walkParentDirs, getNodeBinPath, runNpmInstall, runBundleInstall, runPipInstall, runShellScript, getNodeVersion, getLatestNodeVersion, getDiscontinuedNodeVersions, getSpawnOptions, streamToBuffer, shouldServe, debug, isSymbolicLink, getLambdaOptionsFromFunction, scanParentDirs, getIgnoreFilter, };
 export { detectBuilders, detectOutputDirectory, detectApiDirectory, detectApiExtensions, } from './detect-builders';
+export { detectFileSystemAPI } from './detect-file-system-api';
 export { detectFramework } from './detect-framework';
 export { DetectorFilesystem } from './detectors/filesystem';
 export { readConfigFile } from './fs/read-config-file';

package/dist/index.js

@@ -32760,7 +32760,6 @@ function convertRuntimeToPlugin(buildRuntime, packageName, ext) {
         // need to be able to easily inspect the output.
         `api-routes-${pluginName}`);
         await fs_extra_1.default.ensureDir(traceDir);
-        let newPathsRuntime = new Set();
         const entryRoot = path_1.join(outputPath, 'server', 'pages');
         for (const entrypoint of Object.keys(entrypoints)) {
             const { output } = await buildRuntime({
@@ -32775,13 +32774,6 @@ function convertRuntimeToPlugin(buildRuntime, packageName, ext) {
                     skipDownload: true,
                 },
             });
-            // Legacy Runtimes tend to pollute the `workPath` with compiled results,
-            // because the `workPath` used to be a place that was a place where they could
-            // just put anything, but nowadays it's the working directory of the `vercel build`
-            // command, which is the place where the developer keeps their source files,
-            // so we don't want to pollute this space unnecessarily. That means we have to clean
-            // up files that were created by the build, which is done further below.
-            const sourceFilesAfterBuild = await getSourceFiles(workPath, ignoreFilter);
             // @ts-ignore This symbol is a private API
             const lambdaFiles = output[lambda_1.FILES_SYMBOL];
             // When deploying, the `files` that are passed to the Legacy Runtimes already
@@ -32816,12 +32808,9 @@ function convertRuntimeToPlugin(buildRuntime, packageName, ext) {
             const entryBase = path_1.basename(entrypoint).replace(ext, handlerExtName);
             const entryPath = path_1.join(path_1.dirname(entrypoint), entryBase);
             const entry = path_1.join(entryRoot, entryPath);
-            // We never want to link here, only copy, because the launcher
-            // file often has the same name for every entrypoint, which means that
-            // every build for every entrypoint overwrites the launcher of the previous
-            // one, so linking would end with a broken reference.
+            // Create the parent directory of the API Route that will be created
+            // for the current entrypoint inside of `.output/server/pages/api`.
             await fs_extra_1.default.ensureDir(path_1.dirname(entry));
-            await fs_extra_1.default.copy(handlerFile.fsPath, entry);
             // For compiled languages, the launcher file will be binary and therefore
             // won't try to import a user-provided request handler (instead, it will
             // contain it). But for interpreted languages, the launcher might try to
@@ -32838,8 +32827,12 @@ function convertRuntimeToPlugin(buildRuntime, packageName, ext) {
                 const locationPrefix = path_1.relative(entry, outputPath);
                 let handlerContent = await fs_extra_1.default.readFile(fsPath, encoding);
                 const importPaths = [
-                    // This is the full entrypoint path, like `./api/test.py`
-                    `./${entrypoint}`,
+                    // This is the full entrypoint path, like `./api/test.py`. In our tests
+                    // Python didn't support importing from a parent directory without using different
+                    // code in the launcher that registers it as a location for modules and then changing
+                    // the importing syntax, but continuing to import it like before seems to work. If
+                    // other languages need this, we should consider excluding Python explicitly.
+                    // `./${entrypoint}`,
                     // This is the entrypoint path without extension, like `api/test`
                     entrypoint.slice(0, -ext.length),
                 ];
@@ -32869,52 +32862,15 @@ function convertRuntimeToPlugin(buildRuntime, packageName, ext) {
             else {
                 await fs_extra_1.default.copy(handlerFile.fsPath, entry);
             }
-            const newFilesEntrypoint = [];
-            const newDirectoriesEntrypoint = [];
-            const preBuildFiles = Object.values(sourceFilesPreBuild).map(file => {
-                return file.fsPath;
-            });
-            // Generate a list of directories and files that weren't present
-            // before the entrypoint was processed by the Legacy Runtime, so
-            // that we can perform a cleanup later. We need to divide into files
-            // and directories because only cleaning up files might leave empty
-            // directories, and listing directories separately also speeds up the
-            // build because we can just delete them, which wipes all of their nested
-            // paths, instead of iterating through all files that should be deleted.
-            for (const file in sourceFilesAfterBuild) {
-                if (!sourceFilesPreBuild[file]) {
-                    const path = sourceFilesAfterBuild[file].fsPath;
-                    const dirPath = path_1.dirname(path);
-                    // If none of the files that were present before the entrypoint
-                    // was processed are contained within the directory we're looking
-                    // at right now, then we know it's a newly added directory
-                    // and it can therefore be removed later on.
-                    const isNewDir = !preBuildFiles.some(filePath => {
-                        return path_1.dirname(filePath).startsWith(dirPath);
-                    });
-                    // Check out the list of tracked directories that were
-                    // newly added and see if one of them contains the path
-                    // we're looking at.
-                    const hasParentDir = newDirectoriesEntrypoint.some(dir => {
-                        return path.startsWith(dir);
-                    });
-                    // If we have already tracked a directory that was newly
-                    // added that sits above the file or directory that we're
-                    // looking at, we don't need to add more entries to the list
-                    // because when the parent will get removed in the future,
-                    // all of its children (and therefore the path we're looking at)
-                    // will automatically get removed anyways.
-                    if (hasParentDir) {
-                        continue;
-                    }
-                    if (isNewDir) {
-                        newDirectoriesEntrypoint.push(dirPath);
-                    }
-                    else {
-                        newFilesEntrypoint.push(path);
-                    }
-                }
-            }
+            // Legacy Runtimes based on interpreted languages will create a new launcher file
+            // for every entrypoint, but they will create each one inside `workPath`, which means that
+            // the launcher for one entrypoint will overwrite the launcher provided for the previous
+            // entrypoint. That's why, above, we copy the file contents into the new destination (and
+            // optionally transform them along the way), instead of linking. We then also want to remove
+            // the copy origin right here, so that the `workPath` doesn't contain a useless launcher file
+            // once the build has finished running.
+            await fs_extra_1.default.remove(handlerFile.fsPath);
+            _1.debug(`Removed temporary file "${handlerFile.fsPath}"`);
             const nft = `${entry}.nft.json`;
             const json = JSON.stringify({
                 version: 2,
@@ -32932,16 +32888,7 @@ function convertRuntimeToPlugin(buildRuntime, packageName, ext) {
                 })
                     .filter(Boolean),
             });
-            await fs_extra_1.default.ensureDir(path_1.dirname(nft));
             await fs_extra_1.default.writeFile(nft, json);
-            // Extend the list of directories and files that were created by the
-            // Legacy Runtime with the list of directories and files that were
-            // created for the entrypoint that was just processed above.
-            newPathsRuntime = new Set([
-                ...newPathsRuntime,
-                ...newFilesEntrypoint,
-                ...newDirectoriesEntrypoint,
-            ]);
             // Add an entry that will later on be added to the `functions-manifest.json`
             // file that is placed inside of the `.output` directory.
             pages[normalize_path_1.normalizePath(entryPath)] = {
@@ -32957,18 +32904,6 @@ function convertRuntimeToPlugin(buildRuntime, packageName, ext) {
                 allowQuery: output.allowQuery,
             };
         }
-        // A list of all the files that were created by the Legacy Runtime,
-        // which we'd like to remove from the File System.
-        const toRemove = Array.from(newPathsRuntime).map(path => {
-            _1.debug(`Removing ${path} as part of cleanup`);
-            return fs_extra_1.default.remove(path);
-        });
-        // Once all the entrypoints have been processed, we'd like to
-        // remove all the files from `workPath` that originally weren't present
-        // before the Legacy Runtime began running, because the `workPath`
-        // is nowadays the directory in which the user keeps their source code, since
-        // we're no longer running separate parallel builds for every Legacy Runtime.
-        await Promise.all(toRemove);
         // Add any Serverless Functions that were exposed by the Legacy Runtime
         // to the `functions-manifest.json` file provided in `.output`.
         await updateFunctionsManifest({ workPath, pages });
@@ -33904,6 +33839,187 @@ function sortFilesBySegmentCount(fileA, fileB) {
 }
 
 
+/***/ }),
+
+/***/ 1182:
+/***/ (function(__unused_webpack_module, exports, __webpack_require__) {
+
+"use strict";
+
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.detectFileSystemAPI = void 0;
+const semver_1 = __importDefault(__webpack_require__(2879));
+const _1 = __webpack_require__(2855);
+const enableFileSystemApiFrameworks = new Set(['solidstart']);
+/**
+ * If the Deployment can be built with the new File System API,
+ * return the new Builder. Otherwise an "Exclusion Condition"
+ * was hit so return `null` builder with a `reason` for exclusion.
+ */
+async function detectFileSystemAPI({ files, projectSettings, builders, vercelConfig, pkg, tag, enableFlag = false, }) {
+    const framework = projectSettings.framework || '';
+    const deps = Object.assign({}, pkg === null || pkg === void 0 ? void 0 : pkg.dependencies, pkg === null || pkg === void 0 ? void 0 : pkg.devDependencies);
+    const plugins = Object.keys(deps).filter(dep => dep.startsWith('vercel-plugin-'));
+    const hasDotOutput = Object.keys(files).some(file => file.startsWith('.output/'));
+    const hasMiddleware = Boolean(files['_middleware.js'] || files['_middleware.ts']);
+    const metadata = {
+        plugins,
+        hasDotOutput,
+        hasMiddleware,
+    };
+    const isEnabled = enableFlag ||
+        hasMiddleware ||
+        hasDotOutput ||
+        enableFileSystemApiFrameworks.has(framework);
+    if (!isEnabled) {
+        return { metadata, fsApiBuilder: null, reason: 'Flag not enabled.' };
+    }
+    if ((vercelConfig === null || vercelConfig === void 0 ? void 0 : vercelConfig.builds) && vercelConfig.builds.length > 0) {
+        return {
+            metadata,
+            fsApiBuilder: null,
+            reason: 'Detected `builds` in vercel.json. Please remove it in favor of CLI plugins.',
+        };
+    }
+    if (Object.values((vercelConfig === null || vercelConfig === void 0 ? void 0 : vercelConfig.functions) || {}).some(fn => !!fn.runtime)) {
+        return {
+            metadata,
+            fsApiBuilder: null,
+            reason: 'Detected `functions.runtime` in vercel.json. Please remove it in favor of CLI plugins.',
+        };
+    }
+    if (process.env.HUGO_VERSION) {
+        return {
+            metadata,
+            fsApiBuilder: null,
+            reason: 'Detected `HUGO_VERSION` environment variable. Please remove it.',
+        };
+    }
+    if (process.env.ZOLA_VERSION) {
+        return {
+            metadata,
+            fsApiBuilder: null,
+            reason: 'Detected `ZOLA_VERSION` environment variable. Please remove it.',
+        };
+    }
+    if (process.env.GUTENBERG_VERSION) {
+        return {
+            metadata,
+            fsApiBuilder: null,
+            reason: 'Detected `GUTENBERG_VERSION` environment variable. Please remove it.',
+        };
+    }
+    const invalidBuilder = builders.find(({ use }) => {
+        const valid = _1.isOfficialRuntime('go', use) ||
+            _1.isOfficialRuntime('python', use) ||
+            _1.isOfficialRuntime('ruby', use) ||
+            _1.isOfficialRuntime('node', use) ||
+            _1.isOfficialRuntime('next', use) ||
+            _1.isOfficialRuntime('static', use) ||
+            _1.isOfficialRuntime('static-build', use);
+        return !valid;
+    });
+    if (invalidBuilder) {
+        return {
+            metadata,
+            fsApiBuilder: null,
+            reason: `Detected \`${invalidBuilder.use}\` in vercel.json. Please remove it in favor of CLI plugins.`,
+        };
+    }
+    for (const lang of ['go', 'python', 'ruby']) {
+        for (const { use } of builders) {
+            const plugin = 'vercel-plugin-' + lang;
+            if (_1.isOfficialRuntime(lang, use) && !deps[plugin]) {
+                return {
+                    metadata,
+                    fsApiBuilder: null,
+                    reason: `Detected \`${lang}\` Serverless Function usage without plugin \`${plugin}\`. Please run \`npm i ${plugin}\`.`,
+                };
+            }
+        }
+    }
+    if (framework === 'nuxtjs' ||
+        framework === 'sveltekit' ||
+        framework === 'redwoodjs') {
+        return {
+            metadata,
+            fsApiBuilder: null,
+            reason: `Detected framework \`${framework}\` that only supports legacy File System API. Please contact the framework author.`,
+        };
+    }
+    if (framework === 'nextjs' && !hasDotOutput) {
+        // Use the old pipeline if a custom output directory was specified for Next.js
+        // because `vercel build` cannot ensure that the directory will be in the same
+        // location as `.output`, which can break imports (not just nft.json files).
+        if (projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.outputDirectory) {
+            return {
+                metadata,
+                fsApiBuilder: null,
+                reason: `Detected Next.js with Output Directory \`${projectSettings.outputDirectory}\` override. Please change it back to the default.`,
+            };
+        }
+        const nextVersion = deps['next'];
+        if (!nextVersion) {
+            return {
+                metadata,
+                fsApiBuilder: null,
+                reason: `Detected Next.js in Project Settings but missing \`next\` package.json dependencies. Please run \`npm i next\`.`,
+            };
+        }
+        // TODO: Read version from lockfile instead of package.json
+        if (nextVersion !== 'latest' && nextVersion !== 'canary') {
+            const fixedVersion = semver_1.default.valid(semver_1.default.coerce(nextVersion) || '');
+            if (!fixedVersion || !semver_1.default.gte(fixedVersion, '12.0.0')) {
+                return {
+                    metadata,
+                    fsApiBuilder: null,
+                    reason: `Detected legacy Next.js version "${nextVersion}" in package.json. Please run \`npm i next@latest\` to upgrade.`,
+                };
+            }
+        }
+    }
+    if (!hasDotOutput) {
+        // TODO: Read version from lockfile instead of package.json
+        const vercelCliVersion = deps['vercel'];
+        if (vercelCliVersion &&
+            vercelCliVersion !== 'latest' &&
+            vercelCliVersion !== 'canary') {
+            const fixedVersion = semver_1.default.valid(semver_1.default.coerce(vercelCliVersion) || '');
+            // TODO: we might want to use '24.0.0' once its released
+            if (!fixedVersion || !semver_1.default.gte(fixedVersion, '23.1.3-canary.68')) {
+                return {
+                    metadata,
+                    fsApiBuilder: null,
+                    reason: `Detected legacy Vercel CLI version "${vercelCliVersion}" in package.json. Please run \`npm i vercel@latest\` to upgrade.`,
+                };
+            }
+        }
+    }
+    const frontendBuilder = builders.find(({ use }) => _1.isOfficialRuntime('next', use) ||
+        _1.isOfficialRuntime('static', use) ||
+        _1.isOfficialRuntime('static-build', use));
+    const config = (frontendBuilder === null || frontendBuilder === void 0 ? void 0 : frontendBuilder.config) || {};
+    const withTag = tag ? `@${tag}` : '';
+    const fsApiBuilder = {
+        use: `@vercelruntimes/file-system-api${withTag}`,
+        src: '**',
+        config: {
+            ...config,
+            fileSystemAPI: true,
+            framework: config.framework || framework || null,
+            projectSettings,
+            hasMiddleware,
+            hasDotOutput,
+        },
+    };
+    return { metadata, fsApiBuilder, reason: null };
+}
+exports.detectFileSystemAPI = detectFileSystemAPI;
+
+
 /***/ }),
 
 /***/ 5224:
@@ -35135,7 +35251,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.getInputHash = exports.getPlatformEnv = exports.isStaticRuntime = exports.isOfficialRuntime = exports.updateRoutesManifest = exports.updateFunctionsManifest = exports.convertRuntimeToPlugin = exports.normalizePath = exports.readConfigFile = exports.DetectorFilesystem = exports.detectFramework = exports.detectApiExtensions = exports.detectApiDirectory = exports.detectOutputDirectory = exports.detectBuilders = exports.getIgnoreFilter = exports.scanParentDirs = exports.getLambdaOptionsFromFunction = exports.isSymbolicLink = exports.debug = exports.shouldServe = exports.streamToBuffer = exports.getSpawnOptions = exports.getDiscontinuedNodeVersions = exports.getLatestNodeVersion = exports.getNodeVersion = exports.runShellScript = exports.runPipInstall = exports.runBundleInstall = exports.runNpmInstall = exports.getNodeBinPath = exports.walkParentDirs = exports.spawnCommand = exports.execCommand = exports.runPackageJsonScript = exports.installDependencies = exports.getScriptName = exports.spawnAsync = exports.execAsync = exports.rename = exports.glob = exports.getWriteableDirectory = exports.download = exports.Prerender = exports.createLambda = exports.Lambda = exports.FileRef = exports.FileFsRef = exports.FileBlob = void 0;
+exports.getInputHash = exports.getPlatformEnv = exports.isStaticRuntime = exports.isOfficialRuntime = exports.updateRoutesManifest = exports.updateFunctionsManifest = exports.convertRuntimeToPlugin = exports.normalizePath = exports.readConfigFile = exports.DetectorFilesystem = exports.detectFramework = exports.detectFileSystemAPI = exports.detectApiExtensions = exports.detectApiDirectory = exports.detectOutputDirectory = exports.detectBuilders = exports.getIgnoreFilter = exports.scanParentDirs = exports.getLambdaOptionsFromFunction = exports.isSymbolicLink = exports.debug = exports.shouldServe = exports.streamToBuffer = exports.getSpawnOptions = exports.getDiscontinuedNodeVersions = exports.getLatestNodeVersion = exports.getNodeVersion = exports.runShellScript = exports.runPipInstall = exports.runBundleInstall = exports.runNpmInstall = exports.getNodeBinPath = exports.walkParentDirs = exports.spawnCommand = exports.execCommand = exports.runPackageJsonScript = exports.installDependencies = exports.getScriptName = exports.spawnAsync = exports.execAsync = exports.rename = exports.glob = exports.getWriteableDirectory = exports.download = exports.Prerender = exports.createLambda = exports.Lambda = exports.FileRef = exports.FileFsRef = exports.FileBlob = void 0;
 const crypto_1 = __webpack_require__(6417);
 const file_blob_1 = __importDefault(__webpack_require__(2397));
 exports.FileBlob = file_blob_1.default;
@@ -35192,6 +35308,8 @@ Object.defineProperty(exports, "detectBuilders", ({ enumerable: true, get: funct
 Object.defineProperty(exports, "detectOutputDirectory", ({ enumerable: true, get: function () { return detect_builders_1.detectOutputDirectory; } }));
 Object.defineProperty(exports, "detectApiDirectory", ({ enumerable: true, get: function () { return detect_builders_1.detectApiDirectory; } }));
 Object.defineProperty(exports, "detectApiExtensions", ({ enumerable: true, get: function () { return detect_builders_1.detectApiExtensions; } }));
+var detect_file_system_api_1 = __webpack_require__(1182);
+Object.defineProperty(exports, "detectFileSystemAPI", ({ enumerable: true, get: function () { return detect_file_system_api_1.detectFileSystemAPI; } }));
 var detect_framework_1 = __webpack_require__(5224);
 Object.defineProperty(exports, "detectFramework", ({ enumerable: true, get: function () { return detect_framework_1.detectFramework; } }));
 var filesystem_1 = __webpack_require__(461);

package/dist/types.d.ts

@@ -21,7 +21,7 @@ export interface Files {
 export interface Config {
     [key: string]: string | string[] | boolean | number | {
         [key: string]: string;
-    } | BuilderFunctions | undefined;
+    } | BuilderFunctions | ProjectSettings | undefined | null;
     maxLambdaSize?: string;
     includeFiles?: string | string[];
     excludeFiles?: string | string[];
@@ -35,11 +35,12 @@ export interface Config {
         [key: string]: string;
     };
     functions?: BuilderFunctions;
+    projectSettings?: ProjectSettings;
     outputDirectory?: string;
     installCommand?: string;
     buildCommand?: string;
     devCommand?: string;
-    framework?: string;
+    framework?: string | null;
     nodeVersion?: string;
 }
 export interface Meta {
@@ -305,3 +306,16 @@ export interface BuilderFunctions {
         excludeFiles?: string;
     };
 }
+export interface ProjectSettings {
+    framework?: string | null;
+    devCommand?: string | null;
+    installCommand?: string | null;
+    buildCommand?: string | null;
+    outputDirectory?: string | null;
+    rootDirectory?: string | null;
+    createdAt?: number;
+    autoExposeSystemEnvs?: boolean;
+    sourceFilesOutsideRootDirectory?: boolean;
+    directoryListing?: boolean;
+    gitForkProtection?: boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/build-utils",
-  "version": "2.12.3-canary.40",
+  "version": "2.12.3-canary.44",
   "license": "MIT",
   "main": "./dist/index.js",
   "types": "./dist/index.d.js",
@@ -49,5 +49,5 @@
     "typescript": "4.3.4",
     "yazl": "2.4.3"
   },
-  "gitHead": "d31ebbabe4d9533d0e98137d76eb319b01ac8b13"
+  "gitHead": "ecb44812263a03803157ad258c2f0f3cd0fc83ef"
 }