[Backport 8.12] Fix typo in documentation (example query) (#2272)

(cherry picked from commit 542585a5dc)

Co-authored-by: Joey Freund <joeyfreund@users.noreply.github.com>

.buildkite/Dockerfile

@@ -3,14 +3,14 @@ FROM node:$NODE_VERSION
 
 # Install required tools
 RUN apt-get clean -y && \
-  apt-get -qy update && \
-  apt-get -y install zip && \
-  apt-get clean && \
-  rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
+    apt-get -qy update && \
+    apt-get -y install zip && \
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
 
 WORKDIR /usr/src/app
 
 COPY package.json .
-RUN npm install
+RUN npm install --production=false
 
 COPY . .

.buildkite/functions/cleanup.sh

@@ -2,7 +2,7 @@
 #
 # Shared cleanup routines between different steps
 #
-# Please source .buildkite/functions/imports.sh as a whole not just this file
+# Please source .ci/functions/imports.sh as a whole not just this file
 #
 # Version 1.0.0
 # - Initial version after refactor

.buildkite/functions/wait-for-container.sh

@@ -2,7 +2,7 @@
 #
 # Exposes a routine scripts can call to wait for a container if that container set up a health command
 #
-# Please source .buildkite/functions/imports.sh as a whole not just this file
+# Please source .ci/functions/imports.sh as a whole not just this file
 #
 # Version 1.0.1
 # - Initial version after refactor

.buildkite/pipeline.yml

@@ -6,7 +6,7 @@ steps:
     env:
       NODE_VERSION: "{{ matrix.nodejs }}"
       TEST_SUITE: "{{ matrix.suite }}"
-      STACK_VERSION: 8.16.0
+      STACK_VERSION: 8.12.0-SNAPSHOT
     matrix:
       setup:
         suite:
@@ -15,7 +15,6 @@ steps:
         nodejs:
           - "18"
           - "20"
-          - "22"
     command: ./.buildkite/run-tests.sh
     artifact_paths: "./junit-output/junit-*.xml"
   - wait: ~
@@ -25,8 +24,8 @@ steps:
       provider: "gcp"
       image: family/core-ubuntu-2204
     plugins:
-      - junit-annotate#v2.6.0:
+      - junit-annotate#v2.4.1:
           artifacts: "junit-output/junit-*.xml"
-          job-uuid-file-pattern: "junit-(.*).xml"
+          job-uuid-file-pattern: 'junit-(.*).xml'
           fail-build-on-error: true
           failure-format: file

.buildkite/pull-requests.json

@@ -9,6 +9,7 @@
         "\\.md$",
         "\\.asciidoc$",
         "^docs\\/",
+        "^\\.ci\\/",
         "^scripts\\/",
         "^catalog-info\\.yaml$",
         "^test\\/unit\\/",

.ci/Dockerfile

@@ -24,7 +24,7 @@ USER ${BUILDER_UID}:${BUILDER_GID}
 
 # install dependencies
 COPY package.json .
-RUN npm install
+RUN npm install --production=false
 
 # copy project files
 COPY . .

.ci/make.mjs

@@ -74,15 +74,14 @@ async function release (args) {
 
 async function bump (args) {
   assert(args.length === 1, 'Bump task expects one parameter')
-  let [version] = args
+  const [version] = args
   const packageJson = JSON.parse(await readFile(
     join(import.meta.url, '..', 'package.json'),
     'utf8'
   ))
 
-  if (version.split('.').length === 2) version = `${version}.0`
   const cleanVersion = semver.clean(version.includes('SNAPSHOT') ? version.split('-')[0] : version)
-  assert(semver.valid(cleanVersion), `${cleanVersion} is not seen as a valid semver version. raw version: ${version}`)
+  assert(semver.valid(cleanVersion))
   packageJson.version = cleanVersion
   packageJson.versionCanary = `${cleanVersion}-canary.0`
 
@@ -95,7 +94,7 @@ async function bump (args) {
   const pipeline = await readFile(join(import.meta.url, '..', '.buildkite', 'pipeline.yml'), 'utf8')
   await writeFile(
     join(import.meta.url, '..', '.buildkite', 'pipeline.yml'),
-    pipeline.replace(/STACK_VERSION: [0-9]+[0-9\.]*[0-9](?:\-SNAPSHOT)?/, `STACK_VERSION: ${cleanVersion}`),
+    pipeline.replace(/STACK_VERSION: [0-9]+[0-9\.]*[0-9](?:\-SNAPSHOT)?/, `STACK_VERSION: ${cleanVersion}-SNAPSHOT`),
     'utf8'
   )
 }
@@ -125,13 +124,6 @@ async function codegen (args) {
   await $`cp -R ${join(import.meta.url, '..', '..', 'elastic-client-generator-js', 'output')}/* ${join(import.meta.url, '..', 'src', 'api')}`
   await $`mv ${join(import.meta.url, '..', 'src', 'api', 'reference.asciidoc')} ${join(import.meta.url, '..', 'docs', 'reference.asciidoc')}`
   await $`npm run build`
-
-  // run docs example generation
-  if (version === 'main') {
-    await $`node ./scripts/generate-docs-examples.js`
-  } else {
-    await $`node ./scripts/generate-docs-examples.js ${version.split('.').slice(0, 2).join('.')}`
-  }
 }
 
 function onError (err) {

.ci/make.sh

@@ -0,0 +1,214 @@
+#!/usr/bin/env bash
+# ------------------------------------------------------- #
+#
+# Build entry script for elasticsearch-js
+#
+# Must be called: ./.ci/make.sh <target> <params>
+#
+# Version: 1.1.0
+#
+# Targets:
+# ---------------------------
+# assemble   <VERSION> : build client artifacts with version
+# bump       <VERSION> : bump client internals to version
+# bumpmatrix <VERSION> : bump stack version in test matrix to version
+# codegen    <VERSION> : generate endpoints
+# docsgen    <VERSION> : generate documentation
+# examplegen           : generate the doc examples
+# clean                : clean workspace
+#
+# ------------------------------------------------------- #
+
+# ------------------------------------------------------- #
+# Bootstrap
+# ------------------------------------------------------- #
+script_path=$(dirname "$(realpath -s "$0")")
+repo=$(realpath "$script_path/../")
+
+# shellcheck disable=SC1090
+CMD=$1
+TASK=$1
+TASK_ARGS=()
+VERSION=$2
+STACK_VERSION=$VERSION
+set -euo pipefail
+
+product="elastic/elasticsearch-js"
+output_folder=".ci/output"
+codegen_folder=".ci/output"
+OUTPUT_DIR="$repo/${output_folder}"
+NODE_JS_VERSION=18
+WORKFLOW=${WORKFLOW-staging}
+mkdir -p "$OUTPUT_DIR"
+
+echo -e "\033[34;1mINFO:\033[0m PRODUCT ${product}\033[0m"
+echo -e "\033[34;1mINFO:\033[0m VERSION ${STACK_VERSION}\033[0m"
+echo -e "\033[34;1mINFO:\033[0m OUTPUT_DIR ${OUTPUT_DIR}\033[0m"
+
+case $CMD in
+    clean)
+        echo -e "\033[36;1mTARGET: clean workspace $output_folder\033[0m"
+        rm -rf "$output_folder"
+        echo -e "\033[32;1mdone.\033[0m"
+        exit 0
+        ;;
+    assemble)
+        if [ -v $VERSION ]; then
+            echo -e "\033[31;1mTARGET: assemble -> missing version parameter\033[0m"
+            exit 1
+        fi
+        echo -e "\033[36;1mTARGET: assemble artifact $VERSION\033[0m"
+        TASK=release
+        TASK_ARGS=("$VERSION" "$output_folder")
+        ;;
+    codegen)
+        if [ -v "$VERSION" ] || [[ -z "$VERSION" ]]; then
+            # fall back to branch name or `main` if no VERSION is set
+            branch_name=$(git rev-parse --abbrev-ref HEAD)
+            if [[ "$branch_name" =~ ^[0-9]+\.[0-9]+ ]]; then
+              echo -e "\033[36;1mTARGET: codegen -> No VERSION argument found, using branch name: \`$branch_name\`\033[0m"
+              VERSION="$branch_name"
+            else
+              echo -e "\033[36;1mTARGET: codegen -> No VERSION argument found, using \`main\`\033[0m"
+              VERSION="main"
+            fi
+        fi
+        if [ "$VERSION" = 'main' ]; then
+          echo -e "\033[36;1mTARGET: codegen API $VERSION\033[0m"
+        else
+          echo -e "\033[36;1mTARGET: codegen API v$VERSION\033[0m"
+        fi
+
+        TASK=codegen
+        TASK_ARGS=("$VERSION")
+        ;;
+    docsgen)
+        if [ -v $VERSION ]; then
+            echo -e "\033[31;1mTARGET: docsgen -> missing version parameter\033[0m"
+            exit 1
+        fi
+        echo -e "\033[36;1mTARGET: generate docs for $VERSION\033[0m"
+        TASK=codegen
+        TASK_ARGS=("$VERSION" "$codegen_folder")
+        ;;
+    examplesgen)
+        echo -e "\033[36;1mTARGET: generate examples\033[0m"
+        TASK=codegen
+        TASK_ARGS=("$VERSION" "$codegen_folder")
+        ;;
+    bump)
+        if [ -v $VERSION ]; then
+            echo -e "\033[31;1mTARGET: bump -> missing version parameter\033[0m"
+            exit 1
+        fi
+        echo -e "\033[36;1mTARGET: bump to version $VERSION\033[0m"
+        TASK=bump
+        TASK_ARGS=("$VERSION")
+        ;;
+    bumpmatrix)
+      if [ -v $VERSION ]; then
+        echo -e "\033[31;1mTARGET: bumpmatrix -> missing version parameter\033[0m"
+        exit 1
+      fi
+      echo -e "\033[36;1mTARGET: bump stack in test matrix to version $VERSION\033[0m"
+      TASK=bumpmatrix
+      TASK_ARGS=("$VERSION")
+      ;;
+    *)
+        echo -e "\n'$CMD' is not supported right now\n"
+        echo -e "\nUsage:"
+        echo -e "\t $0 release \$VERSION\n"
+        echo -e "\t $0 bump \$VERSION"
+        echo -e "\t $0 codegen \$VERSION"
+        exit 1
+esac
+
+
+# ------------------------------------------------------- #
+# Build Container
+# ------------------------------------------------------- #
+
+echo -e "\033[34;1mINFO: building $product container\033[0m"
+
+docker build \
+  --file .ci/Dockerfile \
+  --tag "$product" \
+  --build-arg NODE_JS_VERSION="$NODE_JS_VERSION" \
+  --build-arg "BUILDER_UID=$(id -u)" \
+  --build-arg "BUILDER_GID=$(id -g)" \
+  .
+
+# ------------------------------------------------------- #
+# Run the Container
+# ------------------------------------------------------- #
+
+echo -e "\033[34;1mINFO: running $product container\033[0m"
+
+if [[ -z "${BUILDKITE+x}" ]] && [[ -z "${CI+x}" ]] && [[ -z "${GITHUB_ACTIONS+x}" ]]; then
+  echo -e "\033[34;1mINFO: Running in local mode"
+  docker run \
+    -u "$(id -u):$(id -g)" \
+    --volume "$repo:/usr/src/elasticsearch-js" \
+    --volume /usr/src/elasticsearch-js/node_modules \
+    --volume "$(realpath $repo/../elastic-client-generator-js):/usr/src/elastic-client-generator-js" \
+    --env "WORKFLOW=$WORKFLOW" \
+    --name make-elasticsearch-js \
+    --rm \
+    $product \
+    /bin/bash -c "mkdir -p /usr/src/elastic-client-generator-js/output && \
+      node .ci/make.mjs --task $TASK ${TASK_ARGS[*]}"
+else
+  echo -e "\033[34;1mINFO: Running in CI mode"
+  docker run \
+    --volume "$repo:/usr/src/elasticsearch-js" \
+    --volume /usr/src/elasticsearch-js/node_modules \
+    -u "$(id -u):$(id -g)" \
+    --env "WORKFLOW=$WORKFLOW" \
+    --name make-elasticsearch-js \
+    --rm \
+    $product \
+    /bin/bash -c "cd /usr/src && \
+      git clone https://$CLIENTS_GITHUB_TOKEN@github.com/elastic/elastic-client-generator-js.git && \
+      mkdir -p /usr/src/elastic-client-generator-js/output && \
+      cd /usr/src/elasticsearch-js && \
+      node .ci/make.mjs --task $TASK ${TASK_ARGS[*]}"
+fi
+
+# ------------------------------------------------------- #
+# Post Command tasks & checks
+# ------------------------------------------------------- #
+
+if [[ "$CMD" == "assemble" ]]; then
+	if compgen -G ".ci/output/*" > /dev/null; then
+		echo -e "\033[32;1mTARGET: successfully assembled client v$VERSION\033[0m"
+	else
+		echo -e "\033[31;1mTARGET: assemble failed, empty workspace!\033[0m"
+		exit 1
+	fi
+fi
+
+if [[ "$CMD" == "bump" ]]; then
+  if [ -n "$(git status --porcelain)" ]; then 
+		echo -e "\033[32;1mTARGET: successfully bumped client v$VERSION\033[0m"
+  else 
+		echo -e "\033[31;1mTARGET: failed bumped client v$VERSION\033[0m"
+    exit 1
+  fi
+fi
+
+if [[ "$CMD" == "codegen" ]]; then
+  if [ -n "$(git status --porcelain)" ]; then 
+		echo -e "\033[32;1mTARGET: successfully generated client v$VERSION\033[0m"
+  else 
+		echo -e "\033[31;1mTARGET: failed generating client v$VERSION\033[0m"
+    exit 1
+  fi
+fi
+
+if [[ "$CMD" == "docsgen" ]]; then
+    echo "TODO"
+fi
+
+if [[ "$CMD" == "examplesgen" ]]; then
+    echo "TODO"
+fi

