Publish 9.0 tags as prereleases (#2524)

* Update tests and bulk helper to stop using body param

* Update compatible-with content-type header for 9.0

.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 --production=false
+RUN npm install
 
 COPY . .

.buildkite/Dockerfile-make

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

.buildkite/pipeline.yml

@@ -6,7 +6,7 @@ steps:
     env:
       NODE_VERSION: "{{ matrix.nodejs }}"
       TEST_SUITE: "{{ matrix.suite }}"
-      STACK_VERSION: 8.15.0
+      STACK_VERSION: 8.16.0
     matrix:
       setup:
         suite:
@@ -25,7 +25,7 @@ steps:
       provider: "gcp"
       image: family/core-ubuntu-2204
     plugins:
-      - junit-annotate#v2.4.1:
+      - junit-annotate#v2.5.0:
           artifacts: "junit-output/junit-*.xml"
           job-uuid-file-pattern: "junit-(.*).xml"
           fail-build-on-error: true

.dockerignore

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

.github/ISSUE_TEMPLATE/bug.md

@@ -1,50 +0,0 @@
----
-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

@@ -0,0 +1,66 @@
+---
+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

@@ -1,23 +0,0 @@
----
-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

@@ -0,0 +1,33 @@
+---
+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

@@ -1,11 +0,0 @@
----
-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

@@ -0,0 +1,21 @@
+---
+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

@@ -1,6 +0,0 @@
----
-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

@@ -0,0 +1,8 @@
+---
+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=18
+NODE_JS_VERSION=22
 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,6 +159,14 @@ 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 \
@@ -179,36 +187,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"
-  else 
-		echo -e "\033[31;1mTARGET: failed bumped client v$VERSION\033[0m"
+  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"
+  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"
+  echo "TODO"
 fi
 
 if [[ "$CMD" == "examplesgen" ]]; then
-    echo "TODO"
+  echo "TODO"
 fi

.github/stale.yml

@@ -1,26 +0,0 @@
-# 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/auto-merge.yml

@@ -1,18 +0,0 @@
-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

@@ -11,8 +11,10 @@ jobs:
     outputs:
       src-only: "${{ steps.changes.outputs.src-only }}"
     steps:
-      - uses: actions/checkout@v4
-      - uses: dorny/paths-filter/@v2.11.1
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+        with:
+          persist-credentials: false
+      - uses: dorny/paths-filter/@de90cc6fb38fc0963ad72b210f1f284cd68cea36 # v3.0.2
         id: changes
         with:
           filters: |
@@ -30,14 +32,16 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        node-version: [18.x, 20.x, 22.x]
+        node-version: [18.x, 20.x, 22.x, 23.x]
         os: [ubuntu-latest, windows-latest, macOS-latest]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+        with:
+          persist-credentials: false
 
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4
         with:
           node-version: ${{ matrix.node-version }}
 
@@ -53,15 +57,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@v4
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+        with:
+          persist-credentials: false
 
       - name: Use Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4
         with:
           node-version: 22.x
 
@@ -73,12 +83,38 @@ jobs:
         run: |
           npm run license-checker
 
-  auto-approve:
-    name: Auto-approve
-    needs: [test, license]
-    runs-on: ubuntu-latest
-    permissions:
-      pull-requests: write
-    if: github.actor == 'elasticmachine'
+  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: hmarr/auto-approve-action@v4
+      - 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

@@ -9,28 +9,32 @@ jobs:
   build:
     runs-on: ubuntu-latest
     permissions:
-      contents: read
+      contents: write
       id-token: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
         with:
+          persist-credentials: false
           ref: ${{ github.event.inputs.branch }}
-      - uses: actions/setup-node@v3
+      - uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4
         with:
-          node-version: "20.x"
+          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
+      - run: npm publish --provenance --access public --tag alpha
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-      - run: |
+      - name: Publish version on GitHub
+        run: |
           version=$(jq -r .version package.json)
           gh release create \
-            -n "[Changelog](https://www.elastic.co/guide/en/elasticsearch/client/javascript-api/$BRANCH_NAME/changelog-client.html)" \
+            -n "This is a 9.0.0 pre-release alpha. Changes may not be stable." \
+            --latest=false \
+            --prerelease \
             --target "$BRANCH_NAME" \
-            -t "v$version" \
+            --title "v$version" \
             "v$version"
         env:
           BRANCH_NAME: ${{ github.event.inputs.branch }}

.github/workflows/serverless-patch.yml

@@ -26,26 +26,28 @@ jobs:
         )
       )
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
         with:
+          persist-credentials: false
           repository: elastic/elasticsearch-js
           ref: main
           path: stack
           fetch-depth: 0
-      - uses: actions/checkout@v4
+      - 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@v6
+      - uses: peter-evans/create-pull-request@5e914681df9dc83aa4e4905692ca88beb2f9e91f # 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 }}'
+          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"

