@netlify/build 29.30.0 → 29.31.1

package/lib/types/netlify_plugin_options.d.ts

@@ -0,0 +1,24 @@
+import type { NetlifyPluginConstants } from '../core/constants.js';
+import type { PluginInputs, StringKeys } from './config/inputs.js';
+import type { NetlifyConfig } from './config/netlify_config.js';
+import type { NetlifyPluginUtils } from './options/netlify_plugin_utils.js';
+import type { JSONValue } from './utils/json_value.js';
+export interface NetlifyPluginOptions<TInputs extends PluginInputs<StringKeys<TInputs>> = PluginInputs> {
+    /**
+     * If your plugin requires additional values from the user, you can specify these requirements in an `inputs` array in the plugin’s [`manifest.yml` file](https://docs.netlify.com/configure-builds/build-plugins/create-plugins/#anatomy-of-a-plugin).
+     */
+    inputs: TInputs;
+    /**
+     * @see https://docs.netlify.com/configure-builds/build-plugins/create-plugins/#netlifyconfig
+     */
+    netlifyConfig: NetlifyConfig;
+    /**
+     * When an event handler executes, the contents of the `package.json` in a site's base directory get passed to a plugin.
+     * The data fields are normalized to prevent plugin errors. If the site has no `package.json`, the argument is an empty object.
+     */
+    packageJson: Partial<Record<string, JSONValue>>;
+    constants: NetlifyPluginConstants;
+    utils: NetlifyPluginUtils;
+    featureFlags?: Record<string, unknown>;
+    systemLog?(message: string): void;
+}

package/lib/types/netlify_plugin_options.js

@@ -0,0 +1 @@
+export {};

package/lib/types/options/netlify_plugin_build_util.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Report errors or cancel builds
+ */
+export type NetlifyPluginBuildUtil = Record<'failBuild' | 'failPlugin' | 'cancelBuild', (message: string, options?: {
+    error?: Error;
+}) => never>;

package/lib/types/options/netlify_plugin_build_util.js

@@ -0,0 +1 @@
+export {};

package/lib/types/options/netlify_plugin_cache_util.d.ts

@@ -0,0 +1,29 @@
+import type { Many } from '../utils/many.js';
+/**
+ * Cache files between builds
+ */
+export type NetlifyPluginCacheUtil = {
+    save(path: Many<string>, options?: {
+        ttl?: number;
+        digests?: string[];
+        /**
+         * @default `process.cwd()`
+         */
+        cwd?: string;
+    }): Promise<boolean>;
+    list(options?: {
+        /**
+         * @default `process.cwd()`
+         */
+        cwd?: string;
+        /**
+         * @default 1
+         */
+        depth?: number;
+    }): Promise<string[]>;
+} & Record<'restore' | 'remove' | 'has', (path: Many<string>, options?: {
+    /**
+     * @default `process.cwd()`
+     */
+    cwd?: string;
+}) => Promise<boolean>>;

package/lib/types/options/netlify_plugin_cache_util.js

@@ -0,0 +1 @@
+export {};

package/lib/types/options/netlify_plugin_functions_util.d.ts

@@ -0,0 +1,28 @@
+import type { listFunctions, listFunctionsFiles } from '@netlify/zip-it-and-ship-it';
+type Resolved<T> = T extends Promise<infer U> ? U : T;
+export type ListedFunction = Resolved<ReturnType<typeof listFunctions>>[0];
+export type ListedFunctionFile = Resolved<ReturnType<typeof listFunctionsFiles>>[0];
+export interface NetlifyPluginFunctionsUtil {
+    /**
+     * Returns the list of Netlify Functions main files as a Promise resolving to an array of objects with the following properties:
+     *
+     * - `name`: Function name, as used in the URL `https://{hostname}/.netlify/functions/{name}`
+     * - `mainFile`: absolute path to the Function's main file
+     * - `extension`: file extension of the Function's main file. For Go Functions, this might be an empty string.  For Node.js Functions, this is either `.js` or `.zip`.
+     * - `runtime` `"js" | "go"`: Function's language runtime. TypeScript Functions use the "js" runtime
+     */
+    list(): Promise<Array<ListedFunction>>;
+    /**
+     * Same as `list()` except it also returns the files required by the Functions' main files. This is much slower. The object have the following additional member:
+     *
+     * - `srcFile`: absolute path to the file
+     */
+    listAll(): Promise<Array<ListedFunctionFile>>;
+    /**
+     * Add a Functions file or directory to a build.
+     *
+     * @param path Path to the function file or directory.
+     */
+    add(path: string): Promise<void>;
+}
+export {};

