Prep 8.15.2 for release (#2443)

Co-authored-by: Josh Mock <joshua.mock@elastic.co>

.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/Dockerfile-make

@@ -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 . .

.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.15.0
     matrix:
       setup:
         suite:

.dockerignore

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

.github/ISSUE_TEMPLATE/bug.md

@@ -0,0 +1,50 @@
+---
+name: 🐛 Bug report
+about: Create a report to help us improve
+labels: ["Category: Bug"]
+---
+
+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.**
+
+## 🐛 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,23 @@
+---
+name: 🚀 Feature Proposal
+about: Submit a proposal for a new feature
+labels: ["Category: 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 `Category: Not an issue` 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,11 @@
+---
+name: 💬 Questions / Help
+about: If you have questions, please check our Gitter or Help repo
+labels: ["Category: Question"]
+---
+
+## 💬 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/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

@@ -37,7 +37,7 @@ product="elastic/elasticsearch-js"
 output_folder=".buildkite/output"
 codegen_folder=".buildkite/output"
 OUTPUT_DIR="$repo/${output_folder}"
-NODE_JS_VERSION=22
+NODE_JS_VERSION=18
 WORKFLOW=${WORKFLOW-staging}
 mkdir -p "$OUTPUT_DIR"
 
@@ -46,84 +46,84 @@ 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
+    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
-  ;;
+        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
 # ------------------------------------------------------- #
@@ -150,7 +150,7 @@ if [[ -z "${BUILDKITE+x}" ]] && [[ -z "${CI+x}" ]] && [[ -z "${GITHUB_ACTIONS+x}
     -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" \
+    --volume "$(realpath $repo/../elastic-client-generator-js):/usr/src/elastic-client-generator-js" \
     --env "WORKFLOW=$WORKFLOW" \
     --name make-elasticsearch-js \
     --rm \
@@ -159,14 +159,6 @@ if [[ -z "${BUILDKITE+x}" ]] && [[ -z "${CI+x}" ]] && [[ -z "${GITHUB_ACTIONS+x}
       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 \
@@ -176,7 +168,7 @@ else
     --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 && \
+      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 .buildkite/make.mjs --task $TASK ${TASK_ARGS[*]}"
@@ -187,36 +179,36 @@ fi
 # ------------------------------------------------------- #
 
 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
+	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"
+		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"
+		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"
+		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"
+		echo -e "\033[31;1mTARGET: failed generating client v$VERSION\033[0m"
     exit 1
   fi
 fi
 
 if [[ "$CMD" == "docsgen" ]]; then
-  echo "TODO"
+    echo "TODO"
 fi
 
 if [[ "$CMD" == "examplesgen" ]]; then
-  echo "TODO"
+    echo "TODO"
 fi

.github/workflows/auto-merge.yml

@@ -0,0 +1,18 @@
+name: Automerge
+
+on:
+  pull_request_review:
+    types:
+      - submitted
+
+jobs:
+  automerge:
+    runs-on: ubuntu-latest
+    if: github.event.review.state == 'approved'
+    steps:
+      - uses: reitermarkus/automerge@v2
+        with:
+          token: ${{ secrets.GH_TOKEN }}
+          merge-method: squash
+          pull-request-author-associations: OWNER
+          review-author-associations: OWNER,CONTRIBUTOR

.github/workflows/nodejs.yml

@@ -12,9 +12,7 @@ jobs:
       src-only: "${{ steps.changes.outputs.src-only }}"
     steps:
       - uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-      - uses: dorny/paths-filter/@v3.0.2
+      - uses: dorny/paths-filter/@v2.11.1
         id: changes
         with:
           filters: |
@@ -32,13 +30,11 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        node-version: [18.x, 20.x, 22.x, 23.x]
+        node-version: [18.x, 20.x, 22.x]
         os: [ubuntu-latest, windows-latest, macOS-latest]
 
     steps:
       - uses: actions/checkout@v4
-        with:
-          persist-credentials: false
 
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
@@ -57,18 +53,12 @@ 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@v4
-        with:
-          persist-credentials: false
 
       - name: Use Node.js
         uses: actions/setup-node@v4
@@ -83,42 +73,6 @@ jobs:
         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@v4
-        with:
-          persist-credentials: false
-
-      - name: Use Bun
-        uses: oven-sh/setup-bun@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
-
   auto-approve:
     name: Auto-approve
     needs: [test, license]

.github/workflows/npm-publish.yml

@@ -9,16 +9,15 @@ jobs:
   build:
     runs-on: ubuntu-latest
     permissions:
-      contents: write
+      contents: read
       id-token: write
     steps:
       - uses: actions/checkout@v4
         with:
-          persist-credentials: false
           ref: ${{ github.event.inputs.branch }}
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v3
         with:
-          node-version: "22.x"
+          node-version: "20.x"
           registry-url: "https://registry.npmjs.org"
       - run: npm install -g npm
       - run: npm install

.github/workflows/serverless-patch.yml

@@ -28,14 +28,12 @@ jobs:
     steps:
       - uses: actions/checkout@v4
         with:
-          persist-credentials: false
           repository: elastic/elasticsearch-js
           ref: main
           path: stack
           fetch-depth: 0
       - uses: actions/checkout@v4
         with:
-          persist-credentials: false
           repository: elastic/elasticsearch-serverless-js
           ref: main
           path: serverless
@@ -46,8 +44,8 @@ jobs:
         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 }}"
+          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"
+          draft: '${{ steps.apply-patch.outputs.PR_DRAFT }}'
+          add-paths: ':!*.rej'

.gitignore

@@ -67,4 +67,3 @@ junit-output
 bun.lockb
 test-results
 processinfo
-.tap

.npmignore

@@ -72,5 +72,3 @@ CODE_OF_CONDUCT.md
 CONTRIBUTING.md
 
 src
-bun.lockb
-.tap

docs/basic-config.asciidoc

@@ -252,8 +252,8 @@ 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. +

docs/changelog.asciidoc

@@ -1,90 +1,11 @@
 [[changelog-client]]
 == Release notes
 
-[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
+==== Features
 
 [discrete]
 ===== Improved support for Elasticsearch `v8.15`
@@ -95,7 +16,7 @@ Updated TypeScript types based on fixes and improvements to the Elasticsearch sp
 === 8.15.1
 
 [discrete]
-==== Fixes
+==== Features
 
 [discrete]
 ===== Improved support for Elasticsearch `v8.15`

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` - Max request timeout for the request in milliseconds, it overrides the client default. +
+|`number` - Max request timeout for the request in milliseconds, it overrides the client default. +
 _Default:_ `30000`
 
-|`retryOnTimeout`
-|`boolean` - Retry requests that have timed out.
-_Default:_ `false`
-
 |`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/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/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/0bc6155e0c88062a4d8490da49db3aa8.asciidoc

@@ -1,49 +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_nested",
-  retriever: {
-    rrf: {
-      retrievers: [
-        {
-          standard: {
-            query: {
-              nested: {
-                path: "nested_field",
-                inner_hits: {
-                  name: "nested_vector",
-                  _source: false,
-                  fields: ["nested_field.paragraph_id"],
-                },
-                query: {
-                  knn: {
-                    field: "nested_field.nested_vector",
-                    query_vector: [1, 0, 0.5],
-                    k: 10,
-                  },
-                },
-              },
-            },
-          },
-        },
-        {
-          standard: {
-            query: {
-              term: {
-                topic: "ai",
-              },
-            },
-          },
-        },
-      ],
-      rank_window_size: 10,
-      rank_constant: 1,
-    },
-  },
-  _source: ["topic"],
-});
-console.log(response);
-----

docs/doc_examples/0bee07a581c5776e068f6f4efad5a399.asciidoc

@@ -3,12 +3,8 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_query/async",
-  querystring: {
-    format: "json",
-  },
+const response = await client.esql.asyncQuery({
+  format: "json",
   body: {
     query:
       "\n    FROM my-index-000001,cluster_one:my-index-000001,cluster_two:my-index*\n    | STATS COUNT(http.response.status_code) BY user.id\n    | LIMIT 2\n  ",

docs/doc_examples/0d689ac6e78be5d438f9b5d441be2b44.asciidoc

@@ -1,57 +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: {
-              term: {
-                topic: "elastic",
-              },
-            },
-          },
-        },
-        {
-          rrf: {
-            retrievers: [
-              {
-                standard: {
-                  query: {
-                    query_string: {
-                      query:
-                        "(information retrieval) OR (artificial intelligence)",
-                      default_field: "text",
-                    },
-                  },
-                },
-              },
-              {
-                knn: {
-                  field: "vector",
-                  query_vector: [0.23, 0.67, 0.89],
-                  k: 3,
-                  num_candidates: 5,
-                },
-              },
-            ],
-            rank_window_size: 10,
-            rank_constant: 1,
-          },
-        },
-      ],
-      rank_window_size: 10,
-      rank_constant: 1,
-    },
-  },
-  _source: false,
-  size: 1,
-  explain: true,
-});
-console.log(response);
-----

