Merge branch 'main' into custom-roles-api-spec-changes

.ci/Dockerfile

@@ -1,4 +1,4 @@
-FROM node:16
+FROM node:20
 
 WORKDIR /usr/src/app
 

.github/workflows/code-format.yml

@@ -10,10 +10,10 @@ jobs:
     steps:
     - uses: actions/checkout@v2
 
-    - name: Use Node.js 16.x
+    - name: Use Node.js 20.x
       uses: actions/setup-node@v1
       with:
-        node-version: 16.x
+        node-version: 20.x
 
     - name: Install
       run: |

.github/workflows/compiler.test.yml

@@ -13,10 +13,10 @@ jobs:
     steps:
       - uses: actions/checkout@v2
 
-      - name: Use Node.js 16.x
+      - name: Use Node.js 20.x
         uses: actions/setup-node@v1
         with:
-          node-version: 16.x
+          node-version: 20.x
 
       - name: Install deps
         run: |

.github/workflows/generate.yml

@@ -34,10 +34,10 @@ jobs:
         token: ${{ secrets.PAT }}
         persist-credentials: true
 
-    - name: Setup Node 16.x
+    - name: Setup Node 20.x
       uses: actions/setup-node@v3
       with:
-        node-version: 16.x
+        node-version: 20.x
         cache: npm
         cache-dependency-path: '**/package-lock.json'
 

.github/workflows/gh-pages-report.yml

@@ -16,10 +16,10 @@ jobs:
     steps:
     - uses: actions/checkout@v2
 
-    - name: Use Node.js 16.x
+    - name: Use Node.js 20.x
       uses: actions/setup-node@v1
       with:
-        node-version: 16.x
+        node-version: 20.x
 
     - name: Install
       run: |

.github/workflows/linter.yml

@@ -10,10 +10,10 @@ jobs:
     steps:
     - uses: actions/checkout@v2
 
-    - name: Use Node.js 16.x
+    - name: Use Node.js 20.x
       uses: actions/setup-node@v1
       with:
-        node-version: 16.x
+        node-version: 20.x
 
     - name: Install
       run: |

.github/workflows/update-rest-api-json.yml

@@ -19,10 +19,10 @@ jobs:
         with:
           ref: ${{ matrix.branch }}
 
-      - name: Use Node.js 16.x
+      - name: Use Node.js 20.x
         uses: actions/setup-node@v1
         with:
-          node-version: 16.x
+          node-version: 20.x
 
       - name: Install deps
         run: |

.github/workflows/validate-pr.yml

@@ -32,10 +32,10 @@ jobs:
           token: ${{ secrets.PAT }}
           ref: main
 
-      - name: Use Node.js 16.x
+      - name: Use Node.js 20.x
         uses: actions/setup-node@v1
         with:
-          node-version: 16.x
+          node-version: 20.x
 
       - name: Install deps 1/2
         working-directory: ./clients-flight-recorder

.nvmrc

@@ -1 +1 @@
-16
+20

specification/_spec_utils/utils.ts

@@ -24,12 +24,18 @@ import { Stringified } from '@spec_utils/Stringified'
  * to a missing value. It is used for exemple in settings, where using the `NullValue` for a setting will reset
  * it to its default value.
  */
-type NullValue = null
+export type NullValue = null
+
+/**
+ * `WithNullValue<T>` allows for explicit null assignments in contexts where `null` should be interpreted as an
+ * actual value.
+ */
+export type WithNullValue<T> = T | NullValue
 
 /**
  * Settings in Elasticsearch are values that can be reset to their default by setting them to the `null` value.
  *
  * @es_quirk Because of how they are implemented internally, settings are always returned as strings, even
  *           if their value has been set using a primitive type.
  */
-type Setting<T> = Stringified<T> | NullValue
+export type Setting<T> = WithNullValue<Stringified<T>>