package/lib/types/options/netlify_plugin_functions_util.js

@@ -0,0 +1 @@
+export {};

package/lib/types/options/netlify_plugin_git_util.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Retrieve Git-related information such as the list of modified/created/deleted files
+ * @see https://github.com/netlify/build/blob/master/packages/git-utils/README.md
+ */
+export interface NetlifyPluginGitUtil {
+    fileMatch(globPattern: string): readonly string[];
+    /**
+     * Array of all modified files.
+     */
+    modifiedFiles: readonly string[];
+    /**
+     * Array of all created files.
+     */
+    createdFiles: readonly string[];
+    /**
+     * Array of all deleted files.
+     */
+    deletedFiles: readonly string[];
+    /**
+     * Array of commits with details.
+     */
+    commits: ReadonlyArray<{
+        sha: string;
+        parents: string;
+        author: {
+            name: string;
+            email: string;
+            date: string;
+        };
+        committer: {
+            name: string;
+            email: string;
+            date: string;
+        };
+        message: string;
+    }>;
+    /**
+     * How many lines of code have changed
+     */
+    linesOfCode(): Promise<number>;
+}

package/lib/types/options/netlify_plugin_git_util.js

@@ -0,0 +1 @@
+export {};

package/lib/types/options/netlify_plugin_run_util.d.ts

@@ -0,0 +1,17 @@
+import type { Options as ExecaOptions, ExecaChildProcess } from 'execa';
+type NetlifyPluginRunUtilOptions = Omit<ExecaOptions, 'preferLocal'> & {
+    /**
+     * @default true
+     */
+    preferLocal?: ExecaOptions['preferLocal'];
+};
+type NetlifyPluginRunUtilResult = ExecaChildProcess;
+/**
+ * Run commands and processes
+ * @see https://github.com/netlify/build/blob/master/packages/run-utils/README.md
+ */
+export interface NetlifyPluginRunUtil {
+    (file: string, args?: readonly string[], options?: NetlifyPluginRunUtilOptions): Promise<NetlifyPluginRunUtilResult>;
+    command(command: string, options?: NetlifyPluginRunUtilOptions): Promise<NetlifyPluginRunUtilResult>;
+}
+export {};

package/lib/types/options/netlify_plugin_run_util.js

@@ -0,0 +1 @@
+export {};

package/lib/types/options/netlify_plugin_status_util.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Display information in the deploy summary
+ */
+export interface NetlifyPluginStatusUtil {
+    /**
+     * Only one status is shown per plugin.
+     * Calling `utils.status.show()` twice overrides the previous status.
+     */
+    show(options: {
+        /**
+         * Default to the plugin's name followed by a generic title.
+         */
+        title?: string;
+        /**
+         * Message below the title
+         */
+        summary: string;
+        /**
+         * Detailed information shown in a collapsible section.
+         * @default ""
+         */
+        text?: string;
+    }): void;
+}

package/lib/types/options/netlify_plugin_status_util.js

@@ -0,0 +1 @@
+export {};

package/{types → lib/types}/options/netlify_plugin_utils.d.ts

@@ -1,15 +1,14 @@
-import type { NetlifyPluginBuildUtil } from './netlify_plugin_build_util.js'
-import type { NetlifyPluginCacheUtil } from './netlify_plugin_cache_util.js'
-import type { NetlifyPluginFunctionsUtil } from './netlify_plugin_functions_util.js'
-import type { NetlifyPluginGitUtil } from './netlify_plugin_git_util.js'
-import type { NetlifyPluginRunUtil } from './netlify_plugin_run_util.js'
-import type { NetlifyPluginStatusUtil } from './netlify_plugin_status_util.js'
-
+import type { NetlifyPluginBuildUtil } from './netlify_plugin_build_util.js';
+import type { NetlifyPluginCacheUtil } from './netlify_plugin_cache_util.js';
+import type { NetlifyPluginFunctionsUtil } from './netlify_plugin_functions_util.js';
+import type { NetlifyPluginGitUtil } from './netlify_plugin_git_util.js';
+import type { NetlifyPluginRunUtil } from './netlify_plugin_run_util.js';
+import type { NetlifyPluginStatusUtil } from './netlify_plugin_status_util.js';
 export interface NetlifyPluginUtils {
-  build: NetlifyPluginBuildUtil
-  status: NetlifyPluginStatusUtil
-  cache: NetlifyPluginCacheUtil
-  run: NetlifyPluginRunUtil
-  git: NetlifyPluginGitUtil
-  functions: NetlifyPluginFunctionsUtil
+    build: NetlifyPluginBuildUtil;
+    status: NetlifyPluginStatusUtil;
+    cache: NetlifyPluginCacheUtil;
+    run: NetlifyPluginRunUtil;
+    git: NetlifyPluginGitUtil;
+    functions: NetlifyPluginFunctionsUtil;
 }

