fix: expose apply mutation to API surface (#4932)

* fix: expose apply mutation to API surface

* chore: fix import location

Author: Lukas Holzer

packages/config/package.json

@@ -3,9 +3,9 @@
   "version": "20.3.3",
   "description": "Netlify config module",
   "type": "module",
-  "exports": "./lib/main.js",
-  "main": "./lib/main.js",
-  "types": "./lib/main.d.ts",
+  "exports": "./lib/index.js",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
   "bin": {
     "netlify-config": "./bin.js"
   },

packages/config/src/index.ts

@@ -0,0 +1,5 @@
+export { DEV_EVENTS, EVENTS } from './events.js'
+export { cleanupConfig } from './log/cleanup.js'
+export { resolveConfig } from './main.js'
+export { applyMutations } from './mutations/apply.js'
+export { restoreConfig, updateConfig } from './mutations/update.js'

packages/config/src/main.js

@@ -18,11 +18,6 @@ import { parseConfig } from './parse.js'
 import { getConfigPath } from './path.js'
 import { getRedirectsPath, addRedirects } from './redirects.js'
 
-export { DEV_EVENTS, EVENTS } from './events.js'
-export { cleanupConfig } from './log/cleanup.js'
-
-export { updateConfig, restoreConfig } from './mutations/update.js'
-
 // Load the configuration file.
 // Takes an optional configuration file path as input and return the resolved
 // `config` together with related properties such as the `configPath`.

packages/config/src/mutations/config_prop_name.js

@@ -0,0 +1,14 @@
+/** Properties with dynamic children */
+const DYNAMIC_OBJECT_PROPS = new Set(['build.services', 'build.environment', 'functions', 'functions.*'])
+
+/** Retrieve normalized property name */
+export const getPropName = function (keys: string[]) {
+  // Some properties are user-defined, i.e. we need to replace them with a "*" token
+  // Check if a property name is dynamic, such as `functions.{functionName}`, or
+  // is an array index.
+  // In those cases, we replace it by "*".
+  return keys.reduce((propName, key) => {
+    const normalizedKey = Number.isInteger(key) || DYNAMIC_OBJECT_PROPS.has(propName) ? '*' : String(key)
+    return propName === '' ? normalizedKey : `${propName}.${normalizedKey}`
+  }, '')
+}

packages/config/src/mutations/config_prop_name.ts

@@ -5,7 +5,7 @@ import { Fixture, normalizeOutput } from '@netlify/testing'
 import test from 'ava'
 import del from 'del'
 
-import { updateConfig } from '../../lib/main.js'
+import { updateConfig } from '../../lib/index.js'
 
 const FIXTURES_DIR = fileURLToPath(new URL('fixtures', import.meta.url))