.dockerignore

@@ -5,4 +5,3 @@ elasticsearch
 .git
 lib
 junit-output
-.tap

.github/ISSUE_TEMPLATE/bug.md

@@ -0,0 +1,49 @@
+---
+name: 🐛 Bug report
+about: Create a report to help us improve
+---
+
+It's not uncommon that somebody already opened an issue or in the best case it's already fixed but not merged. That's the reason why you should [search](https://github.com/elastic/elasticsearch-js/issues) at first before submitting a new one.
+
+**Please read this entire template before posting any issue. If you ignore these instructions
+and post an issue here that does not follow the instructions, your issue might be closed,
+locked, and assigned the `not reproducible` label.**
+
+## 🐛 Bug Report
+
+A clear and concise description of what the bug is.
+
+## To Reproduce
+
+Steps to reproduce the behavior:
+
+Paste your code here:
+
+```js
+
+```
+
+<!--
+In some cases, it might be challenging to reproduce the bug in a few lines of code.
+You can fork the following repository, which contains all the configuration needed
+to spin up a three nodes Elasticsearch cluster with security enabled.
+The repository also contains a preconfigured client instance that you can use to reproduce the issue.
+https://github.com/delvedor/es-reproduce-issue
+--->
+
+## Expected behavior
+
+A clear and concise description of what you expected to happen.
+
+Paste the results here:
+
+```js
+
+```
+
+## Your Environment
+
+- *node version*: 6,8,10
+- `@elastic/elasticsearch` *version*: >=7.0.0
+- *os*: Mac, Windows, Linux
+- *any other relevant information*

.github/ISSUE_TEMPLATE/bug.yaml

@@ -1,66 +0,0 @@
----
-name: 🐛 Bug report
-description: Create a report to help us improve
-labels: ["Category: Bug"]
-body:
-  - type: markdown
-    attributes:
-      value: |
-        It's not uncommon that somebody already opened an issue or in the best case it's already fixed but not merged. That's the reason why you should [search](https://github.com/elastic/elasticsearch-js/issues) at first before submitting a new one.
-
-        **Please read this entire template before posting any issue. If you ignore these instructions
-        and post an issue here that does not follow the instructions, your issue might be closed,
-        locked, and assigned the `Category: Not an issue` label.**
-
-  - type: textarea
-    id: bug-report
-    attributes:
-      label: 🐛 Bug report
-      description: A clear and concise description of what the bug is.
-    validations:
-      required: true
-
-  - type: textarea
-    id: reproduction
-    attributes:
-      label: To reproduce
-      description: Steps to reproduce the behavior
-    validations:
-      required: true
-
-  - type: textarea
-    id: expected
-    attributes:
-      label: Expected behavior
-      description: A clear and concise description of what you expected to happen.
-    validations:
-      required: true
-
-  - type: input
-    id: node-js-version
-    attributes:
-      label: Node.js version
-      placeholder: 18.x, 20.x, etc.
-    validations:
-      required: true
-
-  - type: input
-    id: client-version
-    attributes:
-      label: "@elastic/elasticsearch version"
-      placeholder: 7.17.0, 8.14.1, etc.
-    validations:
-      required: true
-
-  - type: input
-    id: os
-    attributes:
-      label: Operating system
-      placeholder: Ubuntu 22.04, macOS, etc.
-    validations:
-      required: true
-
-  - type: input
-    id: env-info
-    attributes:
-      label: Any other relevant environment information

.github/ISSUE_TEMPLATE/feature.md

@@ -0,0 +1,22 @@
+---
+name: 🚀 Feature Proposal
+about: Submit a proposal for a new feature
+---
+
+It's not uncommon that somebody already opened an issue or in the best case it's already fixed but not merged. That's the reason why you should [search](https://github.com/elastic/elasticsearch-js/issues) at first before submitting a new one.
+
+**Please read this entire template before posting any issue. If you ignore these instructions
+and post an issue here that does not follow the instructions, your issue might be closed,
+locked, and assigned the `invalid` label.**
+
+## 🚀 Feature Proposal
+
+A clear and concise description of what the feature is.
+
+## Motivation
+
+Please outline the motivation for the proposal.
+
+## Example
+
+Please provide an example for how this feature would be used.

.github/ISSUE_TEMPLATE/feature.yaml

@@ -1,33 +0,0 @@
----
-name: 🚀 Feature Proposal
-description: Submit a proposal for a new feature
-labels: ["Category: Feature"]
-body:
-  - type: markdown
-    attributes:
-      value: |
-        It's not uncommon that somebody already opened an issue or in the best case it's already fixed but not merged. That's the reason why you should [search](https://github.com/elastic/elasticsearch-js/issues) at first before submitting a new one.
-
-        **Please read this entire template before posting any issue. If you ignore these instructions
-        and post an issue here that does not follow the instructions, your issue might be closed,
-        locked, and assigned the `Category: Not an issue` label.**
-
-  - type: textarea
-    id: feature-proposal
-    attributes:
-      label: 🚀 Feature Proposal
-      description: A clear and concise description of what the feature is.
-    validations:
-      required: true
-
-  - type: textarea
-    id: motivation
-    attributes:
-      label: Motivation
-      description: Please outline the motivation for the proposal.
-
-  - type: textarea
-    id: example
-    attributes:
-      label: Example
-      description: Please provide an example for how this feature would be used.

.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,10 @@
+---
+name: 💬 Questions / Help
+about: If you have questions, please check our Gitter or Help repo
+---
+
+## 💬 Questions and Help
+
+### Please note that this issue tracker is not a help forum and this issue may be closed.
+
+It's not uncommon that somebody already opened an issue or in the best case it's already fixed but not merged. That's the reason why you should [search](https://github.com/elastic/elasticsearch-js/issues) at first before submitting a new one.

.github/ISSUE_TEMPLATE/question.yaml