.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@v8
+      - uses: actions/stale@28ca1036281a5e5922ead5184a1bbf96e5fc984e # v9
         with:
           stale-issue-label: stale
           stale-pr-label: stale
           days-before-stale: 90
           days-before-close: 14
-          exempt-issue-labels: 'good first issue'
+          exempt-issue-labels: "good first issue,tracking"
           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

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

.npmignore

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

catalog-info.yaml

@@ -42,6 +42,9 @@ spec:
         main:
           branch: "main"
           cronline: "@daily"
-        8_14:
-          branch: "8.14"
+        8_x:
+          branch: "8.x"
+          cronline: "@daily"
+        8_14:
+          branch: "8.16"
           cronline: "@daily"

docs/basic-config.asciidoc

@@ -252,8 +252,8 @@ const client = new Client({
 ----
 
 |`disablePrototypePoisoningProtection`
-|`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`
+|`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`
 
 |`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,11 +1,90 @@
 [[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]
+=== 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]
-==== Features
+==== Fixes
 
 [discrete]
 ===== Improved support for Elasticsearch `v8.15`
@@ -16,7 +95,7 @@ Updated TypeScript types based on fixes and improvements to the Elasticsearch sp
 === 8.15.1
 
 [discrete]
-==== Features
+==== Fixes
 
 [discrete]
 ===== Improved support for Elasticsearch `v8.15`
@@ -577,6 +656,7 @@ ac.abort()
 ----
 
 [discrete]
+[[remove-body-key]]
 ===== Remove the body key from the request
 
 *Breaking: Yes* | *Migration effort: Small*

docs/connecting.asciidoc

@@ -1,7 +1,7 @@
 [[client-connecting]]
-== Connecting 
+== Connecting
 
-This page contains the information you need to connect and use the Client with 
+This page contains the information you need to connect and use the Client with
 {es}.
 
 **On this page**
@@ -19,7 +19,7 @@ This page contains the information you need to connect and use the Client with
 [discrete]
 === Authentication
 
-This document contains code snippets to show you how to connect to various {es} 
+This document contains code snippets to show you how to connect to various {es}
 providers.
 
 
@@ -27,18 +27,18 @@ providers.
 [[auth-ec]]
 ==== Elastic Cloud
 
-If you are using https://www.elastic.co/cloud[Elastic Cloud], the client offers 
-an easy way to connect to it via the `cloud` option. You must pass the Cloud ID 
-that you can find in the cloud console, then your username and password inside 
+If you are using https://www.elastic.co/cloud[Elastic Cloud], the client offers
+an easy way to connect to it via the `cloud` option. You must pass the Cloud ID
+that you can find in the cloud console, then your username and password inside
 the `auth` option.
 
-NOTE: When connecting to Elastic Cloud, the client will automatically enable 
-both request and response compression by default, since it yields significant 
-throughput improvements. Moreover, the client will also set the tls option 
-`secureProtocol` to `TLSv1_2_method` unless specified otherwise. You can still 
+NOTE: When connecting to Elastic Cloud, the client will automatically enable
+both request and response compression by default, since it yields significant
+throughput improvements. Moreover, the client will also set the tls option
+`secureProtocol` to `TLSv1_2_method` unless specified otherwise. You can still
 override this option by configuring them.
 
-IMPORTANT: Do not enable sniffing when using Elastic Cloud, since the nodes are 
+IMPORTANT: Do not enable sniffing when using Elastic Cloud, since the nodes are
 behind a load balancer, Elastic Cloud will take care of everything for you.
 Take a look https://www.elastic.co/blog/elasticsearch-sniffing-best-practices-what-when-why-how[here]
 to know more.
@@ -61,18 +61,18 @@ const client = new Client({
 [[connect-self-managed-new]]
 === Connecting to a self-managed cluster
 
-By default {es} will start with security features like authentication and TLS 
-enabled. To connect to the {es} cluster you'll need to configure the Node.js {es} 
-client to use HTTPS with the generated CA certificate in order to make requests 
+By default {es} will start with security features like authentication and TLS
+enabled. To connect to the {es} cluster you'll need to configure the Node.js {es}
+client to use HTTPS with the generated CA certificate in order to make requests
 successfully.
 
-If you're just getting started with {es} we recommend reading the documentation 
-on https://www.elastic.co/guide/en/elasticsearch/reference/current/settings.html[configuring] 
-and 
-https://www.elastic.co/guide/en/elasticsearch/reference/current/starting-elasticsearch.html[starting {es}] 
+If you're just getting started with {es} we recommend reading the documentation
+on https://www.elastic.co/guide/en/elasticsearch/reference/current/settings.html[configuring]
+and
+https://www.elastic.co/guide/en/elasticsearch/reference/current/starting-elasticsearch.html[starting {es}]
 to ensure your cluster is running as expected.
 
-When you start {es} for the first time you'll see a distinct block like the one 
+When you start {es} for the first time you'll see a distinct block like the one
 below in the output from {es} (you may have to scroll up if it's been a while):
 
 [source,sh]
@@ -90,24 +90,24 @@ below in the output from {es} (you may have to scroll up if it's been a while):
 
 ----
 
-Depending on the circumstances there are two options for verifying the HTTPS 
-connection, either verifying with the CA certificate itself or via the HTTP CA 
+Depending on the circumstances there are two options for verifying the HTTPS
+connection, either verifying with the CA certificate itself or via the HTTP CA
 certificate fingerprint.
 
 [discrete]
 [[auth-tls]]
 ==== TLS configuration
 
-The generated root CA certificate can be found in the `certs` directory in your 
-{es} config location (`$ES_CONF_PATH/certs/http_ca.crt`). If you're running {es} 
-in Docker there is 
+The generated root CA certificate can be found in the `certs` directory in your
+{es} config location (`$ES_CONF_PATH/certs/http_ca.crt`). If you're running {es}
+in Docker there is
 https://www.elastic.co/guide/en/elasticsearch/reference/current/docker.html[additional documentation for retrieving the CA certificate].
 
-Without any additional configuration you can specify `https://` node urls, and 
-the certificates used to sign these requests will be verified. To turn off 
-certificate verification, you must specify an `tls` object in the top level 
-config and set `rejectUnauthorized: false`. The default `tls` values are the 
-same that Node.js's https://nodejs.org/api/tls.html#tls_tls_connect_options_callback[`tls.connect()`] 
+Without any additional configuration you can specify `https://` node urls, and
+the certificates used to sign these requests will be verified. To turn off
+certificate verification, you must specify an `tls` object in the top level
+config and set `rejectUnauthorized: false`. The default `tls` values are the
+same that Node.js's https://nodejs.org/api/tls.html#tls_tls_connect_options_callback[`tls.connect()`]
 uses.
 
 [source,js]
@@ -152,7 +152,7 @@ const client = new Client({
 })
 ----
 
-The certificate fingerprint can be calculated using `openssl x509` with the 
+The certificate fingerprint can be calculated using `openssl x509` with the
 certificate file:
 
 [source,sh]
@@ -160,8 +160,8 @@ certificate file:
 openssl x509 -fingerprint -sha256 -noout -in /path/to/http_ca.crt
 ----
 
-If you don't have access to the generated CA file from {es} you can use the 
-following script to output the root CA fingerprint of the {es} instance with 
+If you don't have access to the generated CA file from {es} you can use the
+following script to output the root CA fingerprint of the {es} instance with
 `openssl s_client`:
 
 [source,sh]
@@ -186,8 +186,8 @@ SHA256 Fingerprint=A5:2D:D9:35:11:E8:C6:04:5E:21:F1:66:54:B7:7C:9E:E0:F3:4A:EA:2
 
 WARNING: Running {es} without security enabled is not recommended.
 
-If your cluster is configured with 
-https://www.elastic.co/guide/en/elasticsearch/reference/current/security-settings.html[security explicitly disabled] 
+If your cluster is configured with
+https://www.elastic.co/guide/en/elasticsearch/reference/current/security-settings.html[security explicitly disabled]
 then you can connect via HTTP:
 
 [source,js]
@@ -208,14 +208,14 @@ Following you can find all the supported authentication strategies.
 [[auth-apikey]]
 ==== ApiKey authentication
 
-You can use the 
-{ref-7x}/security-api-create-api-key.html[ApiKey] 
-authentication by passing the `apiKey` parameter via the `auth` option. The 
-`apiKey` parameter can be either a base64 encoded string or an object with the 
-values that you can obtain from the 
+You can use the
+{ref-7x}/security-api-create-api-key.html[ApiKey]
+authentication by passing the `apiKey` parameter via the `auth` option. The
+`apiKey` parameter can be either a base64 encoded string or an object with the
+values that you can obtain from the
 {ref-7x}/security-api-create-api-key.html[create api key endpoint].
 
-NOTE: If you provide both basic authentication credentials and the ApiKey 
+NOTE: If you provide both basic authentication credentials and the ApiKey
 configuration, the ApiKey takes precedence.
 
 [source,js]
@@ -268,10 +268,10 @@ const client = new Client({
 [[auth-basic]]
 ==== Basic authentication
 
-You can provide your credentials by passing the `username` and `password` 
+You can provide your credentials by passing the `username` and `password`
 parameters via the `auth` option.
 
-NOTE: If you provide both basic authentication credentials and the Api Key 
+NOTE: If you provide both basic authentication credentials and the Api Key
 configuration, the Api Key will take precedence.
 
 [source,js]
@@ -342,14 +342,14 @@ const result = await client.search({
 }, { meta: true })
 ----
 
-In this case, the result will be: 
+In this case, the result will be:
 [source,ts]
 ----
 {
   body: object | boolean
   statusCode: number
   headers: object
-  warnings: [string],
+  warnings: string[],
   meta: object
 }
 ----
@@ -361,7 +361,7 @@ NOTE: The body is a boolean value when you use `HEAD` APIs.
 
 If needed, you can abort a running request by using the `AbortController` standard.
 
-CAUTION: If you abort a request, the request will fail with a 
+CAUTION: If you abort a request, the request will fail with a
 `RequestAbortedError`.
 
 
@@ -410,19 +410,23 @@ 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` - Max request timeout for the request in milliseconds, it overrides the client default. +
+|`number | string` - 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`
 
@@ -446,6 +450,10 @@ _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`
@@ -458,6 +466,17 @@ _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]
@@ -537,8 +556,8 @@ Resources used to assess these recommendations:
 
 ~Added~ ~in~ ~`v7.10.0`~
 
-If you need to pass through an http(s) proxy for connecting to {es}, the client 
-out of the box offers a handy configuration for helping you with it. Under the 
+If you need to pass through an http(s) proxy for connecting to {es}, the client
+out of the box offers a handy configuration for helping you with it. Under the
 hood, it uses the https://github.com/delvedor/hpagent[`hpagent`] module.
 
 IMPORTANT: In versions 8.0+ of the client, the default `Connection` type is set to `UndiciConnection`, which does not support proxy configurations.
@@ -715,5 +734,5 @@ This pre-flight product check allows the client to establish the version of Elas
 that it is communicating with. The product check requires one additional HTTP request to
 be sent to the server as part of the request pipeline before the main API call is sent.
 In most cases, this will succeed during the very first API call that the client sends.
-Once the product check completes, no further product check HTTP requests are sent for 
+Once the product check completes, no further product check HTTP requests are sent for
 subsequent API calls.

docs/doc_examples/015e6e6132b6d6d44bddb06bc3b316ed.asciidoc

@@ -0,0 +1,46 @@
+// 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

@@ -0,0 +1,18 @@
+// 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

@@ -0,0 +1,49 @@
+// 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,8 +3,12 @@
 
 [source, js]
 ----
-const response = await client.esql.asyncQuery({
-  format: "json",
+const response = await client.transport.request({
+  method: "POST",
+  path: "/_query/async",
+  querystring: {
+    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

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

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                \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              {{/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/17b1647c8509543f2388c886f2584a20.asciidoc

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

docs/doc_examples/19c00c6b29bc7dbc5e92b3668da2da93.asciidoc

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

docs/doc_examples/216e24f05cbb82c1718713fbab8623d2.asciidoc

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

docs/doc_examples/22b176a184517cf1b5801f5eb4f17f97.asciidoc

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

docs/doc_examples/2577acb462b95bd4394523cf2f8a661f.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.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,7 +3,9 @@
 
 [source, js]
 ----
-const response = await client.security.oidcLogout({
+const response = await client.transport.request({
+  method: "POST",
+  path: "/_security/oidc/logout",
   body: {
     token:
       "dGhpcyBpcyBub3QgYSByZWFsIHRva2VuIGJ1dCBpdCBpcyBvbmx5IHRlc3QgZGF0YS4gZG8gbm90IHRyeSB0byByZWFkIHRva2VuIQ==",

docs/doc_examples/2afdf0d83724953aa2875b5fb37d60cc.asciidoc

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

docs/doc_examples/2bb41b0b4876ce98cd0cd8fb6d337f18.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.cluster.putSettings({
-  persistent: {
-    "cluster.indices.close.enable": false,
-    "indices.recovery.max_bytes_per_sec": "50mb",
-  },
-  transient: {
-    "*": null,
-  },
-});
-console.log(response);
-----

docs/doc_examples/30d051f534aeb884176eedb2c11dac85.asciidoc

@@ -0,0 +1,23 @@
+// 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/334811cfceb6858aeec5b3461717dd63.asciidoc

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

docs/doc_examples/3f1fe5f5f99b98d0891f38003e10b636.asciidoc

@@ -3,7 +3,9 @@
 
 [source, js]
 ----
-const response = await client.esql.asyncQuery({
+const response = await client.transport.request({
+  method: "POST",
+  path: "/_query/async",
   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/405511f7c1f12cc0a227b4563fe7b2e2.asciidoc

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

docs/doc_examples/4b91ad7c9b44e07db4a4e81390f19ad3.asciidoc

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

docs/doc_examples/4edfb5934d14ad7655bd7e19a112b5c0.asciidoc

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

docs/doc_examples/57dc15e5ad663c342fd5c1d86fcd1b29.asciidoc

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

docs/doc_examples/5bba213a7f543190139d1a69ab2ed076.asciidoc

@@ -3,8 +3,12 @@
 
 [source, js]
 ----
-const response = await client.esql.asyncQuery({
-  format: "json",
+const response = await client.transport.request({
+  method: "POST",
+  path: "/_query/async",
+  querystring: {
+    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/5e021307d331a4483a5aa2198168451b.asciidoc

@@ -4,7 +4,7 @@
 [source, js]
 ----
 const response = await client.security.putRole({
-  name: "role_with_remote_indices",
+  name: "only_remote_access_role",
   remote_indices: [
     {
       clusters: ["my_remote"],
@@ -12,6 +12,12 @@ 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/5f16358ebb5d14b86f57612d5f92d923.asciidoc

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

docs/doc_examples/68d7f7d4d268ee98caead5aef19933d6.asciidoc

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

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

docs/doc_examples/76e02434835630cb830724beb92df354.asciidoc

@@ -0,0 +1,44 @@
+// 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,7 +3,9 @@
 
 [source, js]
 ----
-const response = await client.textStructure.findMessageStructure({
+const response = await client.transport.request({
+  method: "POST",
+  path: "/_text_structure/find_message_structure",
   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

@@ -0,0 +1,46 @@
+// 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/79d206a528be704050a437adce2496dd.asciidoc

@@ -0,0 +1,23 @@
+// 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: 10,
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/7a2fdfd7b0553d63440af7598f9ad867.asciidoc

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

docs/doc_examples/7ba29f0be2297b54a640b0a17d7ef5ca.asciidoc

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

docs/doc_examples/7f1fade93225f8cf6000b93334d76ce4.asciidoc

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

docs/doc_examples/8a0b5f759de3f27f0801c1176e616117.asciidoc

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

docs/doc_examples/91e106a2affbc8df32cd940684a779ed.asciidoc

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

docs/doc_examples/9313f534e1aa266cde7d4af74665497f.asciidoc

@@ -0,0 +1,13 @@
+// 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/96e88611f99e6834bd64b58dc8a282c1.asciidoc

@@ -0,0 +1,18 @@
+// 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

@@ -0,0 +1,37 @@
+// 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/99fb82d49ac477e6a9dfdd71f9465374.asciidoc

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

docs/doc_examples/9afa0844883b7471883aa378a8dd10b4.asciidoc

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

docs/doc_examples/9c01db07c9ac395b6370e3b33965c21f.asciidoc

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

docs/doc_examples/a162eb50853331c80596f5994e9d1c38.asciidoc

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

docs/doc_examples/a3779f21f132787c48681bfb50453592.asciidoc

@@ -0,0 +1,34 @@
+// 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

@@ -0,0 +1,27 @@
+// 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

@@ -0,0 +1,37 @@
+// 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/ad9889fd8a4b5930e312a51f3bc996dc.asciidoc

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

docs/doc_examples/ae3473adaf1515afcf7773f26c018e5c.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.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.searchApplication.renderQuery({
-  name: "my_search_application",
-  body: null,
+const response = await client.transport.request({
+  method: "POST",
+  path: "/_application/search_application/my_search_application/_render_query",
 });
 console.log(response);
 ----

docs/doc_examples/b0ee6f19875fe5bad8aab02d60e3532c.asciidoc

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

docs/doc_examples/b62eaa20c4e0e48134a6d1d1b3c30b26.asciidoc

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

docs/doc_examples/bb2ba5d1885f87506f90dbb002e518f4.asciidoc

@@ -0,0 +1,45 @@
+// 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/bcdfaa4487747249699a86a0dcd22f5e.asciidoc

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

docs/doc_examples/bee3fda7bb07086243424b62e5b16ca7.asciidoc

@@ -0,0 +1,83 @@
+// 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/c580990a70028bb49cca8a6bde86bbf6.asciidoc

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

docs/doc_examples/ccc613951c61f0b17e1ed8a2d3ae54a2.asciidoc

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

docs/doc_examples/d01a590fa9ea8a0cb34ed8dda502296c.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.cluster.getSettings({
-  flat_settings: "true",
-  filter_path: "transient",
-});
-console.log(response);
-----

docs/doc_examples/d35c8cf7a98b3f112e1de8797ec6689d.asciidoc

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

docs/doc_examples/d4158d486e7fee2702a14068b69e3b33.asciidoc

@@ -0,0 +1,154 @@
+// 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

@@ -0,0 +1,15 @@
+// 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/d8c053ee26c1533ce936ec81101d8e1b.asciidoc

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

docs/doc_examples/dd71b0c9f9197684ff29c61062c55660.asciidoc

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

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

docs/doc_examples/e3019fd5f23458ae49ad9854c97d321c.asciidoc

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

docs/doc_examples/e308899a306e61d1a590868308689955.asciidoc

@@ -0,0 +1,36 @@
+// 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",
+        target_field: "geo",
+        database_file: "GeoLite2-Country.mmdb",
+      },
+    },
+  ],
+});
+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/e4b38973c74037335378d8480f1ce894.asciidoc

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

docs/doc_examples/e6f6d3aeea7ecea47cfd5c3d727f7004.asciidoc

@@ -0,0 +1,44 @@
+// 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,
+    },
+  },
+  collapse: {
+    field: "year",
+    inner_hits: {
+      name: "topic related documents",
+      _source: ["year"],
+    },
+  },
+  _source: false,
+});
+console.log(response);
+----

docs/doc_examples/ee05714a83d75fb6858e3b9fcbeb8f8b.asciidoc

@@ -0,0 +1,94 @@
+// 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",
+  mappings: {
+    properties: {
+      vector: {
+        type: "dense_vector",
+        dims: 3,
+        similarity: "l2_norm",
+        index: true,
+      },
+      text: {
+        type: "text",
+      },
+      year: {
+        type: "integer",
+      },
+      topic: {
+        type: "keyword",
+      },
+    },
+  },
+});
+console.log(response);
+
+const response1 = await client.index({
+  index: "retrievers_example",
+  id: 1,
+  document: {
+    vector: [0.23, 0.67, 0.89],
+    text: "Large language models are revolutionizing information retrieval by boosting search precision, deepening contextual understanding, and reshaping user experiences in data-rich environments.",
+    year: 2024,
+    topic: ["llm", "ai", "information_retrieval"],
+  },
+});
+console.log(response1);
+
+const response2 = await client.index({
+  index: "retrievers_example",
+  id: 2,
+  document: {
+    vector: [0.12, 0.56, 0.78],
+    text: "Artificial intelligence is transforming medicine, from advancing diagnostics and tailoring treatment plans to empowering predictive patient care for improved health outcomes.",
+    year: 2023,
+    topic: ["ai", "medicine"],
+  },
+});
+console.log(response2);
+
+const response3 = await client.index({
+  index: "retrievers_example",
+  id: 3,
+  document: {
+    vector: [0.45, 0.32, 0.91],
+    text: "AI is redefining security by enabling advanced threat detection, proactive risk analysis, and dynamic defenses against increasingly sophisticated cyber threats.",
+    year: 2024,
+    topic: ["ai", "security"],
+  },
+});
+console.log(response3);
+
+const response4 = await client.index({
+  index: "retrievers_example",
+  id: 4,
+  document: {
+    vector: [0.34, 0.21, 0.98],
+    text: "Elastic introduces Elastic AI Assistant, the open, generative AI sidekick powered by ESRE to democratize cybersecurity and enable users of every skill level.",
+    year: 2023,
+    topic: ["ai", "elastic", "assistant"],
+  },
+});
+console.log(response4);
+
+const response5 = await client.index({
+  index: "retrievers_example",
+  id: 5,
+  document: {
+    vector: [0.11, 0.65, 0.47],
+    text: "Learn how to spin up a deployment of our hosted Elasticsearch Service and use Elastic Observability to gain deeper insight into the behavior of your applications and systems.",
+    year: 2024,
+    topic: ["documentation", "observability", "elastic"],
+  },
+});
+console.log(response5);
+
+const response6 = await client.indices.refresh({
+  index: "retrievers_example",
+});
+console.log(response6);
+----

docs/doc_examples/f6f647eb644a2d236637ff05f833cb73.asciidoc

@@ -3,7 +3,9 @@
 
 [source, js]
 ----
-const response = await client.connector.secretPost({
+const response = await client.transport.request({
+  method: "POST",
+  path: "/_connector/_secret",
   body: {
     value: "encoded_api_key",
   },

docs/examples/bulk.asciidoc

@@ -1,10 +1,10 @@
 [[bulk_examples]]
 === Bulk
 
-The `bulk` API makes it possible to perform many index/delete operations in a 
-single API call. This can greatly increase the indexing speed.
+With the {jsclient}/api-reference.html#_bulk[`bulk` API], you can perform multiple index/delete operations in a 
+single API call. The `bulk` API significantly increases indexing speed.
 
-NOTE: Did you know that we provide an helper for sending bulk request? You can find it {jsclient}/client-helpers.html[here].
+NOTE: You can also use the {jsclient}/client-helpers.html[bulk helper].
 
 [source,js]
 ----

docs/helpers.asciidoc

@@ -1,10 +1,10 @@
 [[client-helpers]]
 == Client helpers
 
-The client comes with an handy collection of helpers to give you a more 
+The client comes with an handy collection of helpers to give you a more
 comfortable experience with some APIs.
 
-CAUTION: The client helpers are experimental, and the API may change in the next 
+CAUTION: The client helpers are experimental, and the API may change in the next
 minor releases. The helpers will not work in any Node.js version lower than 10.
 
 
@@ -14,7 +14,7 @@ minor releases. The helpers will not work in any Node.js version lower than 10.
 
 ~Added~ ~in~ ~`v7.7.0`~
 
-Running bulk requests can be complex due to the shape of the API, this helper 
+Running bulk requests can be complex due to the shape of the API, this helper
 aims to provide a nicer developer experience around the Bulk API.
 
 
@@ -52,7 +52,7 @@ console.log(result)
 // }
 ----
 
-To create a new instance of the Bulk helper, access it as shown in the example 
+To create a new instance of the Bulk helper, access it as shown in the example
 above, the configuration options are:
 [cols=2*]
 |===
@@ -83,7 +83,7 @@ const b = client.helpers.bulk({
     return {
       index: { _index: 'my-index' }
     }
-  } 
+  }
 })
 ----
 
@@ -94,7 +94,7 @@ a|A function that is called for everytime a document can't be indexed and it has
 const b = client.helpers.bulk({
   onDrop (doc) {
     console.log(doc)
-  } 
+  }
 })
 ----
 
@@ -105,7 +105,7 @@ a|A function that is called for each successful operation in the bulk request, w
 const b = client.helpers.bulk({
   onSuccess ({ result, document }) {
     console.log(`SUCCESS: Document ${result.index._id} indexed to ${result.index._index}`)
-  } 
+  }
 })
 ----
 
@@ -249,11 +249,11 @@ client.helpers.bulk({
 [discrete]
 ==== Abort a bulk operation
 
-If needed, you can abort a bulk operation at any time. The bulk helper returns a 
+If needed, you can abort a bulk operation at any time. The bulk helper returns a
 https://promisesaplus.com/[thenable], which has an `abort` method.
 
-NOTE: The abort method stops the execution of the bulk operation, but if you 
-are using a concurrency higher than one, the operations that are already running 
+NOTE: The abort method stops the execution of the bulk operation, but if you
+are using a concurrency higher than one, the operations that are already running
 will not be stopped.
 
 [source,js]
@@ -275,7 +275,7 @@ const b = client.helpers.bulk({
   },
   onDrop (doc) {
     b.abort()
-  } 
+  }
 })
 
 console.log(await b)
@@ -285,8 +285,8 @@ console.log(await b)
 [discrete]
 ==== Passing custom options to the Bulk API
 
-You can pass any option supported by the link: 
-{ref}/docs-bulk.html#docs-bulk-api-query-params[Bulk API] to the helper, and the 
+You can pass any option supported by the link:
+{ref}/docs-bulk.html#docs-bulk-api-query-params[Bulk API] to the helper, and the
 helper uses those options in conjunction with the Bulk API call.
 
 [source,js]
@@ -371,10 +371,10 @@ console.log(result)
 
 ~Added~ ~in~ ~`v7.8.0`~
 
-If you send search request at a high rate, this helper might be useful 
-for you. It uses the multi search API under the hood to batch the requests 
-and improve the overall performances of your application. The `result` exposes a 
-`documents` property as well, which allows you to access directly the hits 
+If you send search request at a high rate, this helper might be useful
+for you. It uses the multi search API under the hood to batch the requests
+and improve the overall performances of your application. The `result` exposes a
+`documents` property as well, which allows you to access directly the hits
 sources.
 
 
@@ -399,7 +399,7 @@ m.search(
   .catch(err => console.error(err))
 ----
 
-To create a new instance of the multi search (msearch) helper, you should access 
+To create a new instance of the multi search (msearch) helper, you should access
 it as shown in the example above, the configuration options are:
 [cols=2*]
 |===
@@ -459,18 +459,18 @@ const m = client.helpers.msearch({
 [discrete]
 ==== Stopping the msearch helper
 
-If needed, you can stop an msearch processor at any time. The msearch helper 
+If needed, you can stop an msearch processor at any time. The msearch helper
 returns a https://promisesaplus.com/[thenable], which has an `stop` method.
 
-If you are creating multiple msearch helpers instances and using them for a 
-limitied period of time, remember to always use the `stop` method once you have 
+If you are creating multiple msearch helpers instances and using them for a
+limitied period of time, remember to always use the `stop` method once you have
 finished using them, otherwise your application will start leaking memory.
 
-The `stop` method accepts an optional error, that will be dispatched every 
+The `stop` method accepts an optional error, that will be dispatched every
 subsequent search request.
 
-NOTE: The stop method stops the execution of the msearch processor, but if 
-you are using a concurrency higher than one, the operations that are already 
+NOTE: The stop method stops the execution of the msearch processor, but if
+you are using a concurrency higher than one, the operations that are already
 running will not be stopped.
 
 [source,js]
@@ -507,9 +507,9 @@ setImmediate(() => m.stop())
 
 ~Added~ ~in~ ~`v7.7.0`~
 
-A simple wrapper around the search API. Instead of returning the entire `result` 
-object it returns only the search documents source. For improving the 
-performances, this helper automatically adds `filter_path=hits.hits._source` to 
+A simple wrapper around the search API. Instead of returning the entire `result`
+object it returns only the search documents source. For improving the
+performances, this helper automatically adds `filter_path=hits.hits._source` to
 the query string.
 
 [source,js]
@@ -535,10 +535,10 @@ for (const doc of documents) {
 
 ~Added~ ~in~ ~`v7.7.0`~
 
-This helpers offers a simple and intuitive way to use the scroll search API. 
-Once called, it returns an 
-https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function[async iterator] 
-which can be used in conjuction with a for-await...of. It handles automatically 
+This helpers offers a simple and intuitive way to use the scroll search API.
+Once called, it returns an
+https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function[async iterator]
+which can be used in conjuction with a for-await...of. It handles automatically
 the `429` error and uses the `maxRetries` option of the client.
 
 [source,js]
@@ -576,7 +576,7 @@ for await (const result of scrollSearch) {
 [discrete]
 ==== Quickly getting the documents
 
-If you only need the documents from the result of a scroll search, you can 
+If you only need the documents from the result of a scroll search, you can
 access them via `result.documents`:
 
 [source,js]
@@ -593,9 +593,9 @@ for await (const result of scrollSearch) {
 
 ~Added~ ~in~ ~`v7.7.0`~
 
-It works in the same way as the scroll search helper, but it returns only the 
-documents instead. Note, every loop cycle returns a single document, and you 
-can't use the `clear` method. For improving the performances, this helper 
+It works in the same way as the scroll search helper, but it returns only the
+documents instead. Note, every loop cycle returns a single document, and you
+can't use the `clear` method. For improving the performances, this helper
 automatically adds `filter_path=hits.hits._source` to the query string.
 
 [source,js]
@@ -707,3 +707,42 @@ const result = await client.helpers
   .esql({ query: 'FROM sample_data | LIMIT 2' })
   .toRecords<EventLog>()
 ----
+
+[discrete]
+===== `toArrowReader`
+
+~Added~ ~in~ ~`v8.16.0`~
+
+ES|QL can return results in multiple binary formats, including https://arrow.apache.org/[Apache Arrow]'s streaming format. Because it is a very efficient format to read, it can be valuable for performing high-performance in-memory analytics. And, because the response is streamed as batches of records, it can be used to produce aggregations and other calculations on larger-than-memory data sets.
+
+`toArrowReader` returns a https://arrow.apache.org/docs/js/classes/Arrow_dom.RecordBatchReader.html[`RecordBatchStreamReader`].
+
+[source,ts]
+----
+const reader = await client.helpers
+  .esql({ query: 'FROM sample_data' })
+  .toArrowReader()
+
+// print each record as JSON
+for (const recordBatch of reader) {
+  for (const record of recordBatch) {
+    console.log(record.toJSON())
+  }
+}
+----
+
+[discrete]
+===== `toArrowTable`
+
+~Added~ ~in~ ~`v8.16.0`~
+
+If you would like to pull the entire data set in Arrow format but without streaming, you can use the `toArrowTable` helper to get a https://arrow.apache.org/docs/js/classes/Arrow_dom.Table.html[Table] back instead.
+
+[source,ts]
+----
+const table = await client.helpers
+  .esql({ query: 'FROM sample_data' })
+  .toArrowTable()
+
+console.log(table.toArray())
+----

docs/transport.asciidoc

@@ -1,7 +1,7 @@
 [[transport]]
 === Transport
 
-This class is responsible for performing the request to {es} and handling 
+This class is responsible for performing the request to {es} and handling
 errors, it also handles sniffing.
 
 [source,js]
@@ -20,7 +20,7 @@ const client = new Client({
 })
 ----
 
-Sometimes you need to inject a small snippet of your code and then continue to 
+Sometimes you need to inject a small snippet of your code and then continue to
 use the usual client code. In such cases, call `super.method`:
 
 [source,js]
@@ -35,8 +35,39 @@ class MyTransport extends Transport {
 
 ==== Supported content types
 
-- `application/json`, in this case the transport will return a plain JavaScript object
-- `text/plain`, in this case the transport will return a plain string
-- `application/vnd.mapbox-vector-tile`, in this case the transport will return a Buffer
-- `application/vnd.elasticsearch+json`, in this case the transport will return a plain JavaScript object
+Depending on the `content-type` of the response, the transport will return the body as different types:
 
+[cols="1,1"]
+|===
+|Content-Type |JavaScript type
+
+|`application/json`
+|`object`
+
+|`text/plain`
+|`string`
+
+|`application/vnd.elasticsearch+json`
+|`object`
+
+|`application/vnd.mapbox-vector-tile`
+|`Buffer`
+
+|`application/vnd.apache.arrow.stream`
+|`Buffer`
+
+|`application/vnd.elasticsearch+arrow+stream`
+|`Buffer`
+
+|`application/smile`
+|`Buffer`
+
+|`application/vnd.elasticsearch+smile`
+|`Buffer`
+
+|`application/cbor`
+|`Buffer`
+
+|`application/vnd.elasticsearch+cbor`
+|`Buffer`
+|===