@netlify/config 25.2.7 → 25.3.0

package/lib/normalize.js

@@ -1,16 +1,27 @@
 import { normalizeFunctionsProps, WILDCARD_ALL } from './functions_config.js';
 import { mergeConfigs } from './merge.js';
 import { DEFAULT_ORIGIN } from './origin.js';
-import { removeFalsy } from './utils/remove_falsy.js';
+import { removeFalsy, removeUndefined } from './utils/remove_falsy.js';
 /**
  * Normalize configuration object
  */
 export const normalizeConfig = function (config, packagePath) {
     const configA = removeEmpty(config);
-    const { build, functions, plugins, ...configB } = mergeConfigs([DEFAULT_CONFIG(packagePath), configA]);
+    const { build, functions, plugins, server, ...configB } = mergeConfigs([
+        DEFAULT_CONFIG(packagePath),
+        configA,
+    ]);
     const { build: buildA, functions: functionsA, functionsDirectoryProps } = normalizeFunctionsProps(build, functions);
     const pluginsA = plugins.map(normalizePlugin);
-    return { ...configB, build: buildA, functions: functionsA, plugins: pluginsA, ...functionsDirectoryProps };
+    const serverProps = server === undefined ? {} : { server: normalizeServer(server) };
+    return {
+        ...configB,
+        build: buildA,
+        functions: functionsA,
+        plugins: pluginsA,
+        ...serverProps,
+        ...functionsDirectoryProps,
+    };
 };
 /**
  * Remove empty strings.
@@ -34,3 +45,9 @@ const DEFAULT_CONFIG = (packagePath) => ({
 const normalizePlugin = function ({ inputs = {}, ...plugin }) {
     return removeFalsy({ ...plugin, inputs });
 };
+const lowerCase = (value) => (typeof value === 'string' ? value.toLowerCase() : value);
+// `region` and `size` take a fixed set of values, which can be written in any
+// case.
+const normalizeServer = function ({ region, size, ...server }) {
+    return removeUndefined({ ...server, region: lowerCase(region), size: lowerCase(size) });
+};

package/lib/validate/validations.d.ts

@@ -118,6 +118,16 @@ export const PRE_NORMALIZE_VALIDATIONS: ({
             };
         };
     };
+} | {
+    property: string;
+    check: typeof isPlainObj;
+    message: string;
+    example: () => {
+        server: {
+            path: string;
+            size: string;
+        };
+    };
 })[];
 export const POST_NORMALIZE_VALIDATIONS: ({
     example: () => {
@@ -367,5 +377,42 @@ export const POST_NORMALIZE_VALIDATIONS: ({
             };
         };
     };
+} | {
+    property: string;
+    check: (value: any) => boolean;
+    message: string;
+    example: () => {
+        server: {
+            path: string[];
+        };
+    };
+} | {
+    property: string;
+    check: (value: any) => boolean;
+    message: string;
+    example: () => {
+        server: {
+            path: string;
+            excludedPath: string[];
+        };
+    };
+} | {
+    property: string;
+    check: (value: any) => boolean;
+    message: string;
+    example: () => {
+        server: {
+            region: string;
+        };
+    };
+} | {
+    property: string;
+    check: (value: any) => boolean;
+    message: string;
+    example: () => {
+        server: {
+            size: string;
+        };
+    };
 })[];
 import isPlainObj from 'is-plain-obj';

package/lib/validate/validations.js

@@ -31,6 +31,11 @@ const isValidFunctionMemory = (value) => {
     }
     return Number.isInteger(megabytes) && megabytes >= FUNCTION_MEMORY_MIN_MB && megabytes <= FUNCTION_MEMORY_MAX_MB;
 };
+const SERVER_PROPERTIES = ['excludedPath', 'path', 'region', 'size'];
+const SERVER_REGIONS = ['cmh', 'fra'];
+const SERVER_SIZES = ['small', 'medium', 'large'];
+const isServerPath = (value) => isString(value) && value.startsWith('/');
+const isServerPaths = (value) => isServerPath(value) || (Array.isArray(value) && value.every(isServerPath));
 // List of validations performed on the configuration file.
 // Validation are performed in order: parent should be before children.
 // Each validation is an object with the following properties:
@@ -148,6 +153,12 @@ export const PRE_NORMALIZE_VALIDATIONS = [
         message: 'must be a plain object.',
         example: () => ({ database: { migrations: { path: 'netlify/database/migrations' } } }),
     },
+    {
+        property: 'server',
+        check: isPlainObj,
+        message: 'must be a plain object.',
+        example: () => ({ server: { path: '/api/*', size: 'small' } }),
+    },
 ];
 const EXAMPLE_PORT = 80;
 // Validations done after normalization
@@ -340,5 +351,35 @@ export const POST_NORMALIZE_VALIDATIONS = [
         message: 'must be a string.',
         example: () => ({ database: { migrations: { path: 'netlify/database/migrations' } } }),
     },
+    {
+        property: 'server',
+        ...validProperties(SERVER_PROPERTIES, []),
+        example: () => ({ server: { path: '/api/*', size: 'small' } }),
+    },
+    {
+        property: 'server.path',
+        check: isServerPaths,
+        message: 'must be a path starting with "/", or an array of them.',
+        example: () => ({ server: { path: ['/api/*', '/auth/callback'] } }),
+    },
+    {
+        property: 'server.excludedPath',
+        check: isServerPaths,
+        message: 'must be a path starting with "/", or an array of them.',
+        example: () => ({ server: { path: '/api/*', excludedPath: ['/api/internal', '/api/admin/*'] } }),
+    },
+    // Region and size are lowercased during normalization.
+    {
+        property: 'server.region',
+        check: (value) => SERVER_REGIONS.includes(value),
+        message: `must be one of: ${SERVER_REGIONS.join(', ')}`,
+        example: () => ({ server: { region: SERVER_REGIONS[0] } }),
+    },
+    {
+        property: 'server.size',
+        check: (value) => SERVER_SIZES.includes(value),
+        message: `must be one of: ${SERVER_SIZES.join(', ')}`,
+        example: () => ({ server: { size: SERVER_SIZES[0] } }),
+    },
     ...edgeFunctionValidations,
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@netlify/config",
-  "version": "25.2.7",
+  "version": "25.3.0",
   "description": "Netlify config module",
   "type": "module",
   "exports": "./lib/index.js",
@@ -58,7 +58,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@netlify/api": "^15.1.2",
+    "@netlify/api": "^15.1.3",
     "@netlify/headers-parser": "^10.1.1",
     "@netlify/redirect-parser": "^16.1.1",
     "chalk": "^6.0.0",
@@ -94,5 +94,5 @@
   "engines": {
     "node": ">=22.12.0"
   },
-  "gitHead": "288d53ba807d13535afdb605f49034e0a9a4082e"
+  "gitHead": "19447a3826a8d26af1bcdc704754e8a8586597f1"
 }