@@ -1,21 +0,0 @@
----
-name: 💬 Questions / Help
-description: If you have questions, please check our community forum or support
-labels: ["Category: Question"]
-body:
-  - type: markdown
-    attributes:
-      value: |
-        ### Please note that this issue tracker is not a help forum and this issue may be closed.
-
-        Please check our [community forum](https://discuss.elastic.co/) or [contact Elastic support](https://www.elastic.co/support) if your issue is not specifically related to the documented functionality of this client library.
-
-        It's not uncommon that somebody already opened an issue or in the best case it's already fixed but not merged. That's the reason why you should [search](https://github.com/elastic/elasticsearch-js/issues) at first before submitting a new one.
-
-  - type: textarea
-    id: question
-    attributes:
-      label: Question
-      description: Your question or comment
-    validations:
-      required: true

.github/ISSUE_TEMPLATE/regression.md

@@ -0,0 +1,56 @@
+---
+name: 💥 Regression Report
+about: Report unexpected behavior that worked in previous versions
+---
+
+It's not uncommon that somebody already opened an issue or in the best case it's already fixed but not merged. That's the reason why you should [search](https://github.com/elastic/elasticsearch-js/issues) at first before submitting a new one.
+
+**Please read this entire template before posting any issue. If you ignore these instructions
+and post an issue here that does not follow the instructions, your issue might be closed,
+locked, and assigned the `invalid` label.**
+
+## 💥 Regression Report
+
+A clear and concise description of what the regression is.
+
+## Last working version
+
+Worked up to version:
+
+Stopped working in version:
+
+## To Reproduce
+
+Steps to reproduce the behavior:
+
+Paste your code here:
+
+```js
+
+```
+
+<!--
+In some cases, it might be challenging to reproduce the bug in a few lines of code.
+You can fork the following repository, which contains all the configuration needed
+to spin up a three nodes Elasticsearch cluster with security enabled.
+The repository also contains a preconfigured client instance that you can use to reproduce the issue.
+https://github.com/delvedor/es-reproduce-issue
+--->
+
+## Expected behavior
+
+A clear and concise description of what you expected to happen.
+
+Paste the results here:
+
+```js
+
+```
+
+## Your Environment
+
+- *node version*: 6,8,10
+- `@elastic/elasticsearch` *version*: >=7.0.0
+- *typescript version*: 4.x (if applicable)
+- *os*: Mac, Windows, Linux
+- *any other relevant information*

.github/ISSUE_TEMPLATE/regression.yaml

@@ -1,92 +0,0 @@
----
-name: 💥 Regression Report
-description: Report unexpected behavior that worked in previous versions
-labels: ["Category: Bug"]
-body:
-  - type: markdown
-    attributes:
-      value: |
-        It's not uncommon that somebody already opened an issue or in the best case it's already fixed but not merged. That's the reason why you should [search](https://github.com/elastic/elasticsearch-js/issues) at first before submitting a new one.
-
-        **Please read this entire template before posting any issue. If you ignore these instructions
-        and post an issue here that does not follow the instructions, your issue might be closed,
-        locked, and assigned the `Category: Not an issue` label.**
-
-  - type: textarea
-    id: report
-    attributes:
-      label: Regression report
-      description: A clear and concise description of what the regression is.
-    validations:
-      required: true
-
-  - type: input
-    id: last-working-version
-    attributes:
-      label: Last working version
-      description: Version of `@elastic/elasticsearch` where this last worked.
-    validations:
-      required: true
-
-  - type: textarea
-    id: to-reproduce
-    attributes:
-      label: To reproduce
-      description: |
-        Paste your code here that shows how to reproduce the behavior.
-
-        In some cases, it might be challenging to reproduce the bug in a few lines of code.
-        You can fork the following repository, which contains all the configuration needed to spin up a three nodes Elasticsearch cluster with security enabled.
-        [This repository](https://github.com/delvedor/es-reproduce-issue) also contains a preconfigured client instance that you can use to reproduce the issue.
-    validations:
-      required: true
-
-  - type: textarea
-    id: expected-behavior
-    attributes:
-      label: Expected behavior
-      description: A clear and concise description of what you expected to happen.
-    validations:
-      required: true
-
-  - type: input
-    id: node-version
-    attributes:
-      label: Node.js version
-      description: What version of Node.js you are using (`node --version`).
-    validations:
-      required: true
-
-  - type: input
-    id: typescript-version
-    attributes:
-      label: TypeScript version
-      description: TypeScript version you are using, if applicable.
-
-  - type: input
-    id: elasticsearch-client-version
-    attributes:
-      label: Elasticsearch client version
-      description: What version of `@elastic/elasticsearch` and `@elastic/transport` you are using (`npm ls -a | grep '@elastic'`).
-    validations:
-      required: true
-
-  - type: input
-    id: elasticsearch-version
-    attributes:
-      label: Elasticsearch server version
-      description: What version of Elasticsearch you are using.
-    validations:
-      required: true
-
-  - type: input
-    id: operating-system
-    attributes:
-      label: Operating system
-      description: What operating system you are running.
-      placeholder: e.g. Linux, MacOS, Windows
-
-  - type: textarea
-    id: env-info
-    attributes:
-      label: Any other relevant environment information.

.github/ISSUE_TEMPLATE/security.md

@@ -0,0 +1,6 @@
+---
+name: 👮 Security Issue
+about: Responsible Disclosure
+---
+
+If you want to report a security issue, please take a look at [elastic/security](https://www.elastic.co/community/security).

.github/ISSUE_TEMPLATE/security.yaml

@@ -1,8 +0,0 @@
----
-name: 👮 Security Issue
-description: Responsible disclosure
-body:
-  - type: markdown
-    attributes:
-      value: |
-        If you want to report a security issue, please take a look at [elastic/security](https://www.elastic.co/community/security).

.github/make.sh

@@ -1,222 +0,0 @@
-#!/usr/bin/env bash
-# ------------------------------------------------------- #
-#
-# Build entry script for elasticsearch-js
-#
-# Must be called: ./.github/make.sh <target> <params>
-#
-# Version: 1.1.0
-#
-# Targets:
-# ---------------------------
-# assemble   <VERSION> : build client artifacts with version
-# bump       <VERSION> : bump client internals to version
-# bumpmatrix <VERSION> : bump stack version in test matrix to version
-# codegen    <VERSION> : generate endpoints
-# docsgen    <VERSION> : generate documentation
-# examplegen           : generate the doc examples
-# clean                : clean workspace
-#
-# ------------------------------------------------------- #
-
-# ------------------------------------------------------- #
-# Bootstrap
-# ------------------------------------------------------- #
-script_path=$(dirname "$(realpath -s "$0")")
-repo=$(realpath "$script_path/../")
-
-# shellcheck disable=SC1090
-CMD=$1
-TASK=$1
-TASK_ARGS=()
-VERSION=$2
-STACK_VERSION=$VERSION
-set -euo pipefail
-
-product="elastic/elasticsearch-js"
-output_folder=".buildkite/output"
-codegen_folder=".buildkite/output"
-OUTPUT_DIR="$repo/${output_folder}"
-NODE_JS_VERSION=22
-WORKFLOW=${WORKFLOW-staging}
-mkdir -p "$OUTPUT_DIR"
-
-echo -e "\033[34;1mINFO:\033[0m PRODUCT ${product}\033[0m"
-echo -e "\033[34;1mINFO:\033[0m VERSION ${STACK_VERSION}\033[0m"
-echo -e "\033[34;1mINFO:\033[0m OUTPUT_DIR ${OUTPUT_DIR}\033[0m"
-
-case $CMD in
-clean)
-  echo -e "\033[36;1mTARGET: clean workspace $output_folder\033[0m"
-  rm -rf "$output_folder"
-  echo -e "\033[32;1mdone.\033[0m"
-  exit 0
-  ;;
-assemble)
-  if [ -v $VERSION ]; then
-    echo -e "\033[31;1mTARGET: assemble -> missing version parameter\033[0m"
-    exit 1
-  fi
-  echo -e "\033[36;1mTARGET: assemble artifact $VERSION\033[0m"
-  TASK=release
-  TASK_ARGS=("$VERSION" "$output_folder")
-  ;;
-codegen)
-  if [ -v "$VERSION" ] || [[ -z "$VERSION" ]]; then
-    # fall back to branch name or `main` if no VERSION is set
-    branch_name=$(git rev-parse --abbrev-ref HEAD)
-    if [[ "$branch_name" =~ ^[0-9]+\.([0-9]+|x) ]]; then
-      echo -e "\033[36;1mTARGET: codegen -> No VERSION argument found, using branch name: \`$branch_name\`\033[0m"
-      VERSION="$branch_name"
-    else
-      echo -e "\033[36;1mTARGET: codegen -> No VERSION argument found, using \`main\`\033[0m"
-      VERSION="main"
-    fi
-  fi
-  if [ "$VERSION" = 'main' ]; then
-    echo -e "\033[36;1mTARGET: codegen API $VERSION\033[0m"
-  else
-    echo -e "\033[36;1mTARGET: codegen API v$VERSION\033[0m"
-  fi
-
-  TASK=codegen
-  TASK_ARGS=("$VERSION")
-  ;;
-docsgen)
-  if [ -v $VERSION ]; then
-    echo -e "\033[31;1mTARGET: docsgen -> missing version parameter\033[0m"
-    exit 1
-  fi
-  echo -e "\033[36;1mTARGET: generate docs for $VERSION\033[0m"
-  TASK=codegen
-  TASK_ARGS=("$VERSION" "$codegen_folder")
-  ;;
-examplesgen)
-  echo -e "\033[36;1mTARGET: generate examples\033[0m"
-  TASK=codegen
-  TASK_ARGS=("$VERSION" "$codegen_folder")
-  ;;
-bump)
-  if [ -v $VERSION ]; then
-    echo -e "\033[31;1mTARGET: bump -> missing version parameter\033[0m"
-    exit 1
-  fi
-  echo -e "\033[36;1mTARGET: bump to version $VERSION\033[0m"
-  TASK=bump
-  TASK_ARGS=("$VERSION")
-  ;;
-bumpmatrix)
-  if [ -v $VERSION ]; then
-    echo -e "\033[31;1mTARGET: bumpmatrix -> missing version parameter\033[0m"
-    exit 1
-  fi
-  echo -e "\033[36;1mTARGET: bump stack in test matrix to version $VERSION\033[0m"
-  TASK=bumpmatrix
-  TASK_ARGS=("$VERSION")
-  ;;
-*)
-  echo -e "\n'$CMD' is not supported right now\n"
-  echo -e "\nUsage:"
-  echo -e "\t $0 release \$VERSION\n"
-  echo -e "\t $0 bump \$VERSION"
-  echo -e "\t $0 codegen \$VERSION"
-  exit 1
-  ;;
-esac
-
-# ------------------------------------------------------- #
-# Build Container
-# ------------------------------------------------------- #
-
-echo -e "\033[34;1mINFO: building $product container\033[0m"
-
-docker build \
-  --file .buildkite/Dockerfile-make \
-  --tag "$product" \
-  --build-arg NODE_JS_VERSION="$NODE_JS_VERSION" \
-  --build-arg "BUILDER_UID=$(id -u)" \
-  --build-arg "BUILDER_GID=$(id -g)" \
-  .
-
-# ------------------------------------------------------- #
-# Run the Container
-# ------------------------------------------------------- #
-
-echo -e "\033[34;1mINFO: running $product container\033[0m"
-
-if [[ -z "${BUILDKITE+x}" ]] && [[ -z "${CI+x}" ]] && [[ -z "${GITHUB_ACTIONS+x}" ]]; then
-  echo -e "\033[34;1mINFO: Running in local mode"
-  docker run \
-    -u "$(id -u):$(id -g)" \
-    --volume "$repo:/usr/src/elasticsearch-js" \
-    --volume /usr/src/elasticsearch-js/node_modules \
-    --volume "$(realpath "$repo/../elastic-client-generator-js"):/usr/src/elastic-client-generator-js" \
-    --env "WORKFLOW=$WORKFLOW" \
-    --name make-elasticsearch-js \
-    --rm \
-    $product \
-    /bin/bash -c "mkdir -p /usr/src/elastic-client-generator-js/output && \
-      node .buildkite/make.mjs --task $TASK ${TASK_ARGS[*]}"
-else
-  echo -e "\033[34;1mINFO: Running in CI mode"
-
-  # determine branch to clone
-  GENERATOR_BRANCH="main"
-  if [[ "$VERSION" == 8.* ]]; then
-    GENERATOR_BRANCH="8.x"
-  fi
-  echo -e "\033[34;1mINFO: Generator branch: $GENERATOR_BRANCH"
-
-  docker run \
-    --volume "$repo:/usr/src/elasticsearch-js" \
-    --volume /usr/src/elasticsearch-js/node_modules \
-    -u "$(id -u):$(id -g)" \
-    --env "WORKFLOW=$WORKFLOW" \
-    --name make-elasticsearch-js \
-    --rm \
-    $product \
-    /bin/bash -c "cd /usr/src && \
-      git clone --branch $GENERATOR_BRANCH https://$CLIENTS_GITHUB_TOKEN@github.com/elastic/elastic-client-generator-js.git && \
-      mkdir -p /usr/src/elastic-client-generator-js/output && \
-      cd /usr/src/elasticsearch-js && \
-      node .buildkite/make.mjs --task $TASK ${TASK_ARGS[*]}"
-fi
-
-# ------------------------------------------------------- #
-# Post Command tasks & checks
-# ------------------------------------------------------- #
-
-if [[ "$CMD" == "assemble" ]]; then
-  if compgen -G ".buildkite/output/*" >/dev/null; then
-    echo -e "\033[32;1mTARGET: successfully assembled client v$VERSION\033[0m"
-  else
-    echo -e "\033[31;1mTARGET: assemble failed, empty workspace!\033[0m"
-    exit 1
-  fi
-fi
-
-if [[ "$CMD" == "bump" ]]; then
-  if [ -n "$(git status --porcelain)" ]; then
-    echo -e "\033[32;1mTARGET: successfully bumped client v$VERSION\033[0m"
-  else
-    echo -e "\033[31;1mTARGET: failed bumped client v$VERSION\033[0m"
-    exit 1
-  fi
-fi
-
-if [[ "$CMD" == "codegen" ]]; then
-  if [ -n "$(git status --porcelain)" ]; then
-    echo -e "\033[32;1mTARGET: successfully generated client v$VERSION\033[0m"
-  else
-    echo -e "\033[31;1mTARGET: failed generating client v$VERSION\033[0m"
-    exit 1
-  fi
-fi
-
-if [[ "$CMD" == "docsgen" ]]; then
-  echo "TODO"
-fi
-
-if [[ "$CMD" == "examplesgen" ]]; then
-  echo "TODO"
-fi