docs/doc_examples/0dfde6a9d953822fd4b3aa0121ddd8fb.asciidoc

@@ -3,9 +3,8 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_application/search_application/my-app/_render_query",
+const response = await client.searchApplication.renderQuery({
+  name: "my-app",
   body: {
     params: {
       query_string: "my first query",

docs/doc_examples/160986f49758f4e8345d183a842f6351.asciidoc

@@ -10,7 +10,7 @@ const response = await client.ingest.putPipeline({
     {
       attachment: {
         field: "data",
-        remove_binary: true,
+        remove_binary: false,
       },
     },
   ],

docs/doc_examples/16634cfa7916cf4e8048a1d70e6240f2.asciidoc

@@ -11,7 +11,7 @@ const response = await client.searchApplication.put({
       script: {
         lang: "mustache",
         source:
-          '\n        {\n          "query": {\n            "bool": {\n              "must": [\n              {{#query}}\n              {{/query}}\n            ],\n            "filter": {{#toJson}}_es_filters{{/toJson}}\n            }\n          },\n          "_source": {\n            "includes": ["title", "plot"]\n            },\n            "highlight": {\n              "fields": {\n                "title": { "fragment_size": 0 },\n                "plot": { "fragment_size": 200 }\n                }\n                },\n                "aggs": {{#toJson}}_es_aggs{{/toJson}},\n                "from": {{from}},\n                "size": {{size}},\n                "sort": {{#toJson}}_es_sort_fields{{/toJson}}\n                }\n                ',
+          '\n        {\n          "query": {\n            "bool": {\n              "must": [\n              {{#query}}\n                \n              {{/query}}\n            ],\n            "filter": {{#toJson}}_es_filters{{/toJson}}\n            }\n          },\n          "_source": {\n            "includes": ["title", "plot"]\n            },\n            "highlight": {\n              "fields": {\n                "title": { "fragment_size": 0 },\n                "plot": { "fragment_size": 200 }\n                }\n                },\n                "aggs": {{#toJson}}_es_aggs{{/toJson}},\n                "from": {{from}},\n                "size": {{size}},\n                "sort": {{#toJson}}_es_sort_fields{{/toJson}}\n                }\n                ',
         params: {
           query: "",
           _es_filters: {},

docs/doc_examples/191074b2eebd5f74e628c2ada4b6d2e4.asciidoc

@@ -8,6 +8,11 @@ const response = await client.search({
   query: {
     bool: {
       must: [
+        {
+          term: {
+            "category.keyword": "Main Course",
+          },
+        },
         {
           term: {
             tags: "vegetarian",
@@ -22,11 +27,6 @@ const response = await client.search({
         },
       ],
       should: [
-        {
-          term: {
-            category: "Main Course",
-          },
-        },
         {
           multi_match: {
             query: "curry spicy",

docs/doc_examples/19c00c6b29bc7dbc5e92b3668da2da93.asciidoc

@@ -3,9 +3,7 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_ingest/_simulate",
+const response = await client.simulate.ingest({
   body: {
     docs: [
       {

docs/doc_examples/19d60e4890cc57151d596326484d9076.asciidoc

@@ -5,7 +5,7 @@
 ----
 const response = await client.transport.request({
   method: "DELETE",
-  path: "/_ingest/ip_location/database/my-database-id",
+  path: "/_ingest/geoip/database/my-database-id",
 });
 console.log(response);
 ----

docs/doc_examples/19f1f9f25933f8e7aba59a10881c648b.asciidoc

@@ -9,6 +9,7 @@ const response = await client.indices.create({
     properties: {
       inference_field: {
         type: "semantic_text",
+        inference_id: "my-elser-endpoint",
       },
     },
   },

docs/doc_examples/2577acb462b95bd4394523cf2f8a661f.asciidoc

@@ -0,0 +1,28 @@
+// 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.esql.query({
+  format: "txt",
+  query:
+    "\n      FROM library\n    | SORT page_count DESC\n    | KEEP name, author\n    | LOOKUP era ON author\n    | LIMIT 5\n  ",
+  tables: {
+    era: {
+      author: {
+        keyword: [
+          "Frank Herbert",
+          "Peter F. Hamilton",
+          "Vernor Vinge",
+          "Alastair Reynolds",
+          "James S.A. Corey",
+        ],
+      },
+      era: {
+        keyword: ["The New Wave", "Diamond", "Diamond", "Diamond", "Hadron"],
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/2a1eece9a59ac1773edcf0a932c26de0.asciidoc

@@ -3,9 +3,7 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_security/oidc/logout",
+const response = await client.security.oidcLogout({
   body: {
     token:
       "dGhpcyBpcyBub3QgYSByZWFsIHRva2VuIGJ1dCBpdCBpcyBvbmx5IHRlc3QgZGF0YS4gZG8gbm90IHRyeSB0byByZWFkIHRva2VuIQ==",

docs/doc_examples/2a67608dadbf220a2f040f3a79d3677d.asciidoc

@@ -1,35 +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: "attachment",
-  description: "Extract attachment information including original binary",
-  processors: [
-    {
-      attachment: {
-        field: "data",
-        remove_binary: false,
-      },
-    },
-  ],
-});
-console.log(response);
-
-const response1 = await client.index({
-  index: "my-index-000001",
-  id: "my_id",
-  pipeline: "attachment",
-  document: {
-    data: "e1xydGYxXGFuc2kNCkxvcmVtIGlwc3VtIGRvbG9yIHNpdCBhbWV0DQpccGFyIH0=",
-  },
-});
-console.log(response1);
-
-const response2 = await client.get({
-  index: "my-index-000001",
-  id: "my_id",
-});
-console.log(response2);
-----

docs/doc_examples/2afdf0d83724953aa2875b5fb37d60cc.asciidoc

@@ -3,12 +3,10 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "GET",
-  path: "/_query/async/FmNJRUZ1YWZCU3dHY1BIOUhaenVSRkEaaXFlZ3h4c1RTWFNocDdnY2FSaERnUTozNDE=",
-  querystring: {
-    wait_for_completion_timeout: "30s",
-  },
+const response = await client.esql.asyncQueryGet({
+  id: "FmNJRUZ1YWZCU3dHY1BIOUhaenVSRkEaaXFlZ3h4c1RTWFNocDdnY2FSaERnUTozNDE=",
+  wait_for_completion_timeout: "30s",
+  body: null,
 });
 console.log(response);
 ----

docs/doc_examples/2bb41b0b4876ce98cd0cd8fb6d337f18.asciidoc

@@ -0,0 +1,16 @@
+// 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.putSettings({
+  persistent: {
+    "cluster.indices.close.enable": false,
+    "indices.recovery.max_bytes_per_sec": "50mb",
+  },
+  transient: {
+    "*": null,
+  },
+});
+console.log(response);
+----

docs/doc_examples/2fd458d37aab509fe2d970c0b6e2a10f.asciidoc

@@ -45,7 +45,7 @@ console.log(response);
 
 const response1 = await client.indices.putIndexTemplate({
   name: 2,
-  index_patterns: ["k9s*"],
+  index_patterns: ["k8s*"],
   composed_of: ["destination_template"],
   data_stream: {},
 });

docs/doc_examples/30d051f534aeb884176eedb2c11dac85.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.inference.put({
-  task_type: "rerank",
-  inference_id: "my-elastic-rerank",
-  inference_config: {
-    service: "elasticsearch",
-    service_settings: {
-      model_id: ".rerank-v1",
-      num_threads: 1,
-      adaptive_allocations: {
-        enabled: true,
-        min_number_of_allocations: 1,
-        max_number_of_allocations: 4,
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/35fd9549350926f8d57dc1765e2f40d3.asciidoc

@@ -10,7 +10,7 @@ const response = await client.ingest.putPipeline({
     {
       attachment: {
         field: "data",
-        remove_binary: true,
+        remove_binary: false,
       },
     },
   ],

docs/doc_examples/3b6718257421b5419bf4cd6a7303c57e.asciidoc

@@ -5,7 +5,7 @@
 ----
 const response = await client.transport.request({
   method: "GET",
-  path: "/_ingest/ip_location/database/my-database-id",
+  path: "/_ingest/geoip/database/my-database-id",
 });
 console.log(response);
 ----

docs/doc_examples/3f1fe5f5f99b98d0891f38003e10b636.asciidoc

@@ -3,9 +3,7 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_query/async",
+const response = await client.esql.asyncQuery({
   body: {
     query:
       "\n    FROM library\n    | EVAL year = DATE_TRUNC(1 YEARS, release_date)\n    | STATS MAX(page_count) BY year\n    | SORT year\n    | LIMIT 5\n  ",

docs/doc_examples/3fab530a2e43807929c0ef3ebf7d268c.asciidoc

@@ -5,7 +5,7 @@
 ----
 const response = await client.ingest.putPipeline({
   id: "geoip",
-  description: "Add ip geolocation info",
+  description: "Add geoip info",
   processors: [
     {
       geoip: {

docs/doc_examples/405511f7c1f12cc0a227b4563fe7b2e2.asciidoc

@@ -3,9 +3,9 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "GET",
-  path: "/_query/async/FkpMRkJGS1gzVDRlM3g4ZzMyRGlLbkEaTXlJZHdNT09TU2VTZVBoNDM3cFZMUToxMDM=",
+const response = await client.esql.asyncQueryGet({
+  id: "FkpMRkJGS1gzVDRlM3g4ZzMyRGlLbkEaTXlJZHdNT09TU2VTZVBoNDM3cFZMUToxMDM=",
+  body: null,
 });
 console.log(response);
 ----

docs/doc_examples/49b31e23f8b9667b6a7b2734d55fb6ed.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.knnSearch({
+  index: "my-index",
+  knn: {
+    field: "image_vector",
+    query_vector: [0.3, 0.1, 1.2],
+    k: 10,
+    num_candidates: 100,
+  },
+  _source: ["name", "file_type"],
+});
+console.log(response);
+----

docs/doc_examples/4b113c7f475cfe484a150ddbb8e6c5c7.asciidoc

@@ -4,7 +4,7 @@
 [source, js]
 ----
 const response = await client.security.putRole({
-  name: "only_remote_access_role",
+  name: "role_with_remote_indices",
   remote_indices: [
     {
       clusters: ["my_remote"],
@@ -12,12 +12,6 @@ const response = await client.security.putRole({
       privileges: ["read", "read_cross_cluster", "view_index_metadata"],
     },
   ],
-  remote_cluster: [
-    {
-      clusters: ["my_remote"],
-      privileges: ["monitor_stats"],
-    },
-  ],
 });
 console.log(response);
 ----

docs/doc_examples/4b91ad7c9b44e07db4a4e81390f19ad3.asciidoc

@@ -3,9 +3,9 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_inference/completion/openai-completion/_stream",
+const response = await client.inference.streamInference({
+  task_type: "completion",
+  inference_id: "openai-completion",
   body: {
     input: "What is Elastic?",
   },

docs/doc_examples/4dab4c5168047ba596af1beb0e55b845.asciidoc

@@ -3,8 +3,8 @@
 
 [source, js]
 ----
-const response = await client.indices.rollover({
-  alias: "datastream",
+const response = await client.cluster.getSettings({
+  flat_settings: "true",
 });
 console.log(response);
 ----

docs/doc_examples/533087d787b48878a0bf3fa8d0851b64.asciidoc

@@ -5,7 +5,7 @@
 ----
 const response = await client.transport.request({
   method: "DELETE",
-  path: "/_ingest/ip_location/database/example-database-id",
+  path: "/_ingest/geoip/database/example-database-id",
 });
 console.log(response);
 ----

docs/doc_examples/53d9d2ec9cb8d211772d764e76fe6890.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.ingest.simulate({
-  id: "query_helper_pipeline",
-  docs: [
-    {
-      _source: {
-        content:
-          "artificial intelligence in medicine articles published in the last 12 months",
-      },
-    },
-  ],
-});
-console.log(response);
-----

docs/doc_examples/57dc15e5ad663c342fd5c1d86fcd1b29.asciidoc

@@ -3,9 +3,7 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_security/oidc/prepare",
+const response = await client.security.oidcPrepareAuthentication({
   body: {
     realm: "oidc1",
     state: "lGYK0EcSLjqH6pkT5EVZjC6eIW5YCGgywj2sxROO",

docs/doc_examples/58f6b72009512851843c7b7a20e9504a.asciidoc

@@ -4,7 +4,7 @@
 [source, js]
 ----
 const response = await client.indices.create({
-  index: "my-index-000003",
+  index: "my-index-000002",
   mappings: {
     properties: {
       inference_field: {

docs/doc_examples/5a70db31f587b7ffed5e9bc1445430cb.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.indices.create({
+  index: "semantic-embeddings",
+  mappings: {
+    properties: {
+      semantic_text: {
+        type: "semantic_text",
+        inference_id: "my-elser-endpoint",
+      },
+      content: {
+        type: "text",
+        copy_to: "semantic_text",
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/5ba32ebaa7ee28a339c7693696d305ca.asciidoc

@@ -11,7 +11,7 @@ const response = await client.ingest.putPipeline({
       attachment: {
         field: "data",
         properties: ["content", "title"],
-        remove_binary: true,
+        remove_binary: false,
       },
     },
   ],

docs/doc_examples/5bba213a7f543190139d1a69ab2ed076.asciidoc

@@ -3,12 +3,8 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_query/async",
-  querystring: {
-    format: "json",
-  },
+const response = await client.esql.asyncQuery({
+  format: "json",
   body: {
     query:
       "\n    FROM cluster_one:my-index*,cluster_two:logs*\n    | STATS COUNT(http.response.status_code) BY user.id\n    | LIMIT 2\n  ",

docs/doc_examples/6b6fd0a5942dfb9762ad2790cf421a80.asciidoc

@@ -11,7 +11,7 @@ const response = await client.searchApplication.put({
       script: {
         lang: "mustache",
         source:
-          '\n        {\n          "query": {\n            "bool": {\n              "must": [\n              {{#query}}\n              {{/query}}\n            ],\n            "filter": {{#toJson}}_es_filters{{/toJson}}\n            }\n          },\n          "_source": {\n            "includes": ["title", "plot"]\n          },\n          "aggs": {{#toJson}}_es_aggs{{/toJson}},\n          "from": {{from}},\n          "size": {{size}},\n          "sort": {{#toJson}}_es_sort_fields{{/toJson}}\n        }\n      ',
+          '\n        {\n          "query": {\n            "bool": {\n              "must": [\n              {{#query}}\n                \n              {{/query}}\n            ],\n            "filter": {{#toJson}}_es_filters{{/toJson}}\n            }\n          },\n          "_source": {\n            "includes": ["title", "plot"]\n          },\n          "aggs": {{#toJson}}_es_aggs{{/toJson}},\n          "from": {{from}},\n          "size": {{size}},\n          "sort": {{#toJson}}_es_sort_fields{{/toJson}}\n        }\n      ',
         params: {
           query: "",
           _es_filters: {},

docs/doc_examples/6f3b723bf6179b96c3413597ed7f49e1.asciidoc

@@ -3,9 +3,7 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_security/api_key/_bulk_update",
+const response = await client.security.bulkUpdateApiKeys({
   body: {
     ids: ["VuaCfGcBCdbkQm-e5aOx", "H3_AhoIBA9hmeQJdg7ij"],
   },

docs/doc_examples/76e02434835630cb830724beb92df354.asciidoc

@@ -1,44 +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: [
-        {
-          knn: {
-            field: "vector",
-            query_vector: [0.23, 0.67, 0.89],
-            k: 3,
-            num_candidates: 5,
-          },
-        },
-        {
-          text_similarity_reranker: {
-            retriever: {
-              standard: {
-                query: {
-                  term: {
-                    topic: "ai",
-                  },
-                },
-              },
-            },
-            field: "text",
-            inference_id: "my-rerank-model",
-            inference_text:
-              "Can I use generative AI to identify user intent and improve search relevance?",
-          },
-        },
-      ],
-      rank_window_size: 10,
-      rank_constant: 1,
-    },
-  },
-  _source: false,
-});
-console.log(response);
-----

docs/doc_examples/77518e8c6198acfe77c0934fd2fe65cb.asciidoc

@@ -3,9 +3,7 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_text_structure/find_message_structure",
+const response = await client.textStructure.findMessageStructure({
   body: {
     messages: [
       "[2024-03-05T10:52:36,256][INFO ][o.a.l.u.VectorUtilPanamaProvider] [laptop] Java vector incubator API enabled; uses preferredBitSize=128",

docs/doc_examples/78043831fd32004a82930c8ac8a1d809.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: {
-    text_similarity_reranker: {
-      retriever: {
-        rrf: {
-          retrievers: [
-            {
-              standard: {
-                query: {
-                  query_string: {
-                    query:
-                      "(information retrieval) OR (artificial intelligence)",
-                    default_field: "text",
-                  },
-                },
-              },
-            },
-            {
-              knn: {
-                field: "vector",
-                query_vector: [0.23, 0.67, 0.89],
-                k: 3,
-                num_candidates: 5,
-              },
-            },
-          ],
-          rank_window_size: 10,
-          rank_constant: 1,
-        },
-      },
-      field: "text",
-      inference_id: "my-rerank-model",
-      inference_text:
-        "What are the state of the art applications of AI in information retrieval?",
-    },
-  },
-  _source: false,
-});
-console.log(response);
-----

docs/doc_examples/7b9691bd34a02dd859562eb927f175e0.asciidoc

@@ -12,7 +12,7 @@ const response = await client.inference.put({
       adaptive_allocations: {
         enabled: true,
         min_number_of_allocations: 1,
-        max_number_of_allocations: 4,
+        max_number_of_allocations: 10,
       },
       num_threads: 1,
       model_id: ".elser_model_2",

docs/doc_examples/7f1fade93225f8cf6000b93334d76ce4.asciidoc

@@ -1,34 +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: "ip_location",
-  description: "Add ip geolocation info",
-  processors: [
-    {
-      ip_location: {
-        field: "ip",
-      },
-    },
-  ],
-});
-console.log(response);
-
-const response1 = await client.index({
-  index: "my-index-000001",
-  id: "my_id",
-  pipeline: "ip_location",
-  document: {
-    ip: "80.231.5.0",
-  },
-});
-console.log(response1);
-
-const response2 = await client.get({
-  index: "my-index-000001",
-  id: "my_id",
-});
-console.log(response2);
-----

docs/doc_examples/80dd7f5882c59b9c1c90e8351937441f.asciidoc

@@ -3,9 +3,7 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_security/api_key/_bulk_update",
+const response = await client.security.bulkUpdateApiKeys({
   body: {
     ids: ["VuaCfGcBCdbkQm-e5aOx", "H3_AhoIBA9hmeQJdg7ij"],
     role_descriptors: {

docs/doc_examples/8593715fcc70315a0816b435551258e0.asciidoc

@@ -9,7 +9,7 @@ const response = await client.indices.create({
     properties: {
       infer_field: {
         type: "semantic_text",
-        inference_id: ".elser-2-elasticsearch",
+        inference_id: "my-elser-endpoint",
       },
       source_field: {
         type: "text",

docs/doc_examples/8cad5d95a0e7c103f08be53d0b172558.asciidoc

@@ -4,18 +4,17 @@
 [source, js]
 ----
 const response = await client.inference.put({
-  task_type: "rerank",
-  inference_id: "my-elastic-rerank",
+  task_type: "sparse_embedding",
+  inference_id: "my-elser-endpoint",
   inference_config: {
-    service: "elasticsearch",
+    service: "elser",
     service_settings: {
-      model_id: ".rerank-v1",
-      num_threads: 1,
       adaptive_allocations: {
         enabled: true,
-        min_number_of_allocations: 1,
+        min_number_of_allocations: 3,
         max_number_of_allocations: 10,
       },
+      num_threads: 1,
     },
   },
 });

docs/doc_examples/9313f534e1aa266cde7d4af74665497f.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.connector.put({
-  connector_id: "my-{service-name-stub}-connector",
-  index_name: "my-elasticsearch-index",
-  name: "Content synced from {service-name}",
-  service_type: "{service-name-stub}",
-});
-console.log(response);
-----

docs/doc_examples/931817b168e055ecf738785c721125dd.asciidoc

@@ -1,32 +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: "query_helper_pipeline",
-  processors: [
-    {
-      script: {
-        source:
-          "ctx.prompt = 'Please generate an elasticsearch search query on index `articles_index` for the following natural language query. Dates are in the field `@timestamp`, document types are in the field `type` (options are `news`, `publication`), categories in the field `category` and can be multiple (options are `medicine`, `pharmaceuticals`, `technology`), and document names are in the field `title` which should use a fuzzy match. Ignore fields which cannot be determined from the natural language query context: ' + ctx.content",
-      },
-    },
-    {
-      inference: {
-        model_id: "openai_chat_completions",
-        input_output: {
-          input_field: "prompt",
-          output_field: "query",
-        },
-      },
-    },
-    {
-      remove: {
-        field: "prompt",
-      },
-    },
-  ],
-});
-console.log(response);
-----

docs/doc_examples/96e88611f99e6834bd64b58dc8a282c1.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.indices.create({
-  index: "my-index-000002",
-  mappings: {
-    properties: {
-      inference_field: {
-        type: "semantic_text",
-        inference_id: "my-openai-endpoint",
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/97c6c07f46f4177f0565a04bc50924a3.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.search({
-  index: "retrievers_example",
-  retriever: {
-    rrf: {
-      retrievers: [
-        {
-          standard: {
-            query: {
-              query_string: {
-                query: "(information retrieval) OR (artificial intelligence)",
-                default_field: "text",
-              },
-            },
-          },
-        },
-        {
-          knn: {
-            field: "vector",
-            query_vector: [0.23, 0.67, 0.89],
-            k: 3,
-            num_candidates: 5,
-          },
-        },
-      ],
-      rank_window_size: 10,
-      rank_constant: 1,
-    },
-  },
-  _source: false,
-});
-console.log(response);
-----

docs/doc_examples/981b331db1404b39c1a612a135e4e76d.asciidoc

@@ -5,11 +5,11 @@
 ----
 const response = await client.transport.request({
   method: "PUT",
-  path: "/_ingest/ip_location/database/my-database-1",
+  path: "/_ingest/geoip/database/my-database-id",
   body: {
     name: "GeoIP2-Domain",
     maxmind: {
-      account_id: "1234567",
+      account_id: "1025402",
     },
   },
 });

docs/doc_examples/9afa0844883b7471883aa378a8dd10b4.asciidoc

@@ -3,9 +3,9 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_application/analytics/my_analytics_collection/event/search_click",
+const response = await client.searchApplication.postBehavioralAnalyticsEvent({
+  collection_name: "my_analytics_collection",
+  event_type: "search_click",
   body: {
     session: {
       id: "1797ca95-91c9-4e2e-b1bd-9c38e6f386a9",

docs/doc_examples/9c01db07c9ac395b6370e3b33965c21f.asciidoc

@@ -3,9 +3,7 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_security/oidc/authenticate",
+const response = await client.security.oidcAuthenticate({
   body: {
     redirect_uri:
       "https://oidc-kibana.elastic.co:5603/api/security/oidc/callback?code=jtI3Ntt8v3_XvcLzCFGq&state=4dbrihtIAt3wBTwo6DxK-vdk-sSyDBV8Yf0AjdkdT5I",

docs/doc_examples/9f16fca9813304e398ee052aa857dbcd.asciidoc

@@ -10,8 +10,7 @@ const response = await client.inference.put({
     service: "openai",
     service_settings: {
       api_key: "<api_key>",
-      model_id: "text-embedding-3-small",
-      dimensions: 128,
+      model_id: "text-embedding-ada-002",
     },
   },
 });

docs/doc_examples/a162eb50853331c80596f5994e9d1c38.asciidoc

@@ -3,9 +3,8 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_application/search_application/my_search_application/_render_query",
+const response = await client.searchApplication.renderQuery({
+  name: "my_search_application",
   body: {
     params: {
       query_string: "rock climbing",

docs/doc_examples/a3779f21f132787c48681bfb50453592.asciidoc

@@ -1,34 +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: "ip_location",
-  description: "Add ip geolocation info",
-  processors: [
-    {
-      ip_location: {
-        field: "ip",
-      },
-    },
-  ],
-});
-console.log(response);
-
-const response1 = await client.index({
-  index: "my-index-000001",
-  id: "my_id",
-  pipeline: "ip_location",
-  document: {
-    ip: "89.160.20.128",
-  },
-});
-console.log(response1);
-
-const response2 = await client.get({
-  index: "my-index-000001",
-  id: "my_id",
-});
-console.log(response2);
-----

docs/doc_examples/a9f14efc26fdd3c37a71f06c310163d9.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.search({
-  retriever: {
-    text_similarity_reranker: {
-      retriever: {
-        standard: {
-          query: {
-            match: {
-              text: "How often does the moon hide the sun?",
-            },
-          },
-        },
-      },
-      field: "text",
-      inference_id: "my-elastic-rerank",
-      inference_text: "How often does the moon hide the sun?",
-      rank_window_size: 100,
-      min_score: 0.5,
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/ac22cc2b0f4ad659055feed2852a2d59.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.search({
-  index: "retrievers_example",
-  retriever: {
-    text_similarity_reranker: {
-      retriever: {
-        text_similarity_reranker: {
-          retriever: {
-            knn: {
-              field: "vector",
-              query_vector: [0.23, 0.67, 0.89],
-              k: 3,
-              num_candidates: 5,
-            },
-          },
-          rank_window_size: 100,
-          field: "text",
-          inference_id: "my-rerank-model",
-          inference_text:
-            "What are the state of the art applications of AI in information retrieval?",
-        },
-      },
-      rank_window_size: 10,
-      field: "text",
-      inference_id: "my-other-more-expensive-rerank-model",
-      inference_text:
-        "Applications of Large Language Models in technology and their impact on user satisfaction",
-    },
-  },
-  _source: false,
-});
-console.log(response);
-----

docs/doc_examples/ae3473adaf1515afcf7773f26c018e5c.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.connector.put({
-  connector_id: "my-{service-name-stub}-connector",
-  index_name: "my-elasticsearch-index",
-  name: "Content synced from {service-name}",
-  service_type: "{service-name-stub}",
-  is_native: true,
-});
-console.log(response);
-----

docs/doc_examples/b0bddf2ffaa83049b195829c06b875cd.asciidoc

@@ -3,9 +3,9 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_application/search_application/my_search_application/_render_query",
+const response = await client.searchApplication.renderQuery({
+  name: "my_search_application",
+  body: null,
 });
 console.log(response);
 ----

docs/doc_examples/b26b5574438e4eaf146b2428bf537c51.asciidoc

@@ -14,7 +14,7 @@ const response = await client.ingest.putPipeline({
           attachment: {
             target_field: "_ingest._value.attachment",
             field: "_ingest._value.data",
-            remove_binary: true,
+            remove_binary: false,
           },
         },
       },

docs/doc_examples/b577e7e7eb5ce9d16cb582356e2cc45c.asciidoc

@@ -5,7 +5,7 @@
 ----
 const response = await client.ingest.putPipeline({
   id: "geoip",
-  description: "Add ip geolocation info",
+  description: "Add geoip info",
   processors: [
     {
       geoip: {

docs/doc_examples/b62eaa20c4e0e48134a6d1d1b3c30b26.asciidoc

@@ -208,13 +208,10 @@ const response = await client.bulk({
 });
 console.log(response);
 
-const response1 = await client.transport.request({
-  method: "GET",
-  path: "/_text_structure/find_field_structure",
-  querystring: {
-    index: "test-logs",
-    field: "message",
-  },
+const response1 = await client.textStructure.findFieldStructure({
+  index: "test-logs",
+  field: "message",
+  body: null,
 });
 console.log(response1);
 ----

docs/doc_examples/bb2ba5d1885f87506f90dbb002e518f4.asciidoc

@@ -1,45 +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: {
-              query_string: {
-                query: "(information retrieval) OR (artificial intelligence)",
-                default_field: "text",
-              },
-            },
-          },
-        },
-        {
-          knn: {
-            field: "vector",
-            query_vector: [0.23, 0.67, 0.89],
-            k: 3,
-            num_candidates: 5,
-          },
-        },
-      ],
-      rank_window_size: 10,
-      rank_constant: 1,
-    },
-  },
-  highlight: {
-    fields: {
-      text: {
-        fragment_size: 150,
-        number_of_fragments: 3,
-      },
-    },
-  },
-  _source: false,
-});
-console.log(response);
-----

docs/doc_examples/bb5a1319c496acc862c670cc7224e59a.asciidoc

@@ -12,7 +12,7 @@ const response = await client.ingest.putPipeline({
         field: "data",
         indexed_chars: 11,
         indexed_chars_field: "max_size",
-        remove_binary: true,
+        remove_binary: false,
       },
     },
   ],

docs/doc_examples/bcdfaa4487747249699a86a0dcd22f5e.asciidoc

@@ -3,9 +3,7 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_ingest/_simulate",
+const response = await client.simulate.ingest({
   body: {
     docs: [
       {

docs/doc_examples/bee3fda7bb07086243424b62e5b16ca7.asciidoc

@@ -1,83 +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: "retrievers_example_nested",
-  mappings: {
-    properties: {
-      nested_field: {
-        type: "nested",
-        properties: {
-          paragraph_id: {
-            type: "keyword",
-          },
-          nested_vector: {
-            type: "dense_vector",
-            dims: 3,
-            similarity: "l2_norm",
-            index: true,
-          },
-        },
-      },
-      topic: {
-        type: "keyword",
-      },
-    },
-  },
-});
-console.log(response);
-
-const response1 = await client.index({
-  index: "retrievers_example_nested",
-  id: 1,
-  document: {
-    nested_field: [
-      {
-        paragraph_id: "1a",
-        nested_vector: [-1.12, -0.59, 0.78],
-      },
-      {
-        paragraph_id: "1b",
-        nested_vector: [-0.12, 1.56, 0.42],
-      },
-      {
-        paragraph_id: "1c",
-        nested_vector: [1, -1, 0],
-      },
-    ],
-    topic: ["ai"],
-  },
-});
-console.log(response1);
-
-const response2 = await client.index({
-  index: "retrievers_example_nested",
-  id: 2,
-  document: {
-    nested_field: [
-      {
-        paragraph_id: "2a",
-        nested_vector: [0.23, 1.24, 0.65],
-      },
-    ],
-    topic: ["information_retrieval"],
-  },
-});
-console.log(response2);
-
-const response3 = await client.index({
-  index: "retrievers_example_nested",
-  id: 3,
-  document: {
-    topic: ["ai"],
-  },
-});
-console.log(response3);
-
-const response4 = await client.indices.refresh({
-  index: "retrievers_example_nested",
-});
-console.log(response4);
-----

docs/doc_examples/c02c2916b97b6fa7db82dbc7f0378310.asciidoc

@@ -16,7 +16,7 @@ const response = await client.search({
         },
       },
       field: "text",
-      inference_id: "elastic-rerank",
+      inference_id: "my-cohere-rerank-model",
       inference_text: "How often does the moon hide the sun?",
       rank_window_size: 100,
       min_score: 0.5,

docs/doc_examples/c580990a70028bb49cca8a6bde86bbf6.asciidoc

@@ -3,9 +3,7 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_security/api_key/_bulk_update",
+const response = await client.security.bulkUpdateApiKeys({
   body: {
     ids: ["VuaCfGcBCdbkQm-e5aOx", "H3_AhoIBA9hmeQJdg7ij"],
     role_descriptors: {},

docs/doc_examples/c8fa8d7e029792d539464fede18ce258.asciidoc

@@ -9,6 +9,7 @@ const response = await client.indices.create({
     properties: {
       content: {
         type: "semantic_text",
+        inference_id: "my-elser-endpoint",
       },
     },
   },

docs/doc_examples/ccc613951c61f0b17e1ed8a2d3ae54a2.asciidoc

@@ -3,9 +3,7 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_ingest/_simulate",
+const response = await client.simulate.ingest({
   body: {
     docs: [
       {

docs/doc_examples/d01a590fa9ea8a0cb34ed8dda502296c.asciidoc

@@ -0,0 +1,11 @@
+// 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.getSettings({
+  flat_settings: "true",
+  filter_path: "transient",
+});
+console.log(response);
+----

docs/doc_examples/d29031409016b2b798148ef173a196ae.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.indices.create({
-  index: "test-index",
-  query: {
-    semantic: {
-      field: "my_semantic_field",
-    },
-  },
-  highlight: {
-    fields: {
-      my_semantic_field: {
-        type: "semantic",
-        number_of_fragments: 2,
-        order: "score",
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/d35c8cf7a98b3f112e1de8797ec6689d.asciidoc

@@ -3,9 +3,7 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "POST",
-  path: "/_security/oidc/prepare",
+const response = await client.security.oidcPrepareAuthentication({
   body: {
     iss: "http://127.0.0.1:8080",
     login_hint: "this_is_an_opaque_string",

docs/doc_examples/d3a558ef226e9dccc1c7c61e1167547f.asciidoc

@@ -5,7 +5,7 @@
 ----
 const response = await client.ingest.putPipeline({
   id: "geoip",
-  description: "Add ip geolocation info",
+  description: "Add geoip info",
   processors: [
     {
       geoip: {

docs/doc_examples/d4158d486e7fee2702a14068b69e3b33.asciidoc

@@ -1,154 +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: "datastream_template",
-  index_patterns: ["datastream*"],
-  data_stream: {},
-  template: {
-    lifecycle: {
-      downsampling: [
-        {
-          after: "1m",
-          fixed_interval: "1h",
-        },
-      ],
-    },
-    settings: {
-      index: {
-        mode: "time_series",
-      },
-    },
-    mappings: {
-      properties: {
-        "@timestamp": {
-          type: "date",
-        },
-        kubernetes: {
-          properties: {
-            container: {
-              properties: {
-                cpu: {
-                  properties: {
-                    usage: {
-                      properties: {
-                        core: {
-                          properties: {
-                            ns: {
-                              type: "long",
-                            },
-                          },
-                        },
-                        limit: {
-                          properties: {
-                            pct: {
-                              type: "float",
-                            },
-                          },
-                        },
-                        nanocores: {
-                          type: "long",
-                          time_series_metric: "gauge",
-                        },
-                        node: {
-                          properties: {
-                            pct: {
-                              type: "float",
-                            },
-                          },
-                        },
-                      },
-                    },
-                  },
-                },
-                memory: {
-                  properties: {
-                    available: {
-                      properties: {
-                        bytes: {
-                          type: "long",
-                          time_series_metric: "gauge",
-                        },
-                      },
-                    },
-                    majorpagefaults: {
-                      type: "long",
-                    },
-                    pagefaults: {
-                      type: "long",
-                      time_series_metric: "gauge",
-                    },
-                    rss: {
-                      properties: {
-                        bytes: {
-                          type: "long",
-                          time_series_metric: "gauge",
-                        },
-                      },
-                    },
-                    usage: {
-                      properties: {
-                        bytes: {
-                          type: "long",
-                          time_series_metric: "gauge",
-                        },
-                        limit: {
-                          properties: {
-                            pct: {
-                              type: "float",
-                            },
-                          },
-                        },
-                        node: {
-                          properties: {
-                            pct: {
-                              type: "float",
-                            },
-                          },
-                        },
-                      },
-                    },
-                    workingset: {
-                      properties: {
-                        bytes: {
-                          type: "long",
-                          time_series_metric: "gauge",
-                        },
-                      },
-                    },
-                  },
-                },
-                name: {
-                  type: "keyword",
-                },
-                start_time: {
-                  type: "date",
-                },
-              },
-            },
-            host: {
-              type: "keyword",
-              time_series_dimension: true,
-            },
-            namespace: {
-              type: "keyword",
-              time_series_dimension: true,
-            },
-            node: {
-              type: "keyword",
-              time_series_dimension: true,
-            },
-            pod: {
-              type: "keyword",
-              time_series_dimension: true,
-            },
-          },
-        },
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/d4df39f72d3a3b80cd4042f6a21c3f19.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.transport.request({
-  method: "PUT",
-  path: "/_ingest/ip_location/database/my-database-2",
-  body: {
-    name: "standard_location",
-    ipinfo: {},
-  },
-});
-console.log(response);
-----

docs/doc_examples/dd71b0c9f9197684ff29c61062c55660.asciidoc

@@ -3,9 +3,6 @@
 
 [source, js]
 ----
-const response = await client.transport.request({
-  method: "GET",
-  path: "/_security/settings",
-});
+const response = await client.security.getSettings();
 console.log(response);
 ----

docs/doc_examples/e22a1da3c622611be6855e534c0709ae.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.transport.request({
-  method: "POST",
-  path: "/_query_rules/my-ruleset/_test",
-  body: {
-    match_criteria: {
-      query_string: "puggles",
-    },
-  },
-});
-console.log(response);
-----