package/lib/types/options/netlify_plugin_utils.js

@@ -0,0 +1 @@
+export {};

package/lib/types/utils/json_value.d.ts

@@ -0,0 +1,3 @@
+export type JSONValue = string | number | boolean | null | {
+    [key: string]: JSONValue;
+} | Array<JSONValue>;

package/lib/types/utils/json_value.js

@@ -0,0 +1 @@
+export {};

package/{types → lib/types}/utils/many.d.ts

@@ -1,6 +1,6 @@
 type ArrayByMode<T, Mode extends 'immutable' | 'mutable' = 'immutable'> = {
-  immutable: readonly T[]
-  mutable: T[]
-}[Mode]
-
-export type Many<T, Mode extends 'immutable' | 'mutable' = 'immutable'> = T | ArrayByMode<T, Mode>
+    immutable: readonly T[];
+    mutable: T[];
+}[Mode];
+export type Many<T, Mode extends 'immutable' | 'mutable' = 'immutable'> = T | ArrayByMode<T, Mode>;
+export {};

package/lib/types/utils/many.js

@@ -0,0 +1 @@
+export {};

package/lib/utils/blobs.d.ts

@@ -1,8 +1,9 @@
-export declare const getBlobsDir: ({ buildDir, publishDir }: {
-    buildDir: any;
-    publishDir: any;
-}) => string;
-export declare const anyBlobsToUpload: ({ buildDir, publishDir }: {
-    buildDir: any;
-    publishDir: any;
-}) => Promise<boolean>;
+/** Retrieve the absolute path of the deploy scoped internal blob directory */
+export declare const getBlobsDir: (buildDir: string, packagePath?: string) => string;
+/**
+ * Detect if there are any blobs to upload
+ * @param buildDir The build directory. (current working directory where the build is executed)
+ * @param packagePath An optional package path for mono repositories
+ * @returns
+ */
+export declare const anyBlobsToUpload: (buildDir: string, packagePath?: string) => Promise<boolean>;

package/lib/utils/blobs.js

@@ -1,11 +1,16 @@
-import path from 'node:path';
+import { resolve } from 'node:path';
 import { fdir } from 'fdir';
 const BLOBS_PATH = '.netlify/blobs/deploy';