.github/stale.yml

@@ -0,0 +1,26 @@
+# Number of days of inactivity before an issue becomes stale
+daysUntilStale: 15
+
+# Number of days of inactivity before a stale issue is closed
+daysUntilClose: 7
+
+# Issues with these labels will never be considered stale
+exemptLabels:
+  - "discussion"
+  - "feature request"
+  - "bug"
+  - "todo"
+  - "good first issue"
+
+# Label to use when marking an issue as stale
+staleLabel: stale
+
+# Comment to post when marking an issue as stale. Set to `false` to disable
+markComment: |
+  We understand that this might be important for you, but this issue has been automatically marked as stale because it has not had recent activity either from our end or yours.
+  It will be closed if no further activity occurs, please write a comment if you would like to keep this going.
+
+  Note: in the past months we have built a new client, that has just landed in master. If you want to open an issue or a pr for the legacy client, you should do that in https://github.com/elastic/elasticsearch-js-legacy
+
+# Comment to post when closing a stale issue. Set to `false` to disable
+closeComment: false

.github/workflows/comment-on-asciidoc-changes.yml

@@ -1,21 +0,0 @@
----
-name: Comment on PR for .asciidoc changes
-
-on:
-  # We need to use pull_request_target to be able to comment on PRs from forks
-  pull_request_target:
-    types:
-      - synchronize
-      - opened
-      - reopened
-    branches:
-      - main
-      - master
-      - "9.0"
-
-jobs:
-  comment-on-asciidoc-change:
-    permissions:
-      contents: read
-      pull-requests: write
-    uses: elastic/docs-builder/.github/workflows/comment-on-asciidoc-changes.yml@main

.github/workflows/nodejs.yml

@@ -9,17 +9,15 @@ jobs:
     name: Detect files changed
     runs-on: ubuntu-latest
     outputs:
-      src-only: "${{ steps.changes.outputs.src-only }}"
+      src-only: '${{ steps.changes.outputs.src-only }}'
     steps:
-      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
-        with:
-          persist-credentials: false
-      - uses: dorny/paths-filter/@de90cc6fb38fc0963ad72b210f1f284cd68cea36 # v3.0.2
+      - uses: actions/checkout@v4
+      - uses: dorny/paths-filter/@v2.11.1
         id: changes
         with:
           filters: |
             src-only:
-              - '!(**/*.{md,asciidoc,txt}|*.{md,asciidoc,txt}|{docs,.buildkite,scripts}/**/*|catalog-info.yaml)'
+              - '!(**/*.{md,asciidoc,txt}|*.{md,asciidoc,txt}|{docs,.ci,.buildkite,scripts}/**/*|catalog-info.yaml)'
               - '.github/workflows/**'
 
   test:
@@ -32,19 +30,24 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        node-version: [18.x, 20.x, 22.x, 23.x]
+        node-version: [18.x, 20.x]
         os: [ubuntu-latest, windows-latest, macOS-latest]
 
     steps:
-      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
-        with:
-          persist-credentials: false
+      - uses: actions/checkout@v4
 
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4
+        uses: actions/setup-node@v3
         with:
           node-version: ${{ matrix.node-version }}
 
+      # workaround for failing tests on Node.js 14.x
+      # see https://github.com/actions/setup-node/issues/411
+      - name: Force install specific npm version
+        run: |
+          npm install --global npm@8.3.1
+          npm install --global npm@9.7.1
+
       - name: Install
         run: |
           npm install
@@ -57,23 +60,21 @@ jobs:
         run: |
           npm run test:unit
 
-      - name: ECMAScript module test
-        run: |
-          npm run test:esm
-
   license:
     name: License check
     runs-on: ubuntu-latest
 
-    steps:
-      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
-        with:
-          persist-credentials: false
+    strategy:
+      matrix:
+        node-version: [20.x]
 
-      - name: Use Node.js
-        uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v3
         with:
-          node-version: 22.x
+          node-version: ${{ matrix.node-version }}
 
       - name: Install
         run: |
@@ -82,39 +83,3 @@ jobs:
       - name: License checker
         run: |
           npm run license-checker
-
-  test-bun:
-    name: Test Bun
-    runs-on: ${{ matrix.os }}
-    needs: paths-filter
-    # only run if code relevant to unit tests was changed
-    if: needs.paths-filter.outputs.src-only == 'true'
-
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, windows-latest, macOS-latest]
-
-    steps:
-      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
-        with:
-          persist-credentials: false
-
-      - name: Use Bun
-        uses: oven-sh/setup-bun@4bc047ad259df6fc24a6c9b0f9a0cb08cf17fbe5 # v2
-
-      - name: Install
-        run: |
-          bun install
-
-      - name: Lint
-        run: |
-          bun run lint
-
-      - name: Unit test
-        run: |
-          bun run test:unit-bun
-
-      - name: ECMAScript module test
-        run: |
-          bun run test:esm

.github/workflows/npm-publish.yml

@@ -1,41 +0,0 @@
-name: Publish Package to npm
-on:
-  workflow_dispatch:
-    inputs:
-      branch:
-        description: "Git branch to build and publish"
-        required: true
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      id-token: write
-    steps:
-      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
-        with:
-          persist-credentials: false
-          ref: ${{ github.event.inputs.branch }}
-      - uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4
-        with:
-          node-version: "22.x"
-          registry-url: "https://registry.npmjs.org"
-      - run: npm install -g npm
-      - run: npm install
-      - run: npm test
-      - run: npm publish --provenance --access public --tag alpha
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-      - name: Publish version on GitHub
-        run: |
-          version=$(jq -r .version package.json)
-          gh release create \
-            -n "This is a 9.0.0 pre-release alpha. Changes may not be stable." \
-            --latest=false \
-            --prerelease \
-            --target "$BRANCH_NAME" \
-            --title "v$version" \
-            "v$version"
-        env:
-          BRANCH_NAME: ${{ github.event.inputs.branch }}
-          GH_TOKEN: ${{ github.token }}

.github/workflows/serverless-patch.sh

@@ -1,43 +0,0 @@
-#!/usr/bin/env bash
-
-set -exuo pipefail
-
-merge_commit_sha=$(jq -r '.pull_request.merge_commit_sha' "$GITHUB_EVENT_PATH")
-pull_request_id=$(jq -r '.pull_request.number' "$GITHUB_EVENT_PATH")
-pr_shortcode="elastic/elasticsearch-js#$pull_request_id"
-
-# generate patch file
-cd "$GITHUB_WORKSPACE/stack"
-git format-patch -1 --stdout "$merge_commit_sha" > /tmp/patch.diff
-
-# set committer info
-git config --global user.email "elasticmachine@users.noreply.github.com"
-git config --global user.name "Elastic Machine"
-
-# apply patch file
-cd "$GITHUB_WORKSPACE/serverless"
-git am -C1 --reject /tmp/patch.diff || git am --quit
-
-# generate PR body comment
-comment="Patch applied from $pr_shortcode"
-
-# enumerate rejected patches in PR comment
-has_rejects='false'
-for f in ./**/*.rej; do
-  has_rejects='true'
-  comment="$comment
-
-## Rejected patch \`$f\` must be resolved:
-
-\`\`\`diff
-$(cat "$f")
-\`\`\`
-"
-done
-
-# delete .rej files
-rm -fv ./**/*.rej
-
-# send data to output parameters
-echo "$comment" > /tmp/pr_body
-echo "PR_DRAFT=$has_rejects" >> "$GITHUB_OUTPUT"

.github/workflows/serverless-patch.yml

@@ -1,53 +0,0 @@
----
-name: Apply PR changes to serverless
-on:
-  pull_request_target:
-    types:
-      - closed
-      - labeled
-
-jobs:
-  apply-patch:
-    name: Apply patch
-    runs-on: ubuntu-latest
-    # Only react to merged PRs for security reasons.
-    # See https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#pull_request_target.
-    if: >
-      github.event.pull_request.merged
-      && (
-        (
-          github.event.action == 'closed'
-          && contains(github.event.pull_request.labels.*.name, 'apply-to-serverless')
-        )
-        ||
-        (
-          github.event.action == 'labeled'
-          && github.event.label.name == 'apply-to-serverless'
-        )
-      )
-    steps:
-      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
-        with:
-          persist-credentials: false
-          repository: elastic/elasticsearch-js
-          ref: main
-          path: stack
-          fetch-depth: 0
-      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
-        with:
-          persist-credentials: false
-          repository: elastic/elasticsearch-serverless-js
-          ref: main
-          path: serverless
-      - name: Apply patch from stack to serverless
-        id: apply-patch
-        run: $GITHUB_WORKSPACE/stack/.github/workflows/serverless-patch.sh
-      - uses: peter-evans/create-pull-request@67ccf781d68cd99b580ae25a5c18a1cc84ffff1f # v7
-        with:
-          token: ${{ secrets.GH_TOKEN }}
-          path: serverless
-          title: "Apply patch from elastic/elasticsearch-js#${{ github.event.pull_request.number }}"
-          commit-message: "Apply patch from elastic/elasticsearch-js#${{ github.event.pull_request.number }}"
-          body-path: /tmp/pr_body
-          draft: "${{ steps.apply-patch.outputs.PR_DRAFT }}"
-          add-paths: ":!*.rej"

.github/workflows/stale.yml

@@ -1,21 +1,21 @@
 ---
-name: "Close stale issues and PRs"
+name: 'Close stale issues and PRs'
 on:
   schedule:
-    - cron: "30 1 * * *"
+    - cron: '30 1 * * *'
 
 jobs:
   stale:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/stale@5bef64f19d7facfb25b37b414482c7164d639639 # v9
+      - uses: actions/stale@v8
         with:
           stale-issue-label: stale
           stale-pr-label: stale
           days-before-stale: 90
           days-before-close: 14
-          exempt-issue-labels: "good first issue,tracking"
+          exempt-issue-labels: 'good first issue'
           close-issue-label: closed-stale
           close-pr-label: closed-stale
-          stale-issue-message: "This issue is stale because it has been open 90 days with no activity. Remove the `stale` label, or leave a comment, or this will be closed in 14 days."
-          stale-pr-message: "This pull request is stale because it has been open 90 days with no activity. Remove the `stale` label, or leave a comment, or this will be closed in 14 days."
+          stale-issue-message: 'This issue is stale because it has been open 90 days with no activity. Remove the `stale` label, or leave a comment, or this will be closed in 14 days.'
+          stale-pr-message: 'This pull request is stale because it has been open 90 days with no activity. Remove the `stale` label, or leave a comment, or this will be closed in 14 days.'

.gitignore

@@ -63,8 +63,3 @@ test/bundlers/**/bundle.js
 test/bundlers/parcel-test/.parcel-cache
 
 lib
-junit-output
-bun.lockb
-test-results
-processinfo
-.tap

.npmignore

@@ -64,6 +64,7 @@ test
 scripts
 
 # ci configuration
+.ci
 .travis.yml
 .buildkite
 certs
@@ -72,5 +73,3 @@ CODE_OF_CONDUCT.md
 CONTRIBUTING.md
 
 src
-bun.lockb
-.tap

Makefile

@@ -0,0 +1,11 @@
+.PHONY: integration-setup
+integration-setup: integration-cleanup
+	DETACH=true .ci/run-elasticsearch.sh
+
+.PHONY: integration-cleanup
+integration-cleanup:
+	docker container rm --force --volumes instance || true
+
+.PHONY: integration
+integration: integration-setup
+	npm run test:integration

catalog-info.yaml

@@ -6,7 +6,7 @@ metadata:
   name: elasticsearch-js
 spec:
   type: library
-  owner: group:devtools-team
+  owner: group:clients-team
   lifecycle: production
 
 ---
@@ -18,7 +18,7 @@ metadata:
   description: elasticsearch-js - integration tests
 spec:
   type: buildkite-pipeline
-  owner: group:devtools-team
+  owner: group:clients-team
   system: buildkite
   implementation:
     apiVersion: buildkite.elastic.dev/v1
@@ -29,7 +29,7 @@ spec:
       repository: elastic/elasticsearch-js
       pipeline_file: .buildkite/pipeline.yml
       teams:
-        devtools-team:
+        clients-team:
           access_level: MANAGE_BUILD_AND_READ
         everyone:
           access_level: READ_ONLY
@@ -37,14 +37,14 @@ spec:
         build_pull_requests: false
         build_branches: false
       cancel_intermediate_builds: true
-      cancel_intermediate_builds_branch_filter: "!main"
+      cancel_intermediate_builds_branch_filter: '!main'
       schedules:
-        main:
-          branch: "main"
-          cronline: "@daily"
-        8_x:
-          branch: "8.x"
-          cronline: "@daily"
-        8_14:
-          branch: "8.16"
-          cronline: "@daily"
+        main_semi_daily:
+          branch: 'main'
+          cronline: '0 */12 * * *'
+        8_12_semi_daily:
+          branch: '8.12'
+          cronline: '0 */12 * * *'
+        8_11_daily:
+          branch: '8.11'
+          cronline: '@daily'

docs/basic-config.asciidoc

@@ -13,6 +13,7 @@ const client = new Client({
   cloud: { id: '<cloud-id>' },
   auth: { apiKey: 'base64EncodedKey' },
   maxRetries: 5,
+  requestTimeout: 60000,
   sniffOnStart: true
 })
 ----
@@ -81,7 +82,7 @@ _Default:_ `3`
 
 |`requestTimeout`
 |`number` - Max request timeout in milliseconds for each request. +
-_Default:_ No value
+_Default:_ `30000`
 
 |`pingTimeout`
 |`number` - Max ping request timeout in milliseconds for each request. +
@@ -251,19 +252,19 @@ const client = new Client({
 ----
 
 |`disablePrototypePoisoningProtection`
-|`boolean`, `'proto'`, `'constructor'` - The client can protect you against prototype poisoning attacks. Read https://web.archive.org/web/20200319091159/https://hueniverse.com/square-brackets-are-the-enemy-ff5b9fd8a3e8?gi=184a27ee2a08[this article] to learn more about this security concern. If needed, you can enable prototype poisoning protection entirely (`false`) or one of the two checks (`'proto'` or `'constructor'`). For performance reasons, it is disabled by default. Read the `secure-json-parse` https://github.com/fastify/secure-json-parse[documentation] to learn more. +
-_Default:_ `true`
+|`boolean`, `'proto'`, `'constructor'` - By the default the client will protect you against prototype poisoning attacks. Read https://web.archive.org/web/20200319091159/https://hueniverse.com/square-brackets-are-the-enemy-ff5b9fd8a3e8?gi=184a27ee2a08[this article] to learn more. If needed you can disable prototype poisoning protection entirely or one of the two checks. Read the `secure-json-parse` https://github.com/fastify/secure-json-parse[documentation] to learn more. +
+_Default:_ `false`
 
 |`caFingerprint`
 |`string` - If configured, verify that the fingerprint of the CA certificate that has signed the certificate of the server matches the supplied fingerprint. Only accepts SHA256 digest fingerprints. +
 _Default:_ `null`
 
 |`maxResponseSize`
-|`number` - When configured, it verifies that the uncompressed response size is lower than the configured number, if it's higher it will abort the request. It cannot be higher than buffer.constants.MAX_STRING_LENGTH +
+|`number` - When configured, it verifies that the uncompressed response size is lower than the configured number, if it's higher it will abort the request. It cannot be higher than buffer.constants.MAX_STRING_LENTGH +
 _Default:_ `null`
 
 |`maxCompressedResponseSize`
-|`number` - When configured, it verifies that the compressed response size is lower than the configured number, if it's higher it will abort the request. It cannot be higher than buffer.constants.MAX_LENGTH +
+|`number` - When configured, it verifies that the compressed response size is lower than the configured number, if it's higher it will abort the request. It cannot be higher than buffer.constants.MAX_LENTGH +
 _Default:_ `null`
 
 |===

docs/changelog.asciidoc

@@ -1,227 +1,6 @@
 [[changelog-client]]
 == Release notes
 
-[discrete]
-=== 9.0.0
-
-[discrete]
-==== Breaking changes
-
-[discrete]
-===== Drop support for deprecated `body` parameter
-
-In 8.0, the top-level `body` parameter that was available on all API functions <<remove-body-key,was deprecated>>. In 9.0 this property is completely removed.
-
-[discrete]
-===== Remove the default 30-second timeout on all requests sent to Elasticsearch
-
-Setting HTTP timeouts on Elasticsearch requests goes against Elastic's recommendations. See <<timeout-best-practices>> for more information.
-
-[discrete]
-=== 8.17.0
-
-[discrete]
-==== Features
-
-[discrete]
-===== Support for Elasticsearch `v8.17`
-
-You can find all the API changes
-https://www.elastic.co/guide/en/elasticsearch/reference/8.17/release-notes-8.17.0.html[here].
-
-[discrete]
-=== 8.16.3
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Improved support for Elasticsearch `v8.16`
-
-Updated TypeScript types based on fixes and improvements to the Elasticsearch specification.
-
-[discrete]
-=== 8.16.2
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Improved support for Elasticsearch `v8.16`
-
-Updated TypeScript types based on fixes and improvements to the Elasticsearch specification.
-
-[discrete]
-===== Drop testing artifacts from npm package
-
-Tap, the unit testing tool used by this project, was recently upgraded and started writing to a `.tap` directory. Since tests are run prior to an `npm publish` in CI, this directory was being included in the published package and bloating its size.
-
-[discrete]
-=== 8.16.1
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Fix ECMAScript imports
-
-Fixed package configuration to correctly support native ECMAScript `import` syntax.
-
-[discrete]
-=== 8.16.0
-
-[discrete]
-==== Features
-
-[discrete]
-===== Support for Elasticsearch `v8.16`
-
-You can find all the API changes
-https://www.elastic.co/guide/en/elasticsearch/reference/8.16/release-notes-8.16.0.html[here].
-
-[discrete]
-===== Support Apache Arrow in ES|QL helper
-
-The ES|QL helper can now return results as an Apache Arrow `Table` or `RecordBatchReader`, which enables high-performance calculations on ES|QL results, even if the response data is larger than the system's available memory. See <<esql-helper>> for more information.
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Pass prototype poisoning options to serializer correctly
-
-The client's `disablePrototypePoisoningProtection` option was set to `true` by default, but when it was set to any other value it was ignored, making it impossible to enable prototype poisoning protection without providing a custom serializer implementation.
-
-[discrete]
-=== 8.15.3
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Improved support for Elasticsearch `v8.15`
-
-Updated TypeScript types based on fixes and improvements to the Elasticsearch specification.
-
-[discrete]
-===== Drop testing artifacts from npm package
-
-Tap, the unit testing tool, was recently upgraded and started writing to a `.tap` directory. Since tests are run prior to an `npm publish` in CI, this directory was being included in the published package and bloating its size.
-
-[discrete]
-=== 8.15.2
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Improved support for Elasticsearch `v8.15`
-
-Updated TypeScript types based on fixes and improvements to the Elasticsearch specification.
-
-[discrete]
-=== 8.15.1
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Improved support for Elasticsearch `v8.15`
-
-Updated TypeScript types based on fixes and improvements to the Elasticsearch specification.
-
-[discrete]
-=== 8.15.0
-
-[discrete]
-==== Features
-
-[discrete]
-===== Support for Elasticsearch `v8.15.0`
-
-You can find all the API changes
-https://www.elastic.co/guide/en/elasticsearch/reference/8.15/release-notes-8.15.0.html[here].
-
-[discrete]
-===== OpenTelemetry zero-code instrumentation support
-
-For those that use an observability service that supports OpenTelemetry spans, the client will now automatically generate traces for each Elasticsearch request it makes.
-See {jsclient}/observability.html#_opentelemetry[the docs]
-for more information.
-
-[discrete]
-=== 8.14.1
-
-[discrete]
-==== Features
-
-[discrete]
-===== Improved support for Elasticsearch `8.14`
-
-Updated types based on fixes and changes to the Elasticsearch specification.
-
-[discrete]
-=== 8.14.0
-
-[discrete]
-==== Features
-
-[discrete]
-===== Support for Elasticsearch `v8.14.0`
-
-You can find all the API changes
-https://www.elastic.co/guide/en/elasticsearch/reference/8.14/release-notes-8.14.0.html[here].
-
-[discrete]
-===== ES|QL object API helper
-
-A helper method has been added that parses the response of an ES|QL query and converts it into an array of objects.
-A TypeScript type parameter can also be provided to improve developer experience when working with the result. https://github.com/elastic/elasticsearch-js/pull/2238[#2238]
-
-[discrete]
-===== `onSuccess` callback added to bulk helper
-
-The bulk helper now supports an `onSuccess` callback that will be called for each successful operation. https://github.com/elastic/elasticsearch-js/pull/2199[#2199]
-
-[discrete]
-===== Request retries are more polite
-
-https://github.com/elastic/elastic-transport-js/releases/tag/v8.6.0[`@elastic/transport` v8.6.0] was released, which refactored when and how failed requests are retried. Timed-out requests are no longer retried by default, and retries now use exponential backoff rather than running immediately.
-
-
-[discrete]
-=== 8.13.1
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Pin @elastic/transport to `~8.4.1`
-
-Switching from `^8.4.1` to `~8.4.1` ensures 8.13 client users are not required to update to Node.js v18+, which is a new requirement set by `@elastic/transport` v8.5.0. See https://github.com/elastic/elastic-transport-js/issues/91[elastic/elastic-transport-js#91] for details.
-
-v8.13.0 was also released depending on v8.4.0 of `@elastic/transport` instead of v8.4.1, which was unintentional.
-
-[discrete]
-=== 8.13.0
-
-[discrete]
-==== Features
-
-[discrete]
-===== Support for Elasticsearch `v8.13.0`
-
-You can find all the API changes
-https://www.elastic.co/guide/en/elasticsearch/reference/8.13/release-notes-8.13.0.html[here].
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Ensure new connections inherit client's set defaults https://github.com/elastic/elasticsearch-js/pull/2159[#2159]
-
-When instantiating a client, any connection-related defaults (e.g. `requestTimeout`) set on that client instance would not be inherited by nodes if they were entered as strings rather than a `ConnectionOptions` object.
-
 [discrete]
 === 8.12.3
 
@@ -267,6 +46,8 @@ The failing state could be reached when a server's response times are slower tha
 You can find all the API changes
 https://www.elastic.co/guide/en/elasticsearch/reference/8.12/release-notes-8.12.0.html[here].
 
+== Release notes
+
 [discrete]
 === 8.11.1
 
@@ -357,7 +138,7 @@ https://www.elastic.co/guide/en/elasticsearch/reference/8.9/release-notes-8.9.0.
 [discrete]
 ===== Allow document to be overwritten in `onDocument` iteratee of bulk helper https://github.com/elastic/elasticsearch-js/pull/1732[#1732]
 
-In the {jsclient}/client-helpers.html#bulk-helper[bulk helper], documents could not be modified before being sent to Elasticsearch. It is now possible to {jsclient}/client-helpers.html#_modifying_a_document_before_operation[modify a document] before sending it.
+In the https://www.elastic.co/guide/en/elasticsearch/client/javascript-api/current/client-helpers.html#bulk-helper[bulk helper], documents could not be modified before being sent to Elasticsearch. It is now possible to https://www.elastic.co/guide/en/elasticsearch/client/javascript-api/current/client-helpers.html#_modifying_a_document_before_operation[modify a document] before sending it.
 
 [discrete]
 ==== Fixes
@@ -684,7 +465,6 @@ ac.abort()
 ----
 
 [discrete]
-[[remove-body-key]]
 ===== Remove the body key from the request
 
 *Breaking: Yes* | *Migration effort: Small*

docs/child.asciidoc

@@ -28,6 +28,7 @@ const client = new Client({
 })
 const child = client.child({
   headers: { 'x-foo': 'bar' },
+  requestTimeout: 1000
 })
 
 client.info().then(console.log, console.log)

docs/configuration.asciidoc

@@ -7,6 +7,5 @@ section, you can see the possible options that you can use to configure it.
 
 * <<basic-config>>
 * <<advanced-config>>
-* <<timeout-best-practices>>
 * <<child>>
 * <<client-testing>>

docs/connecting.asciidoc

@@ -349,7 +349,7 @@ In this case, the result will be:
   body: object | boolean
   statusCode: number
   headers: object
-  warnings: string[],
+  warnings: [string],
   meta: object
 }
 ----
@@ -410,23 +410,19 @@ The supported request specific options are:
 [cols=2*]
 |===
 |`ignore`
-|`number[]` -  HTTP status codes which should not be considered errors for this request. +
+|`[number]` -  HTTP status codes which should not be considered errors for this request. +
 _Default:_ `null`
 
 |`requestTimeout`
-|`number | string | null` - Max request timeout for the request in milliseconds. This overrides the client default, which is to not time out at all. See https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-network.html#_http_client_configuration[Elasticsearch best practices for HTML clients] for more info. +
-_Default:_ No timeout
-
-|`retryOnTimeout`
-|`boolean` - Retry requests that have timed out.
-_Default:_ `false`
+|`number` - Max request timeout for the request in milliseconds, it overrides the client default. +
+_Default:_ `30000`
 
 |`maxRetries`
 |`number` - Max number of retries for the request, it overrides the client default. +
 _Default:_ `3`
 
 |`compression`
-|`string | boolean` - Enables body compression for the request. +
+|`string, boolean` - Enables body compression for the request. +
 _Options:_ `false`, `'gzip'` +
 _Default:_ `false`
 
@@ -450,10 +446,6 @@ _Default:_ `null`
 |`any` - Custom object per request. _(you can use it to pass data to the clients events)_ +
 _Default:_ `null`
 
-|`opaqueId`
-|`string` - Set the `X-Opaque-Id` HTTP header. See {ref}/api-conventions.html#x-opaque-id
-_Default:_ `null`
-
 |`maxResponseSize`
 |`number` - When configured, it verifies that the uncompressed response size is lower than the configured number, if it's higher it will abort the request. It cannot be higher than buffer.constants.MAX_STRING_LENTGH +
 _Default:_ `null`
@@ -466,17 +458,6 @@ _Default:_ `null`
 |`AbortSignal` - The AbortSignal instance to allow request abortion. +
 _Default:_ `null`
 
-|`meta`
-|`boolean` - Rather than returning the body, return an object containing `body`, `statusCode`, `headers` and `meta` keys +
-_Default_: `false`
-
-|`redaction`
-|`object` - Options for redacting potentially sensitive data from error metadata. See <<redaction>>.
-
-|`retryBackoff`
-|`(min: number, max: number, attempt: number) => number;` - A function that calculates how long to sleep, in seconds, before the next request retry +
-_Default:_ A built-in function that uses exponential backoff with jitter.
-
 |===
 
 [discrete]

docs/doc_examples/00272f75a6afea91f8554ef7cda0c1f2.asciidoc

@@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.security.clearCachedRealms({
-  realms: "default_file,ldap1",
-});
-console.log(response);
-----

docs/doc_examples/004743b9c9f61588926ccf734696b713.asciidoc

@@ -1,11 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.forcemerge({
-  index: ".ds-my-data-stream-2099.03.07-000001",
-  max_num_segments: 1,
-});
-console.log(response);
-----

docs/doc_examples/006e0e16c9f1da58c0bfe57377f7fc38.asciidoc

@@ -1,20 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.create({
-  index: "my-index-000001",
-  settings: {
-    analysis: {
-      analyzer: {
-        my_analyzer: {
-          tokenizer: "whitespace",
-          filter: ["stemmer"],
-        },
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/007179b5e241da650562a5f0a5007823.asciidoc

@@ -1,40 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.watcher.putWatch({
-  id: "cluster_health_watch",
-  trigger: {
-    schedule: {
-      interval: "10s",
-    },
-  },
-  input: {
-    http: {
-      request: {
-        host: "localhost",
-        port: 9200,
-        path: "/_cluster/health",
-      },
-    },
-  },
-  condition: {
-    compare: {
-      "ctx.payload.status": {
-        eq: "red",
-      },
-    },
-  },
-  actions: {
-    send_email: {
-      email: {
-        to: "username@example.org",
-        subject: "Cluster Status Warning",
-        body: "Cluster status is RED",
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/008ed823c89e703c447ac89c6b689833.asciidoc

@@ -1,8 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.migration.postFeatureUpgrade();
-console.log(response);
-----

docs/doc_examples/0091fc75271b1fbbd4269622a4881e8b.asciidoc

@@ -1,16 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.search({
-  index: "my-index",
-  query: {
-    match: {
-      "http.clientip": "40.135.0.0",
-    },
-  },
-  fields: ["http.clientip"],
-});
-console.log(response);
-----

docs/doc_examples/00b3b6d76a368ae71277ea24af318693.asciidoc

@@ -1,8 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.shardStores();
-console.log(response);
-----

docs/doc_examples/00c05aa931fc985985e3e21c93cf43ff.asciidoc

@@ -1,15 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.renderSearchTemplate({
-  source: '{ "query": {{#toJson}}my_query{{/toJson}} }',
-  params: {
-    my_query: {
-      match_all: {},
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/00d65f7b9daa1c6b18eedd8ace206bae.asciidoc

@@ -1,12 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.analyze({
-  tokenizer: "standard",
-  filter: ["asciifolding"],
-  text: "açaí à la carte",
-});
-console.log(response);
-----

docs/doc_examples/00e0c964c79fcc1876ab957da2ffce82.asciidoc

@@ -1,67 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.create({
-  index: "italian_example",
-  settings: {
-    analysis: {
-      filter: {
-        italian_elision: {
-          type: "elision",
-          articles: [
-            "c",
-            "l",
-            "all",
-            "dall",
-            "dell",
-            "nell",
-            "sull",
-            "coll",
-            "pell",
-            "gl",
-            "agl",
-            "dagl",
-            "degl",
-            "negl",
-            "sugl",
-            "un",
-            "m",
-            "t",
-            "s",
-            "v",
-            "d",
-          ],
-          articles_case: true,
-        },
-        italian_stop: {
-          type: "stop",
-          stopwords: "_italian_",
-        },
-        italian_keywords: {
-          type: "keyword_marker",
-          keywords: ["esempio"],
-        },
-        italian_stemmer: {
-          type: "stemmer",
-          language: "light_italian",
-        },
-      },
-      analyzer: {
-        rebuilt_italian: {
-          tokenizer: "standard",
-          filter: [
-            "italian_elision",
-            "lowercase",
-            "italian_stop",
-            "italian_keywords",
-            "italian_stemmer",
-          ],
-        },
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/00fea15cbca83be9d5f1a024ff2ec708.asciidoc

@@ -1,19 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.inference.put({
-  task_type: "text_embedding",
-  inference_id: "my-e5-model",
-  inference_config: {
-    service: "elasticsearch",
-    service_settings: {
-      num_allocations: 1,
-      num_threads: 1,
-      model_id: ".multilingual-e5-small",
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/010d5e901a2690fa7b2396edbe6cd463.asciidoc

@@ -1,13 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.putIndexTemplate({
-  name: "my-data-stream-template",
-  index_patterns: ["my-data-stream*"],
-  data_stream: {},
-  priority: 500,
-});
-console.log(response);
-----

docs/doc_examples/014b788c879e4aaa1020672e45e25473.asciidoc

@@ -4,9 +4,12 @@
 [source, js]
 ----
 const response = await client.cluster.putSettings({
-  persistent: {
-    "xpack.security.transport.filter.enabled": false,
-  },
-});
-console.log(response);
+  body: {
+    transient: {
+      'cluster.routing.use_adaptive_replica_selection': false
+    }
+  }
+})
+console.log(response)
 ----
+

docs/doc_examples/015294a400986295039e52ebc62033be.asciidoc

@@ -4,12 +4,15 @@
 [source, js]
 ----
 const response = await client.update({
-  index: "test",
-  id: 1,
-  doc: {
-    name: "new_name",
-  },
-  doc_as_upsert: true,
-});
-console.log(response);
+  index: 'test',
+  id: '1',
+  body: {
+    doc: {
+      name: 'new_name'
+    },
+    detect_noop: false
+  }
+})
+console.log(response)
 ----
+

docs/doc_examples/015e6e6132b6d6d44bddb06bc3b316ed.asciidoc

@@ -1,46 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.search({
-  index: "retrievers_example",
-  retriever: {
-    rrf: {
-      retrievers: [
-        {
-          standard: {
-            query: {
-              range: {
-                year: {
-                  gt: 2023,
-                },
-              },
-            },
-          },
-        },
-        {
-          standard: {
-            query: {
-              term: {
-                topic: "elastic",
-              },
-            },
-          },
-        },
-      ],
-      rank_window_size: 10,
-      rank_constant: 1,
-    },
-  },
-  _source: false,
-  aggs: {
-    topics: {
-      terms: {
-        field: "topic",
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/0163af36c8472ac0c5160c8b716f5b26.asciidoc

@@ -1,24 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.search({
-  index: "sales",
-  size: 0,
-  filter_path: "aggregations",
-  query: {
-    term: {
-      type: "t-shirt",
-    },
-  },
-  aggs: {
-    avg_price: {
-      avg: {
-        field: "price",
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/0165d22da5f2fc7678392b31d8eb5566.asciidoc

@@ -1,18 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.inference.put({
-  task_type: "rerank",
-  inference_id: "my-rerank-model",
-  inference_config: {
-    service: "cohere",
-    service_settings: {
-      model_id: "rerank-english-v3.0",
-      api_key: "{{COHERE_API_KEY}}",
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/019e329ed5a930aef825266822e7377a.asciidoc

@@ -1,26 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.create({
-  index: "asciifold_example",
-  settings: {
-    analysis: {
-      analyzer: {
-        standard_asciifolding: {
-          tokenizer: "standard",
-          filter: ["my_ascii_folding"],
-        },
-      },
-      filter: {
-        my_ascii_folding: {
-          type: "asciifolding",
-          preserve_original: true,
-        },
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/01ae196538fac197eedbbf458a4ef31b.asciidoc

@@ -1,36 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.create({
-  index: "idx",
-  settings: {
-    index: {
-      mapping: {
-        source: {
-          mode: "synthetic",
-        },
-      },
-    },
-  },
-  mappings: {
-    properties: {
-      kwd: {
-        type: "keyword",
-        ignore_above: 3,
-      },
-    },
-  },
-});
-console.log(response);
-
-const response1 = await client.index({
-  index: "idx",
-  id: 1,
-  document: {
-    kwd: ["foo", "foo", "bang", "bar", "baz"],
-  },
-});
-console.log(response1);
-----

docs/doc_examples/01b23f09d2b7f140faf649eadbbf3ac3.asciidoc

@@ -1,37 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.cluster.putComponentTemplate({
-  name: "component_template1",
-  template: {
-    mappings: {
-      properties: {
-        "@timestamp": {
-          type: "date",
-        },
-      },
-    },
-  },
-});
-console.log(response);
-
-const response1 = await client.cluster.putComponentTemplate({
-  name: "runtime_component_template",
-  template: {
-    mappings: {
-      runtime: {
-        day_of_week: {
-          type: "keyword",
-          script: {
-            source:
-              "emit(doc['@timestamp'].value.dayOfWeekEnum.getDisplayName(TextStyle.FULL, Locale.ENGLISH))",
-          },
-        },
-      },
-    },
-  },
-});
-console.log(response1);
-----

docs/doc_examples/01bc0f2ed30eb3dd23511d01ce0ac6e1.asciidoc

@@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.transform.startTransform({
-  transform_id: "ecommerce_transform",
-});
-console.log(response);
-----

docs/doc_examples/01cd0ea360282a2c591a366679d7187d.asciidoc

@@ -1,12 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.tasks.list({
-  human: "true",
-  detailed: "true",
-  actions: "indices:data/write/bulk",
-});
-console.log(response);
-----

docs/doc_examples/01dc7bdc223bd651574ed2d3954a5b1c.asciidoc

@@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.watcher.executeWatch({
-  id: "my_watch",
-});
-console.log(response);
-----

docs/doc_examples/01f50acf7998b24969f451e922d145eb.asciidoc

@@ -1,39 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.create({
-  index: "basque_example",
-  settings: {
-    analysis: {
-      filter: {
-        basque_stop: {
-          type: "stop",
-          stopwords: "_basque_",
-        },
-        basque_keywords: {
-          type: "keyword_marker",
-          keywords: ["Adibidez"],
-        },
-        basque_stemmer: {
-          type: "stemmer",
-          language: "basque",
-        },
-      },
-      analyzer: {
-        rebuilt_basque: {
-          tokenizer: "standard",
-          filter: [
-            "lowercase",
-            "basque_stop",
-            "basque_keywords",
-            "basque_stemmer",
-          ],
-        },
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/020c95db88ef356093f03be84893ddf9.asciidoc

@@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.ccr.followStats({
-  index: "<index>",
-});
-console.log(response);
-----

docs/doc_examples/020de6b6cb960a76297452725a38889f.asciidoc

@@ -1,20 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.search({
-  query: {
-    has_child: {
-      type: "child",
-      query: {
-        match_all: {},
-      },
-      max_children: 10,
-      min_children: 2,
-      score_mode: "min",
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/025155da86802ebf4c3aeee5aab692f9.asciidoc

@@ -1,28 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.create({
-  index: "sales",
-  mappings: {
-    properties: {
-      tags: {
-        type: "keyword",
-      },
-      comments: {
-        type: "nested",
-        properties: {
-          username: {
-            type: "keyword",
-          },
-          comment: {
-            type: "text",
-          },
-        },
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/02520ac7816b2c4cf8fb413fd16122f2.asciidoc

@@ -1,11 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.ml.flushJob({
-  job_id: "low_request_rate",
-  calc_interim: true,
-});
-console.log(response);
-----

docs/doc_examples/025b54db0edc50c24ea48a2bd94366ad.asciidoc

@@ -0,0 +1,14 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: 'twitter',
+  size: '0',
+  q: 'extra:test',
+  filter_path: 'hits.total'
+})
+console.log(response)
+----
+

docs/doc_examples/0264e994a7e68561e2ca6be0f0d90ee9.asciidoc

@@ -1,23 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.search({
-  aggs: {
-    JapaneseCars: {
-      terms: {
-        field: "make",
-        include: ["mazda", "honda"],
-      },
-    },
-    ActiveCarManufacturers: {
-      terms: {
-        field: "make",
-        exclude: ["rover", "jensen"],
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/0280247e0cf2e561c548f22c9fb31163.asciidoc

@@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.security.invalidateToken({
-  username: "myuser",
-});
-console.log(response);
-----

docs/doc_examples/02853293a5b7cd9cc7a886eb413bbeb6.asciidoc

@@ -1,28 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.analyze({
-  tokenizer: "keyword",
-  char_filter: [
-    {
-      type: "mapping",
-      mappings: [
-        "٠ => 0",
-        "١ => 1",
-        "٢ => 2",
-        "٣ => 3",
-        "٤ => 4",
-        "٥ => 5",
-        "٦ => 6",
-        "٧ => 7",
-        "٨ => 8",
-        "٩ => 9",
-      ],
-    },
-  ],
-  text: "My license plate is ٢٥٠١٥",
-});
-console.log(response);
-----

docs/doc_examples/028f6d6ac2594e20b78b8a8f8cbad49d.asciidoc

@@ -0,0 +1,43 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  body: {
+    aggs: {
+      countries: {
+        terms: {
+          field: 'artist.country',
+          order: [
+            {
+              'rock>playback_stats.avg': 'desc'
+            },
+            {
+              _count: 'desc'
+            }
+          ]
+        },
+        aggs: {
+          rock: {
+            filter: {
+              term: {
+                genre: 'rock'
+              }
+            },
+            aggs: {
+              playback_stats: {
+                stats: {
+                  field: 'play_count'
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+})
+console.log(response)
+----
+

docs/doc_examples/029de2f5383a42e1ac4ca1565bd2a130.asciidoc

@@ -1,21 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.create({
-  index: "my-index-000001",
-  mappings: {
-    properties: {
-      full_name: {
-        type: "text",
-        index_prefixes: {
-          min_chars: 1,
-          max_chars: 10,
-        },
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/02c48d461536709c3fc8a0e8147c3787.asciidoc

@@ -1,24 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.ingest.putPipeline({
-  id: "pipelineB",
-  description: "outer pipeline",
-  processors: [
-    {
-      pipeline: {
-        name: "pipelineA",
-      },
-    },
-    {
-      set: {
-        field: "outer_pipeline_set",
-        value: "outer",
-      },
-    },
-  ],
-});
-console.log(response);
-----

docs/doc_examples/02f65c6bab8f40bf3ce18160623d1870.asciidoc

@@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.getTemplate({
-  name: "template_1",
-});
-console.log(response);
-----

docs/doc_examples/02fad6b80bb29c2a7e6840db2fc67b18.asciidoc

@@ -1,38 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.create({
-  index: "my-index-000001",
-  mappings: {
-    properties: {
-      my_wildcard: {
-        type: "wildcard",
-      },
-    },
-  },
-});
-console.log(response);
-
-const response1 = await client.index({
-  index: "my-index-000001",
-  id: 1,
-  document: {
-    my_wildcard: "This string can be quite lengthy",
-  },
-});
-console.log(response1);
-
-const response2 = await client.search({
-  index: "my-index-000001",
-  query: {
-    wildcard: {
-      my_wildcard: {
-        value: "*quite*lengthy",
-      },
-    },
-  },
-});
-console.log(response2);
-----

docs/doc_examples/032eac56b798bea29390e102538f4a26.asciidoc

@@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.refresh({
-  index: "my-index-000001,my-index-000002",
-});
-console.log(response);
-----

docs/doc_examples/033778305d52746f5ce0a2a922c8e521.asciidoc

@@ -0,0 +1,22 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  body: {
+    aggs: {
+      genres: {
+        terms: {
+          script: {
+            source: "doc['genre'].value",
+            lang: 'painless'
+          }
+        }
+      }
+    }
+  }
+})
+console.log(response)
+----
+

docs/doc_examples/033838729cfb5d1a28d04f69ee78d924.asciidoc

@@ -1,26 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.index({
-  index: "example",
-  document: {
-    location: {
-      type: "Polygon",
-      orientation: "LEFT",
-      coordinates: [
-        [
-          [-177, 10],
-          [176, 15],
-          [172, 0],
-          [176, -15],
-          [-177, -10],
-          [-177, 10],
-        ],
-      ],
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/0350410d11579f4e876c798ce1eaef5b.asciidoc

@@ -1,36 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.index({
-  index: "my-index-000001",
-  id: 5,
-  refresh: "true",
-  document: {
-    query: {
-      bool: {
-        should: [
-          {
-            match: {
-              message: {
-                query: "Japanese art",
-                _name: "query1",
-              },
-            },
-          },
-          {
-            match: {
-              message: {
-                query: "Holand culture",
-                _name: "query2",
-              },
-            },
-          },
-        ],
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/0350ff5ebb8207c004eb771088339cb4.asciidoc

@@ -1,38 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.search({
-  index: "example-index",
-  retriever: {
-    rrf: {
-      retrievers: [
-        {
-          standard: {
-            query: {
-              term: {
-                text: "blue shoes sale",
-              },
-            },
-          },
-        },
-        {
-          standard: {
-            query: {
-              sparse_vector: {
-                field: "ml.tokens",
-                inference_id: "my_elser_model",
-                query: "What blue shoes are on sale?",
-              },
-            },
-          },
-        },
-      ],
-      rank_window_size: 50,
-      rank_constant: 20,
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/03582fc93683e573062bcfda45e01d69.asciidoc

@@ -1,29 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.create({
-  index: "my-index-000001",
-  settings: {
-    analysis: {
-      analyzer: {
-        my_custom_analyzer: {
-          type: "custom",
-          tokenizer: "standard",
-          char_filter: ["html_strip"],
-          filter: ["lowercase", "asciifolding"],
-        },
-      },
-    },
-  },
-});
-console.log(response);
-
-const response1 = await client.indices.analyze({
-  index: "my-index-000001",
-  analyzer: "my_custom_analyzer",
-  text: "Is this déjà vu</b>?",
-});
-console.log(response1);
-----

docs/doc_examples/035a7a919eb6513b4769a3727b7d6447.asciidoc

@@ -1,11 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.analyze({
-  analyzer: "whitespace",
-  text: "The quick brown fox.",
-});
-console.log(response);
-----

docs/doc_examples/03891265df2111a38e0b6b24c1b967e1.asciidoc

@@ -1,8 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.security.getServiceAccounts();
-console.log(response);
-----

docs/doc_examples/03b1d76fa0b773d5b7d74ecb7e1e1a80.asciidoc

@@ -1,14 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.snapshot.restore({
-  repository: "my_repository",
-  snapshot: "my_snapshot_2099.05.06",
-  indices: "my-index,logs-my_app-default",
-  rename_pattern: "(.+)",
-  rename_replacement: "restored-$1",
-});
-console.log(response);
-----

docs/doc_examples/03c4b815bf1e6a8c5cfcc6ddf94bc093.asciidoc

@@ -1,11 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.sql.query({
-  format: "txt",
-  query: "SELECT * FROM library ORDER BY page_count DESC LIMIT 5",
-});
-console.log(response);
-----

docs/doc_examples/04412d11783dac25b5fd2ec5407078a3.asciidoc

@@ -1,12 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.connector.updateApiKeyId({
-  connector_id: "my-connector",
-  api_key_id: "my-api-key-id",
-  api_key_secret_id: "my-connector-secret-id",
-});
-console.log(response);
-----

docs/doc_examples/044b2f99e7438e408685b258db17f863.asciidoc

@@ -1,12 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.eql.search({
-  index: "my-data-stream",
-  query: '\n    process where process.name == "regsvr32.exe"\n  ',
-  size: 50,
-});
-console.log(response);
-----

docs/doc_examples/046b2249bbc49e77848c114cee940f17.asciidoc

@@ -1,52 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.search({
-  index: "my-index",
-  retriever: {
-    rrf: {
-      retrievers: [
-        {
-          standard: {
-            query: {
-              multi_match: {
-                query: "How is the weather in Jamaica?",
-                fields: ["title", "description"],
-              },
-            },
-          },
-        },
-        {
-          standard: {
-            query: {
-              text_expansion: {
-                "ml.inference.title_expanded.predicted_value": {
-                  model_id: ".elser_model_2",
-                  model_text: "How is the weather in Jamaica?",
-                },
-              },
-            },
-          },
-        },
-        {
-          standard: {
-            query: {
-              text_expansion: {
-                "ml.inference.description_expanded.predicted_value": {
-                  model_id: ".elser_model_2",
-                  model_text: "How is the weather in Jamaica?",
-                },
-              },
-            },
-          },
-        },
-      ],
-      window_size: 10,
-      rank_constant: 20,
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/0470d7101637568b9d3d1239f06325a7.asciidoc

@@ -1,27 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.transport.request({
-  method: "PUT",
-  path: "/_internal/desired_nodes/<history_id>/<version>",
-  body: {
-    nodes: [
-      {
-        settings: {
-          "node.name": "instance-000187",
-          "node.external_id": "instance-000187",
-          "node.roles": ["data_hot", "master"],
-          "node.attr.data": "hot",
-          "node.attr.logical_availability_zone": "zone-0",
-        },
-        processors: 8,
-        memory: "58gb",
-        storage: "2tb",
-      },
-    ],
-  },
-});
-console.log(response);
-----

docs/doc_examples/047266b0d20fdb62ebc72d51952c8f6d.asciidoc

@@ -4,14 +4,20 @@
 [source, js]
 ----
 const response = await client.search({
-  query: {
-    multi_match: {
-      query: "Will Smith",
-      type: "cross_fields",
-      fields: ["first_name", "last_name"],
-      operator: "and",
-    },
-  },
-});
-console.log(response);
+  body: {
+    query: {
+      multi_match: {
+        query: 'Will Smith',
+        type: 'cross_fields',
+        fields: [
+          'first_name',
+          'last_name'
+        ],
+        operator: 'and'
+      }
+    }
+  }
+})
+console.log(response)
 ----
+

docs/doc_examples/048652b6abfe195da8ea8cef10ee01b1.asciidoc

@@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.transform.resetTransform({
-  transform_id: "ecommerce_transform",
-});
-console.log(response);
-----

docs/doc_examples/048d8abd42d094bbdcf4452a58ccb35b.asciidoc

@@ -0,0 +1,17 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.create({
+  index: 'twitter',
+  id: '1',
+  body: {
+    user: 'kimchy',
+    post_date: '2009-11-15T14:12:12',
+    message: 'trying out Elasticsearch'
+  }
+})
+console.log(response)
+----
+

docs/doc_examples/04d586a536061ec1045d0bb2dc3d1a5f.asciidoc

@@ -1,31 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.ingest.putPipeline({
-  id: "set_os",
-  description: "sets the value of host.os.name from the field os",
-  processors: [
-    {
-      set: {
-        field: "host.os.name",
-        value: "{{{os}}}",
-      },
-    },
-  ],
-});
-console.log(response);
-
-const response1 = await client.ingest.simulate({
-  id: "set_os",
-  docs: [
-    {
-      _source: {
-        os: "Ubuntu",
-      },
-    },
-  ],
-});
-console.log(response1);
-----

docs/doc_examples/04d6ce0c903bd468afbecd3aa1c4a78a.asciidoc

@@ -1,27 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.ingest.putPipeline({
-  id: "my-pipeline-id",
-  description: "My optional pipeline description",
-  processors: [
-    {
-      set: {
-        description: "My optional processor description",
-        field: "my-keyword-field",
-        value: "foo",
-      },
-    },
-  ],
-  _meta: {
-    reason: "set my-keyword-field to foo",
-    serialization: {
-      class: "MyPipeline",
-      id: 10,
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/04de2e3a9c00c2056b07bf9cf9e63a99.asciidoc

@@ -1,20 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.inference.put({
-  task_type: "text_embedding",
-  inference_id: "google_vertex_ai_embeddings",
-  inference_config: {
-    service: "googlevertexai",
-    service_settings: {
-      service_account_json: "<service_account_json>",
-      model_id: "<model_id>",
-      location: "<location>",
-      project_id: "<project_id>",
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/04f5dd677c777bcb15d7d5fa63275fc8.asciidoc

@@ -4,8 +4,9 @@
 [source, js]
 ----
 const response = await client.cluster.health({
-  wait_for_status: "yellow",
-  timeout: "50s",
-});
-console.log(response);
+  wait_for_status: 'yellow',
+  timeout: '50s'
+})
+console.log(response)
 ----
+

docs/doc_examples/04fe1e3a0047b0cdb10987b79fc3f3f3.asciidoc

@@ -0,0 +1,30 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  body: {
+    query: {
+      term: {
+        user: 'kimchy'
+      }
+    },
+    sort: {
+      _script: {
+        type: 'number',
+        script: {
+          lang: 'painless',
+          source: "doc['field_name'].value * params.factor",
+          params: {
+            factor: 1.1
+          }
+        },
+        order: 'asc'
+      }
+    }
+  }
+})
+console.log(response)
+----
+

docs/doc_examples/0502284d4685c478eb68761f979f4303.asciidoc

@@ -1,37 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.ml.evaluateDataFrame({
-  index: "house_price_predictions",
-  query: {
-    bool: {
-      filter: [
-        {
-          term: {
-            "ml.is_training": false,
-          },
-        },
-      ],
-    },
-  },
-  evaluation: {
-    regression: {
-      actual_field: "price",
-      predicted_field: "ml.price_prediction",
-      metrics: {
-        r_squared: {},
-        mse: {},
-        msle: {
-          offset: 10,
-        },
-        huber: {
-          delta: 1.5,
-        },
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/050b3947025fee403232b8e6e9112dab.asciidoc

@@ -1,12 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.sql.query({
-  format: "yaml",
-  query: "SELECT * FROM library ORDER BY page_count DESC",
-  fetch_size: 5,
-});
-console.log(response);
-----

docs/doc_examples/05148cc541f447486d9daf15ab77292b.asciidoc

@@ -1,54 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.ilm.putLifecycle({
-  name: "logs",
-  policy: {
-    phases: {
-      hot: {
-        actions: {
-          rollover: {
-            max_primary_shard_size: "50gb",
-          },
-        },
-      },
-      warm: {
-        min_age: "30d",
-        actions: {
-          shrink: {
-            number_of_shards: 1,
-          },
-          forcemerge: {
-            max_num_segments: 1,
-          },
-        },
-      },
-      cold: {
-        min_age: "60d",
-        actions: {
-          searchable_snapshot: {
-            snapshot_repository: "found-snapshots",
-          },
-        },
-      },
-      frozen: {
-        min_age: "90d",
-        actions: {
-          searchable_snapshot: {
-            snapshot_repository: "found-snapshots",
-          },
-        },
-      },
-      delete: {
-        min_age: "735d",
-        actions: {
-          delete: {},
-        },
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/0518c673094fb18ecb491a3b78af4695.asciidoc

@@ -1,23 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.ilm.putLifecycle({
-  name: "my_policy",
-  policy: {
-    phases: {
-      warm: {
-        actions: {
-          allocate: {
-            include: {
-              box_type: "hot,warm",
-            },
-          },
-        },
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/05284c8ea91769c09c8db47db8a6629a.asciidoc

@@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.cat.repositories({
-  v: "true",
-});
-console.log(response);
-----