-export const getBlobsDir = function ({ buildDir, publishDir }) {
-    return path.resolve(buildDir, publishDir, BLOBS_PATH);
-};
-export const anyBlobsToUpload = async function ({ buildDir, publishDir }) {
-    const blobsDir = getBlobsDir({ buildDir, publishDir });
+/** Retrieve the absolute path of the deploy scoped internal blob directory */
+export const getBlobsDir = (buildDir, packagePath) => resolve(buildDir, packagePath || '', BLOBS_PATH);
+/**
+ * Detect if there are any blobs to upload
+ * @param buildDir The build directory. (current working directory where the build is executed)
+ * @param packagePath An optional package path for mono repositories
+ * @returns
+ */
+export const anyBlobsToUpload = async function (buildDir, packagePath) {
+    const blobsDir = getBlobsDir(buildDir, packagePath);
     const { files } = await new fdir().onlyCounts().crawl(blobsDir).withPromise();
     return files > 0;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@netlify/build",
-  "version": "29.30.0",
+  "version": "29.31.1",
   "description": "Netlify build module",
   "type": "module",
   "exports": "./lib/index.js",
@@ -71,11 +71,11 @@
     "@netlify/config": "^20.10.0",
     "@netlify/edge-bundler": "10.1.3",
     "@netlify/framework-info": "^9.8.10",
-    "@netlify/functions-utils": "^5.2.45",
+    "@netlify/functions-utils": "^5.2.46",
     "@netlify/git-utils": "^5.1.1",
-    "@netlify/plugins-list": "^6.72.0",
+    "@netlify/plugins-list": "^6.73.0",
     "@netlify/run-utils": "^5.1.1",
-    "@netlify/zip-it-and-ship-it": "9.28.1",
+    "@netlify/zip-it-and-ship-it": "9.28.2",
     "@opentelemetry/api": "^1.4.1",
     "@opentelemetry/core": "^1.17.1",
     "@sindresorhus/slugify": "^2.0.0",
@@ -157,5 +157,5 @@
   "engines": {
     "node": "^14.16.0 || >=16.0.0"
   },
-  "gitHead": "b32d2b2d81b062d5021fa0c91d831b23353a5b1d"
+  "gitHead": "efc258f3a0669d69d47b989e4d8154b18d60af35"
 }

package/types/config/build.d.ts

@@ -1,52 +0,0 @@
-/* eslint-disable camelcase -- some properties are named in snake case in this API */
-
-export interface Build {
-  /**
-   * Includes a site's [build command](https://docs.netlify.com/configure-builds/get-started/#definitions)
-   */
-  command?: string
-
-  /**
-   * the path to your static content folder
-   */
-  publish: string
-  base: string
-  services: Record<string, unknown>
-
-  /**
-   * Allows specifying a Bash command that will be run from the base directory to determine whether the site needs rebuilding or not.
-   * Check out our [ignore builds](https://docs.netlify.com/configure-builds/common-configurations/ignore-builds/) doc for more information on the default ignore behavior and details about constructing a custom ignore command.
-   */
-  ignore?: string
-
-  /**
-   * Includes the path to a site's [Edge Handlers directory](https://docs.netlify.com/edge-handlers/configure-and-build/#choose-an-edge-handlers-directory)
-   */
-  edge_handlers?: string
-  /**
-   * Contains a site's [environment variables](https://docs.netlify.com/configure-builds/environment-variables/#netlify-configuration-variables)
-   */
-  environment: Partial<Record<string, string>>
-  /**
-   * Includes options for [post processing](https://docs.netlify.com/configure-builds/file-based-configuration/#post-processing) HTML, CSS, JavaScript, and images
-   */
-  processing: {
-    skip_processing?: boolean
-    css: {
-      bundle?: boolean
-      minify?: boolean
-    }
-    js: {
-      bundle?: boolean
-      minify?: boolean
-    }
-    html: {
-      pretty_url?: boolean
-    }
-    images: {
-      compress?: boolean
-    }
-  }
-}
-
-/* eslint-enable camelcase */

package/types/config/functions.d.ts

@@ -1,36 +0,0 @@
-type GlobPattern = string
-
-/* eslint-disable camelcase -- some properties are named in snake case in this API */
-type FunctionsObject = {
-  /**
-   * a list of additional paths to include in the function bundle. Although our build system includes statically referenced files (like `import * from "./some-file.js"`) by default, `included_files` lets you specify additional files or directories and reference them dynamically in function code. You can use `*` to match any character or prefix an entry with `!` to exclude files. Paths are relative to the [base directory](https://docs.netlify.com/configure-builds/get-started/#definitions-1).
-   */
-  included_files?: string[]
-} & (
-  | {
-      /**
-       * the function bundling method used in [`@netlify/zip-it-and-ship-it`](https://github.com/netlify/zip-it-and-ship-it).
-       */
-      node_bundler?: 'zisi' | 'nft'
-    }
-  | {
-      /**
-       * the function bundling method used in [`@netlify/zip-it-and-ship-it`](https://github.com/netlify/zip-it-and-ship-it).
-       */
-      node_bundler?: 'esbuild' | 'none'
-
-      /**
-       * a list of Node.js modules that are copied to the bundled artifact without adjusting their source or references during the bundling process.
-       * This property helps handle dependencies that can’t be inlined, such as modules with native add-ons.
-       */
-      external_node_modules?: string[]
-
-      ignored_node_modules?: string[]
-    }
-)
-/* eslint-enable camelcase */
-
-export type Functions = {
-  '*': FunctionsObject & { deno_import_map?: string }
-  [pattern: GlobPattern]: FunctionsObject
-}

package/types/config/inputs.d.ts

@@ -1,7 +0,0 @@
-import type { JSONValue } from '../utils/json_value.js'
-
-// Helper type to be used as a workaround for the fact that `interface`s don't have implicit
-// index signatures: https://github.com/microsoft/TypeScript/issues/15300
-export type StringKeys<TObject extends object> = keyof TObject & string
-
-export type PluginInputs<Keys extends string = string> = Partial<Record<Keys, JSONValue>>

package/types/config/netlify_config.d.ts

@@ -1,66 +0,0 @@
-import type { Many } from '../utils/many.js'
-
-import type { Build } from './build.js'
-import type { Functions } from './functions.js'
-import type { PluginInputs } from './inputs.js'
-
-type HttpStatusCode = number
-
-interface Redirect {
-  from: string
-  to?: string
-  status?: HttpStatusCode
-  force?: boolean
-  signed?: string
-  query?: Partial<Record<string, string>>
-  headers?: Partial<Record<string, string>>
-  conditions?: Partial<Record<'Language' | 'Role' | 'Country' | 'Cookie', readonly string[]>>
-}
-
-interface Header {
-  for: string
-  values: Partial<Record<string, Many<string, 'mutable'>>>
-}
-
-interface EdgeFunction {
-  path?: `/${string}`
-  function: string
-}
-
-interface NetlifyPlugin {
-  package: string
-  inputs: PluginInputs
-}
-
-interface ImagesConfig {
-  remote_images: string[]
-}
-
-/* eslint-disable camelcase -- some properties are named in snake case in this API */
-
-interface NetlifyConfig {
-  /**
-   * array of redirects with their modifiable options
-   */
-  redirects: Redirect[]
-  /**
-   * array of headers with their modifiable options
-   */
-  headers: Header[]
-  /**
-   * array of Edge Functions with their modifiable options
-   */
-  edge_functions: EdgeFunction[]
-  /**
-   * object with options for modifying [functions](https://docs.netlify.com/configure-builds/file-based-configuration/#functions)
-   */
-  functions: Functions
-  build: Build
-  plugins: readonly NetlifyPlugin[]
-  /**
-   * object with options for image transforms
-   */
-  images: ImagesConfig
-}
-
-/* eslint-enable camelcase */

package/types/index.d.ts

@@ -1,7 +0,0 @@
-export type { NetlifyPlugin } from './netlify_plugin.js'
-export type { NetlifyPluginOptions } from './netlify_plugin_options.js'
-export type { OnBuild, OnEnd, OnError, OnPostBuild, OnPreBuild, OnSuccess } from './netlify_event_handler.js'
-export type { NetlifyConfig } from './config/netlify_config.js'
-export type { NetlifyPluginUtils } from './options/netlify_plugin_utils.js'
-export type { NetlifyPluginConstants } from './netlify_plugin_constants.js'
-export type { ListedFunction, ListedFunctionFile } from './options/netlify_plugin_functions_util.js'

package/types/netlify_event_handler.d.ts

@@ -1,29 +0,0 @@
-import type { PluginInputs, StringKeys } from './config/inputs.js'
-import type { NetlifyPluginOptions } from './netlify_plugin_options.js'
-
-interface NetlifyEventHandler<PluginOptions extends NetlifyPluginOptions = NetlifyPluginOptions> {
-  (options: PluginOptions): void | Promise<void>
-}
-
-// To allow interfaces to be used as generics, since they lack implicit index signatures, we have to do some type shenanigans
-// to get TypeScript to behave as we want - only letting the keys of `TInputs` through, and thus not requiring a full index
-// signature on `TInputs`.
-// Related issues: https://github.com/microsoft/TypeScript/issues/15300, https://github.com/netlify/build/issues/3838
-export type OnPreBuild<TInputs extends PluginInputs<StringKeys<TInputs>> = PluginInputs> = NetlifyEventHandler<
-  NetlifyPluginOptions<TInputs>
->
-export type OnBuild<TInputs extends PluginInputs<StringKeys<TInputs>> = PluginInputs> = NetlifyEventHandler<
-  NetlifyPluginOptions<TInputs>
->
-export type OnPostBuild<TInputs extends PluginInputs<StringKeys<TInputs>> = PluginInputs> = NetlifyEventHandler<
-  NetlifyPluginOptions<TInputs>
->
-export type OnError<TInputs extends PluginInputs<StringKeys<TInputs>> = PluginInputs> = NetlifyEventHandler<
-  NetlifyPluginOptions<TInputs> & { error: Error }
->
-export type OnSuccess<TInputs extends PluginInputs<StringKeys<TInputs>> = PluginInputs> = NetlifyEventHandler<
-  NetlifyPluginOptions<TInputs>
->
-export type OnEnd<TInputs extends PluginInputs<StringKeys<TInputs>> = PluginInputs> = NetlifyEventHandler<
-  NetlifyPluginOptions<TInputs> & { error?: Error }
->

package/types/netlify_plugin.d.ts

@@ -1,29 +0,0 @@
-import type { PluginInputs } from './config/inputs.js'
-import type { OnBuild, OnEnd, OnError, OnPostBuild, OnPreBuild, OnSuccess } from './netlify_event_handler.js'
-
-export interface NetlifyPlugin<TInputs extends PluginInputs = PluginInputs> {
-  /**
-   * Runs before the build command is executed.
-   */
-  onPreBuild?: OnPreBuild<TInputs>
-  /**
-   * runs directly after the build command is executed and before Functions? bundling and Edge Handlers bundling.
-   */
-  onBuild?: OnBuild<TInputs>
-  /**
-   * runs after the build command completes; after onBuild? tasks, Functions? bundling, and Edge Handlers bundling are executed; and before the deploy stage. Can be used to prevent a build from being deployed.
-   */
-  onPostBuild?: OnPostBuild<TInputs>
-  /**
-   * runs when an error occurs in the build or deploy stage, failing the build. Can’t be used to prevent a build from being deployed.
-   */
-  onError?: OnError<TInputs>
-  /**
-   * runs when the deploy succeeds. Can’t be used to prevent a build from being deployed.
-   */
-  onSuccess?: OnSuccess<TInputs>
-  /**
-   * runs after completion of the deploy stage, regardless of build error or success; is useful for resources cleanup. Can’t be used to prevent a build from being deployed.
-   */
-  onEnd?: OnEnd<TInputs>
-}

package/types/netlify_plugin_constants.d.ts

@@ -1,66 +0,0 @@
-export interface NetlifyPluginConstants {
-  /**
-   * path to the Netlify configuration file.
-   * `undefined` if none was used.
-   */
-  CONFIG_PATH?: string
-  /**
-   * directory that contains the deploy-ready HTML files and assets generated by the build. Its value is always defined, but the target might not have been created yet.
-   */
-  PUBLISH_DIR: string
-  /**
-   * the directory where function source code lives.
-   * `undefined` if no `netlify/functions` directory exists in the base directory and if not specified by the user.
-   */
-  FUNCTIONS_SRC?: string
-
-  /**
-   * the directory inside a mono repository where it collects the settings from.
-   * This is the value of the package directory field of the build settings
-   * `undefined` if none is set.
-   */
-  PACKAGE_PATH?: string
-  /**
-   * the directory where internal Edge Functions source code lives. This is where build plugins should place auto-generated functions.
-   * `undefined` if the version of @netlify/build does not support internal Edge Functions
-   */
-  INTERNAL_EDGE_FUNCTIONS_SRC?: string
-  /**
-   * the directory where internal function source code lives. This is where build plugins should place auto-generated functions.
-   * `undefined` if the version of @netlify/build does not support internal functions
-   */
-  INTERNAL_FUNCTIONS_SRC?: string
-  /**
-   * the directory where built serverless functions are placed before deployment. Its value is always defined, but the target might not have been created yet.
-   */
-  FUNCTIONS_DIST: string
-  /**
-   * the directory where built Edge Functions are placed before deployment. Its value is always defined, but the target might not have been created yet.
-   */
-  EDGE_FUNCTIONS_DIST: string
-  /**
-   * the directory where Edge Functions source code lives.
-   * `undefined` if no `netlify/edge-functions` directory exists.
-   */
-  EDGE_FUNCTIONS_SRC?: string
-  /**
-   * boolean indicating whether the build was [run locally](https://docs.netlify.com/cli/get-started/#run-builds-locally) or on Netlify
-   */
-  IS_LOCAL: boolean
-  /**
-   * version of Netlify Build as a `major.minor.patch` string
-   */
-  NETLIFY_BUILD_VERSION: string
-  /**
-   * the Netlify site ID
-   */
-  SITE_ID: string
-  /**
-   * the Netlify API access token
-   */
-  NETLIFY_API_TOKEN?: string
-  /**
-   * the Netlify API host
-   */
-  NETLIFY_API_HOST?: string
-}