Switch 8.9 clients to only get patch updates to transport (#2213 )

[Backport 8.9] Add important flag to proxy config docs (#2042 )
(cherry picked from commit f7ed0394bf) Co-authored-by: Josh Mock <joshua.mock@elastic.co>
2024-04-09 12:54:05 -05:00 · 2023-10-24 15:40:30 -05:00 · 2023-10-24 14:10:52 -05:00 · 2023-09-28 11:30:53 -05:00 · 2023-09-22 11:31:46 -05:00 · 2023-09-14 11:26:01 -05:00
3639 changed files with 10449 additions and 89457 deletions
--- a/.buildkite/Dockerfile
+++ b/.buildkite/Dockerfile
@ -10,7 +10,5 @@ RUN apt-get clean -y && \

 WORKDIR /usr/src/app

-COPY package.json .
-RUN npm install --production=false
-
 COPY . .
+RUN npm install --production=false
--- a/.buildkite/Dockerfile-make
+++ b/.buildkite/Dockerfile-make
@ -1,30 +0,0 @@
-ARG NODE_JS_VERSION=${NODE_JS_VERSION:-18}
-FROM node:${NODE_JS_VERSION}
-
-ARG BUILDER_UID=1000
-ARG BUILDER_GID=1000
-ENV BUILDER_USER elastic
-ENV BUILDER_GROUP elastic
-
-# install zip util
-RUN apt-get clean -y && \
-    apt-get update -y && \
-    apt-get install -y zip
-
-# Set user permissions and directory
-RUN (id -g ${BUILDER_GID} || groupadd --system -g ${BUILDER_GID} ${BUILDER_GROUP}) \
-    && (id -u ${BUILDER_UID} || useradd --system --shell /bin/bash -u ${BUILDER_UID} -g ${BUILDER_GID} -m elastic) \
-    && mkdir -p /usr/src/elasticsearch-js \
-    && chown -R ${BUILDER_UID}:${BUILDER_GID} /usr/src/
-
-WORKDIR /usr/src/elasticsearch-js
-
-# run remainder of commands as non-root user
-USER ${BUILDER_UID}:${BUILDER_GID}
-
-# install dependencies
-COPY package.json .
-RUN npm install --production=false
-
-# copy project files
-COPY . .
--- a/.buildkite/functions/cleanup.sh
+++ b/.buildkite/functions/cleanup.sh
@ -2,7 +2,7 @@
 #
 # Shared cleanup routines between different steps
 #
-# Please source .buildkite/functions/imports.sh as a whole not just this file
+# Please source .ci/functions/imports.sh as a whole not just this file
 #
 # Version 1.0.0
 # - Initial version after refactor
--- a/.buildkite/functions/wait-for-container.sh
+++ b/.buildkite/functions/wait-for-container.sh
@ -2,7 +2,7 @@
 #
 # Exposes a routine scripts can call to wait for a container if that container set up a health command
 #
-# Please source .buildkite/functions/imports.sh as a whole not just this file
+# Please source .ci/functions/imports.sh as a whole not just this file
 #
 # Version 1.0.1
 # - Initial version after refactor
--- a/.buildkite/pipeline.yml
+++ b/.buildkite/pipeline.yml
@ -1,4 +1,3 @@
---
 steps:
  - label: ":elasticsearch: :javascript: ES JavaScript ({{ matrix.nodejs }}) Test Suite: {{ matrix.suite }}"
    agents:
@ -6,16 +5,16 @@ steps:
    env:
      NODE_VERSION: "{{ matrix.nodejs }}"
      TEST_SUITE: "{{ matrix.suite }}"
-      STACK_VERSION: 8.15.0
+      STACK_VERSION: 8.8.0-SNAPSHOT
    matrix:
      setup:
        suite:
          - "free"
          - "platinum"
        nodejs:
+          - "16"
          - "18"
          - "20"
-          - "22"
    command: ./.buildkite/run-tests.sh
    artifact_paths: "./junit-output/junit-*.xml"
  - wait: ~
@ -27,6 +26,6 @@ steps:
    plugins:
      - junit-annotate#v2.4.1:
          artifacts: "junit-output/junit-*.xml"
-          job-uuid-file-pattern: "junit-(.*).xml"
+          job-uuid-file-pattern: 'junit-(.*).xml'
          fail-build-on-error: true
          failure-format: file
--- a/.buildkite/pull-requests.json
+++ b/.buildkite/pull-requests.json
@ -9,6 +9,7 @@
        "\\.md$",
        "\\.asciidoc$",
        "^docs\\/",
+        "^\\.ci\\/",
        "^scripts\\/",
        "^catalog-info\\.yaml$",
        "^test\\/unit\\/",
--- a/.ci/Dockerfile
+++ b/.ci/Dockerfile
@ -0,0 +1,26 @@
+ARG NODE_JS_VERSION=18
+FROM node:${NODE_JS_VERSION}
+
+ARG BUILDER_UID=1000
+ARG BUILDER_GID=1000
+ENV BUILDER_USER elastic
+ENV BUILDER_GROUP elastic
+
+# install zip util
+RUN apt-get clean -y && \
+    apt-get update -y && \
+    apt-get install -y zip
+
+# Set user permissions and directory
+RUN groupadd --system -g ${BUILDER_GID} ${BUILDER_GROUP} \
+    && useradd --system --shell /bin/bash -u ${BUILDER_UID} -g ${BUILDER_GROUP} -m elastic 1>/dev/null 2>/dev/null \
+    && mkdir -p /usr/src/elasticsearch-js \
+    && chown -R ${BUILDER_USER}:${BUILDER_GROUP} /usr/src/
+WORKDIR /usr/src/elasticsearch-js
+USER ${BUILDER_USER}:${BUILDER_GROUP}
+
+# Install app dependencies
+COPY --chown=$BUILDER_USER:$BUILDER_GROUP package*.json ./
+RUN npm install
+
+COPY --chown=$BUILDER_USER:$BUILDER_GROUP . .
--- a/.buildkite/make.mjs
+++ b/.buildkite/make.mjs
@ -28,11 +28,6 @@ import assert from 'assert'
 import { join } from 'desm'
 import semver from 'semver'

-// xz/globals loads minimist-parsed args as a global `argv`, but it
-// interprets args like '8.10' as numbers and shortens them to '8.1'.
-// so we have to import and configure minimist ourselves.
-import minimist from 'minimist'
-const argv = minimist(process.argv.slice(2), { string: ['_', 'task'] })
 assert(typeof argv.task === 'string', 'Missing task parameter')

 switch (argv.task) {
@ -74,15 +69,14 @@ async function release (args) {

 async function bump (args) {
  assert(args.length === 1, 'Bump task expects one parameter')
-  let [version] = args
+  const [version] = args
  const packageJson = JSON.parse(await readFile(
    join(import.meta.url, '..', 'package.json'),
    'utf8'
  ))

-  if (version.split('.').length === 2) version = `${version}.0`
  const cleanVersion = semver.clean(version.includes('SNAPSHOT') ? version.split('-')[0] : version)
-  assert(semver.valid(cleanVersion), `${cleanVersion} is not seen as a valid semver version. raw version: ${version}`)
+  assert(semver.valid(cleanVersion))
  packageJson.version = cleanVersion
  packageJson.versionCanary = `${cleanVersion}-canary.0`

@ -92,10 +86,10 @@ async function bump (args) {
    'utf8'
  )

-  const pipeline = await readFile(join(import.meta.url, '..', '.buildkite', 'pipeline.yml'), 'utf8')
+  const pipeline = await readFile(join(import.meta.url, '..', '.buildkite', 'pipeline.yml'))
  await writeFile(
    join(import.meta.url, '..', '.buildkite', 'pipeline.yml'),
-    pipeline.replace(/STACK_VERSION: [0-9]+[0-9\.]*[0-9](?:\-SNAPSHOT)?/, `STACK_VERSION: ${cleanVersion}`),
+    pipeline.replace(/STACK_VERSION: [0-9]+[0-9\.]*[0-9](?:\-SNAPSHOT)?/, `STACK_VERSION: ${cleanVersion}-SNAPSHOT`), // eslint-disable-line
    'utf8'
  )
 }
@ -125,13 +119,6 @@ async function codegen (args) {
  await $`cp -R ${join(import.meta.url, '..', '..', 'elastic-client-generator-js', 'output')}/* ${join(import.meta.url, '..', 'src', 'api')}`
  await $`mv ${join(import.meta.url, '..', 'src', 'api', 'reference.asciidoc')} ${join(import.meta.url, '..', 'docs', 'reference.asciidoc')}`
  await $`npm run build`
-
-  // run docs example generation
-  if (version === 'main') {
-    await $`node ./scripts/generate-docs-examples.js`
-  } else {
-    await $`node ./scripts/generate-docs-examples.js ${version.split('.').slice(0, 2).join('.')}`
-  }
 }

 function onError (err) {
--- a/.github/make.sh
+++ b/.github/make.sh
@ -3,7 +3,7 @@
 #
 # Build entry script for elasticsearch-js
 #
-# Must be called: ./.github/make.sh <target> <params>
+# Must be called: ./.ci/make.sh <target> <params>
 #
 # Version: 1.1.0
 #
@ -34,8 +34,8 @@ STACK_VERSION=$VERSION
 set -euo pipefail

 product="elastic/elasticsearch-js"
-output_folder=".buildkite/output"
-codegen_folder=".buildkite/output"
+output_folder=".ci/output"
+codegen_folder=".ci/output"
 OUTPUT_DIR="$repo/${output_folder}"
 NODE_JS_VERSION=18
 WORKFLOW=${WORKFLOW-staging}
@ -131,7 +131,7 @@ esac
 echo -e "\033[34;1mINFO: building $product container\033[0m"

 docker build \
-  --file .buildkite/Dockerfile-make \
+  --file .ci/Dockerfile \
  --tag "$product" \
  --build-arg NODE_JS_VERSION="$NODE_JS_VERSION" \
  --build-arg "BUILDER_UID=$(id -u)" \
@ -144,50 +144,26 @@ docker build \

 echo -e "\033[34;1mINFO: running $product container\033[0m"

-if [[ -z "${BUILDKITE+x}" ]] && [[ -z "${CI+x}" ]] && [[ -z "${GITHUB_ACTIONS+x}" ]]; then
-  echo -e "\033[34;1mINFO: Running in local mode"
-  docker run \
-    -u "$(id -u):$(id -g)" \
-    --volume "$repo:/usr/src/elasticsearch-js" \
-    --volume /usr/src/elasticsearch-js/node_modules \
-    --volume "$(realpath "$repo/../elastic-client-generator-js"):/usr/src/elastic-client-generator-js" \
-    --env "WORKFLOW=$WORKFLOW" \
-    --name make-elasticsearch-js \
-    --rm \
-    $product \
-    /bin/bash -c "mkdir -p /usr/src/elastic-client-generator-js/output && \
-      node .buildkite/make.mjs --task $TASK ${TASK_ARGS[*]}"
-else
-  echo -e "\033[34;1mINFO: Running in CI mode"
-
-  # determine branch to clone
-  GENERATOR_BRANCH="main"
-  if [[ "$VERSION" == 8.* ]]; then
-    GENERATOR_BRANCH="8.x"
-  fi
-  echo -e "\033[34;1mINFO: Generator branch: $GENERATOR_BRANCH"
-
-  docker run \
-    --volume "$repo:/usr/src/elasticsearch-js" \
-    --volume /usr/src/elasticsearch-js/node_modules \
-    -u "$(id -u):$(id -g)" \
-    --env "WORKFLOW=$WORKFLOW" \
-    --name make-elasticsearch-js \
-    --rm \
-    $product \
-    /bin/bash -c "cd /usr/src && \
-      git clone --branch $GENERATOR_BRANCH https://$CLIENTS_GITHUB_TOKEN@github.com/elastic/elastic-client-generator-js.git && \
-      mkdir -p /usr/src/elastic-client-generator-js/output && \
-      cd /usr/src/elasticsearch-js && \
-      node .buildkite/make.mjs --task $TASK ${TASK_ARGS[*]}"
-fi
+docker run \
+  --volume "$repo:/usr/src/elasticsearch-js" \
+  --volume /usr/src/elasticsearch-js/node_modules \
+  -u "$(id -u):$(id -g)" \
+  --env "WORKFLOW=$WORKFLOW" \
+  --name make-elasticsearch-js \
+  --rm \
+  $product \
+  /bin/bash -c "cd /usr/src && \
+    git clone https://$CLIENTS_GITHUB_TOKEN@github.com/elastic/elastic-client-generator-js.git && \
+    mkdir -p /usr/src/elastic-client-generator-js/output && \
+    cd /usr/src/elasticsearch-js && \
+    node .ci/make.mjs --task $TASK ${TASK_ARGS[*]}"

 # ------------------------------------------------------- #
 # Post Command tasks & checks
 # ------------------------------------------------------- #

 if [[ "$CMD" == "assemble" ]]; then
-	if compgen -G ".buildkite/output/*" > /dev/null; then
+	if compgen -G ".ci/output/*" > /dev/null; then
 		echo -e "\033[32;1mTARGET: successfully assembled client v$VERSION\033[0m"
 	else
 		echo -e "\033[31;1mTARGET: assemble failed, empty workspace!\033[0m"
--- a/.dockerignore
+++ b/.dockerignore
@ -3,6 +3,3 @@ npm-debug.log
 test/benchmarks
 elasticsearch
 .git
-lib
-junit-output
-.tap
--- a/.github/ISSUE_TEMPLATE/bug.md
+++ b/.github/ISSUE_TEMPLATE/bug.md
@ -1,14 +1,13 @@
 ---
 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.**
+locked, and assigned the `not reproducible` label.**

 ## 🐛 Bug Report

--- a/.github/ISSUE_TEMPLATE/feature.md
+++ b/.github/ISSUE_TEMPLATE/feature.md
@ -1,14 +1,13 @@
 ---
 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.**
+locked, and assigned the `invalid` label.**

 ## 🚀 Feature Proposal

--- a/.github/ISSUE_TEMPLATE/question.md
+++ b/.github/ISSUE_TEMPLATE/question.md
@ -1,7 +1,6 @@
 ---
 name: 💬 Questions / Help
 about: If you have questions, please check our Gitter or Help repo
-labels: ["Category: Question"]
 ---

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

 jobs:
  backport:
-    name: Backport
    runs-on: ubuntu-latest
-    # Only react to merged PRs for security reasons.
-    # See https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#pull_request_target.
-    if: >
-      github.event.pull_request.merged
-      && (
-        github.event.action == 'closed'
-        || (
-          github.event.action == 'labeled'
-          && contains(github.event.label.name, 'backport')
-        )
-      )
+    name: Backport
    steps:
-      - uses: tibdex/backport@9565281eda0731b1d20c4025c43339fb0a23812e  # v2.0.4
+      - name: Backport
+        uses: tibdex/backport@7005ef85c4562bc23b0e9b4a9940d5922f439750
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
--- a/.github/workflows/nodejs.yml
+++ b/.github/workflows/nodejs.yml
@ -1,46 +1,34 @@
 ---
 name: Node CI

-on:
-  pull_request: {}
+on: [push, pull_request]

 jobs:
-  paths-filter:
-    name: Detect files changed
-    runs-on: ubuntu-latest
-    outputs:
-      src-only: "${{ steps.changes.outputs.src-only }}"
-    steps:
-      - uses: actions/checkout@v4
-      - uses: dorny/paths-filter/@v2.11.1
-        id: changes
-        with:
-          filters: |
-            src-only:
-              - '!(**/*.{md,asciidoc,txt}|*.{md,asciidoc,txt}|{docs,.buildkite,scripts}/**/*|catalog-info.yaml)'
-              - '.github/workflows/**'
-
  test:
    name: Test
    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:
-        node-version: [18.x, 20.x, 22.x]
+        node-version: [14.x, 16.x, 18.x, 20.x]
        os: [ubuntu-latest, windows-latest, macOS-latest]

    steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v3

      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v3
        with:
          node-version: ${{ matrix.node-version }}

+      # workaround for failing tests on Node.js 14.x
+      # see https://github.com/actions/setup-node/issues/411
+      - name: Force install specific npm version
+        run: |
+          npm install --global npm@8.3.1
+          npm install --global npm@9.7.1
+
      - name: Install
        run: |
          npm install
@ -57,13 +45,17 @@ jobs:
    name: License check
    runs-on: ubuntu-latest

-    steps:
-      - uses: actions/checkout@v4
+    strategy:
+      matrix:
+        node-version: [20.x]

-      - name: Use Node.js
-        uses: actions/setup-node@v4
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v3
        with:
-          node-version: 22.x
+          node-version: ${{ matrix.node-version }}

      - name: Install
        run: |
@ -72,13 +64,3 @@ jobs:
      - name: License checker
        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'
-    steps:
-      - uses: hmarr/auto-approve-action@v4
--- a/.github/workflows/npm-publish.yml
+++ b/.github/workflows/npm-publish.yml
@ -1,37 +0,0 @@
-name: Publish Package to npm
-on:
-  workflow_dispatch:
-    inputs:
-      branch:
-        description: "Git branch to build and publish"
-        required: true
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      id-token: write
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: ${{ github.event.inputs.branch }}
-      - uses: actions/setup-node@v3
-        with:
-          node-version: "20.x"
-          registry-url: "https://registry.npmjs.org"
-      - run: npm install -g npm
-      - run: npm install
-      - run: npm test
-      - run: npm publish --provenance --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-      - 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)" \
-            --target "$BRANCH_NAME" \
-            -t "v$version" \
-            "v$version"
-        env:
-          BRANCH_NAME: ${{ github.event.inputs.branch }}
-          GH_TOKEN: ${{ github.token }}
--- a/.github/workflows/serverless-patch.sh
+++ b/.github/workflows/serverless-patch.sh
@ -1,43 +0,0 @@
-#!/usr/bin/env bash
-
-set -exuo pipefail
-
-merge_commit_sha=$(jq -r '.pull_request.merge_commit_sha' "$GITHUB_EVENT_PATH")
-pull_request_id=$(jq -r '.pull_request.number' "$GITHUB_EVENT_PATH")
-pr_shortcode="elastic/elasticsearch-js#$pull_request_id"
-
-# generate patch file
-cd "$GITHUB_WORKSPACE/stack"
-git format-patch -1 --stdout "$merge_commit_sha" > /tmp/patch.diff
-
-# set committer info
-git config --global user.email "elasticmachine@users.noreply.github.com"
-git config --global user.name "Elastic Machine"
-
-# apply patch file
-cd "$GITHUB_WORKSPACE/serverless"
-git am -C1 --reject /tmp/patch.diff || git am --quit
-
-# generate PR body comment
-comment="Patch applied from $pr_shortcode"
-
-# enumerate rejected patches in PR comment
-has_rejects='false'
-for f in ./**/*.rej; do
-  has_rejects='true'
-  comment="$comment
-
-## Rejected patch \`$f\` must be resolved:
-
-\`\`\`diff
-$(cat "$f")
-\`\`\`
-"
-done
-
-# delete .rej files
-rm -fv ./**/*.rej
-
-# send data to output parameters
-echo "$comment" > /tmp/pr_body
-echo "PR_DRAFT=$has_rejects" >> "$GITHUB_OUTPUT"
--- a/.github/workflows/serverless-patch.yml
+++ b/.github/workflows/serverless-patch.yml
@ -1,51 +0,0 @@
---
-name: Apply PR changes to serverless
-on:
-  pull_request_target:
-    types:
-      - closed
-      - labeled
-
-jobs:
-  apply-patch:
-    name: Apply patch
-    runs-on: ubuntu-latest
-    # Only react to merged PRs for security reasons.
-    # See https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#pull_request_target.
-    if: >
-      github.event.pull_request.merged
-      && (
-        (
-          github.event.action == 'closed'
-          && contains(github.event.pull_request.labels.*.name, 'apply-to-serverless')
-        )
-        ||
-        (
-          github.event.action == 'labeled'
-          && github.event.label.name == 'apply-to-serverless'
-        )
-      )
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          repository: elastic/elasticsearch-js
-          ref: main
-          path: stack
-          fetch-depth: 0
-      - uses: actions/checkout@v4
-        with:
-          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
-        with:
-          token: ${{ secrets.GH_TOKEN }}
-          path: serverless
-          title: 'Apply patch from elastic/elasticsearch-js#${{ github.event.pull_request.number }}'
-          commit-message: 'Apply patch from elastic/elasticsearch-js#${{ github.event.pull_request.number }}'
-          body-path: /tmp/pr_body
-          draft: '${{ steps.apply-patch.outputs.PR_DRAFT }}'
-          add-paths: ':!*.rej'
--- a/.github/workflows/stale.yml
+++ b/.github/workflows/stale.yml
@ -1,21 +0,0 @@
---
-name: 'Close stale issues and PRs'
-on:
-  schedule:
-    - cron: '30 1 * * *'
-
-jobs:
-  stale:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/stale@v8
-        with:
-          stale-issue-label: stale
-          stale-pr-label: stale
-          days-before-stale: 90
-          days-before-close: 14
-          exempt-issue-labels: 'good first issue'
-          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.'
--- a/.gitignore
+++ b/.gitignore
@ -63,8 +63,3 @@ test/bundlers/**/bundle.js
 test/bundlers/parcel-test/.parcel-cache

 lib
-junit-output
-bun.lockb
-test-results
-processinfo
-.tap
--- a/.npmignore
+++ b/.npmignore
@ -64,6 +64,7 @@ test
 scripts

 # ci configuration
+.ci
 .travis.yml
 .buildkite
 certs
@ -72,5 +73,3 @@ CODE_OF_CONDUCT.md
 CONTRIBUTING.md

 src
-bun.lockb
-.tap
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@ -8,7 +8,7 @@ improving the documentation,
 submitting bug reports and feature requests or writing code.

 ## Repository structure
-The `main` branch is considered unstable, and it's compatible with Elasticsearch main. Unless you are patching an issue, new features should always be sent to the `main` branch, in case of a bugfix, it depends if the bug affects all the release lines.<br/>
+The `master` branch is considered unstable, and it's compatible with Elasticsearch master. Unless you are patching an issue, new features should always be sent to the `master` branch, in case of a bugfix, it depends if the bug affects all the release lines.<br/>
 There is a branch for every supported release line, such as `7.x` or `6.x`. We release bugfixes as soon as possible, while minor and major releases are published at the same time of the Elastic Stack.

 Usually for every release line there will be a *published* version and a *next* version. Eg: the `7.x` branch contains the version published on npm, and bugfixes should be sent there, while `7.2` *(assuming that 7.1.x is released)* contains the next version, and new features should be sent there.
@ -31,7 +31,7 @@ Once your changes are ready to submit for review:
 1. Test your changes

    Run the test suite to make sure that nothing is broken.
-    Usually running `npm test` is enough; our CI will take care of running the integration tests. If you want to run the integration tests yourself, see [the *Testing* section](#testing) below.
+    Usually run `npm test` is enough, our CI will take care of running the integration test. If you want to run the integration test yourself, see the *Testing* section below.

 2. Submit a pull request

@ -58,50 +58,36 @@ Once your changes are ready to submit for review:

 ### Code generation

-The entire content of the `src/api/` directory is automatically generated from [the Elasticsearch specification](https://github.com/elastic/elasticsearch-specification), as is the `docs/reference.asciidoc` file.
-This code generation is done using a separate repository that is not currently available to the public.
-
-If you find discrepancies between this client's API code and what you see when actually interacting with an Elasticsearch API, you can open a pull request here to fix it.
-For API fixes, it's likely a change will need to be made to the specification as well, to ensure your fix is not undone by the code generation process.
-We will do our best to make sure this is addressed when reviewing and merging your changes.
-
-PRs to improve the specification are also welcome!
-It is implemented in TypeScript, so JavaScript devs should be able to understand it fairly easily.
-Spec fixes are particularly helpful, as they will be reflected in ALL official Elasticsearch clients, not just this one.
+The entire content of the API folder is generated as well as the `docs/reference.asciidoc` file.<br/>
+If you want to run the code generation you should run the following command:
+```sh
+node scripts/generate --tag <tag name>
+# or
+node scripts/generate --branch <branch name>
+```
+Then you should copy the content of `api/generated.d.ts` into the `index.d.ts` file *(automate this step would be a nice pr!)*.

 ### Testing
-
-There are a few different test scripts.
-Usually during development you only need to run `npm test`, but if you want you can run just a part of the suite:
+There are different test scripts, usually during development you only need to run `npm test`, but if you want you can run just a part of the suite, following you will find all the testing scripts and what they do.

 | Script | Description |
 |---|---|
 | `npm run test:unit` | Runs the content of the `test/unit` folder. |
-| `npm run test:coverage-100` | Runs unit tests enforcing 100% coverage. |
-| `npm run test:coverage-report` | Runs unit tests and generates an `lcov` coverage report. |
-| `npm run test:coverage-ui` | Runs unit tests and generates an HTML coverage report. |
-| `npm run test:integration` | Runs the integration test runner.<br/>**Note: requires a living instance of Elasticsearch.** |
-| `npm run lint` | Run the [linter](https://github.com/standard/ts-standard). |
-| `npm run lint:fix` | Fixes linter errors. |
-| `npm run license-checker` | Checks that all dependencies have acceptable open source licenses. |
-
-| `npm test` | Runs `lint` and `test:unit`. |
+| `npm run test:behavior` | Runs the content of the `test/behavior` folder. |
+| `npm run test:types` | Runs the content of the `test/types` folder. |
+| `npm run test:unit -- --cov --coverage-report=html` | Runs the content of the `test/unit` folder and calculates the code coverage. |
+| `npm run test:integration` | Runs the integration test runner.<br/>*Note: it requires a living instance of Elasticsearch.* |
+| `npm run lint` | Run the [linter](https://standardjs.com/). |
+| `npm run lint:fix` | Fixes the lint errors. |
+| `npm test` | Runs lint, unit, behavior, and types test. |

 #### Integration test
+The integration test are generated on the fly by the runner you will find inside `test/integration`, once you execute it, it will clone the Elasticsearch repository and checkout the correct version to grab the [OSS yaml files](https://github.com/elastic/elasticsearch/tree/master/rest-api-spec/src/main/resources/rest-api-spec/test) and the [Elastic licensed yaml files](https://github.com/elastic/elasticsearch/tree/master/x-pack/plugin/src/test/resources/rest-api-spec/test) that will be used for generating the test.

-The integration tests are generated on the fly by the runner you will find inside `test/integration`.
-Once you execute it, it will fetch the [YAML REST test files](https://github.com/elastic/elasticsearch/tree/main/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test) from our artifacts API.
-These are used to generate the integration tests.
-
-Usually this step is executed by CI since it takes some time, but you can easily run this yourself!
-Just follow this steps:
-1. Boot a fresh Elasticsearch instance, which can be done in a Docker container by running `STACK_VERSION=8.10.0 DETACH=true .buildkite/run-elasticsearch.sh`, where `STACK_VERSION` and `DETACH` environment variables can be adjusted to your needs. A `TEST_SUITE` env var can also be set to `free` or `platinum`, and defaults to `free`.
-1. Run `npm run test:integration` to run the whole suite, or `npm run test:integration -- --bail` to stop after the first failure.
-1. Grab a coffee, it will take some time. ;)
-
-This suite is very large, and not all tests will pass.
-This is fine.
-This suite is mostly used to identify notable changes in success/fail rate over time as we make changes to the client.
+Usually this step is executed by CI since it takes some time, but you can easily run this yourself! Just follow this steps:
+1. Boot an Elasticsearch instance, you can do that by running `./scripts/es-docker.sh` or `./scripts/es-docker-platinum.sh`, the first one will work only with the OSS APIs, while the second will work also with the Elastic licensed APIs;
+1. If you are running the OSS test, you should use `npm run test:integration`, otherwise use `TEST_ES_SERVER=https://elastic:changeme@localhost:9200 npm run test:integration`. You can also pass a `-b` parameter if you want the test to bail out at the first failure: `npm run test:integration -- -b`;
+1. Grab a coffee, it will take some time ;)

 ### Releasing

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

 [![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat)](http://standardjs.com/)  [![Build Status](https://badge.buildkite.com/15e4246eb268ea78f6e10aa90bce38c1abb0a4489e79f5a0ac.svg)](https://buildkite.com/elastic/elasticsearch-javascript-client-integration-tests/builds?branch=main)  [![Node CI](https://github.com/elastic/elasticsearch-js/actions/workflows/nodejs.yml/badge.svg)](https://github.com/elastic/elasticsearch-js/actions/workflows/nodejs.yml)  [![codecov](https://codecov.io/gh/elastic/elasticsearch-js/branch/master/graph/badge.svg)](https://codecov.io/gh/elastic/elasticsearch-js)  [![NPM downloads](https://img.shields.io/npm/dm/@elastic/elasticsearch.svg?style=flat)](https://www.npmjs.com/package/@elastic/elasticsearch)

-**[Download the latest version of Elasticsearch](https://www.elastic.co/downloads/elasticsearch)**
-or
-**[sign-up](https://cloud.elastic.co/registration?elektra=en-ess-sign-up-page)**
-**for a free trial of Elastic Cloud**.
-
 The official Node.js client for Elasticsearch.

 ## Installation
@ -21,25 +16,6 @@ of the getting started documentation.
 Refer to the [Connecting section](https://www.elastic.co/guide/en/elasticsearch/client/javascript-api/current/getting-started-js.html#_connecting)
 of the getting started documentation.

-## Compatibility
-
-The Elasticsearch client is compatible with currently maintained JS versions.
-
-Language clients are forward compatible; meaning that clients support
-communicating with greater or equal minor versions of Elasticsearch without
-breaking. It does not mean that the client automatically supports new features
-of newer Elasticsearch versions; it is only possible after a release of a new
-client version. For example, a 8.12 client version won't automatically support
-the new features of the 8.13 version of Elasticsearch, the 8.13 client version
-is required for that. Elasticsearch language clients are only backwards
-compatible with default distributions and without guarantees made.
-
-| Elasticsearch Version | Elasticsearch-JS Branch  | Supported |
-| --------------------- | ------------------------ | --------- |
-| main                  | main                     |           |
-| 8.x                   | 8.x                      | 8.x       |
-| 7.x                   | 7.x                      | 7.17      |
-
 ## Usage

 * [Creating an index](https://www.elastic.co/guide/en/elasticsearch/client/javascript-api/current/getting-started-js.html#_creating_an_index)
@ -52,7 +28,7 @@ compatible with default distributions and without guarantees made.

 ### Node.js support

-NOTE: The minimum supported version of Node.js is `v18`.
+NOTE: The minimum supported version of Node.js is `v14`.

 The client versioning follows the Elastic Stack versioning, this means that
 major, minor, and patch releases are done following a precise schedule that
@ -77,7 +53,6 @@ of `^7.10.0`).
 | `10.x`          | `April 2021`     | `7.12` (mid 2021)      |
 | `12.x`          | `April 2022`     | `8.2` (early 2022)     |
 | `14.x`          | `April 2023`     | `8.8` (early 2023)     |
-| `16.x`          | `September 2023` | `8.11` (late 2023)     |

 ### Compatibility

@ -98,8 +73,7 @@ npm install @elastic/elasticsearch@<major>

 #### Browser

-> [!WARNING]
-> There is no official support for the browser environment. It exposes your Elasticsearch instance to everyone, which could lead to security issues.
+WARNING: There is no official support for the browser environment. It exposes your Elasticsearch instance to everyone, which could lead to security issues.
 We recommend that you write a lightweight proxy that uses this client instead, you can see a proxy example [here](./docs/examples/proxy).

 ## Documentation
--- a/catalog-info.yaml
+++ b/catalog-info.yaml
@ -6,7 +6,7 @@ metadata:
  name: elasticsearch-js
 spec:
  type: library
-  owner: group:devtools-team
+  owner: group:clients-team
  lifecycle: production

 ---
@ -18,7 +18,7 @@ metadata:
  description: elasticsearch-js - integration tests
 spec:
  type: buildkite-pipeline
-  owner: group:devtools-team
+  owner: group:clients-team
  system: buildkite
  implementation:
    apiVersion: buildkite.elastic.dev/v1
@ -29,19 +29,21 @@ spec:
      repository: elastic/elasticsearch-js
      pipeline_file: .buildkite/pipeline.yml
      teams:
-        devtools-team:
+        clients-team:
          access_level: MANAGE_BUILD_AND_READ
        everyone:
          access_level: READ_ONLY
      provider_settings:
        build_pull_requests: false
-        build_branches: false
      cancel_intermediate_builds: true
-      cancel_intermediate_builds_branch_filter: "!main"
+      cancel_intermediate_builds_branch_filter: '!main'
      schedules:
-        main:
-          branch: "main"
-          cronline: "@daily"
-        8_14:
-          branch: "8.14"
-          cronline: "@daily"
+        main_semi_daily:
+          branch: 'main'
+          cronline: '0 */12 * * *'
+        8_8_semi_daily:
+          branch: '8.8'
+          cronline: '0 */12 * * *'
+        8_7_daily:
+          branch: '8.7'
+          cronline: '@daily'
--- a/docs/advanced-config.asciidoc
+++ b/docs/advanced-config.asciidoc
@ -91,95 +91,6 @@ const client = new Client({
 })
 ----

-[discrete]
-[[redaction]]
-==== Redaction of potentially sensitive data
-
-When the client raises an `Error` that originated at the HTTP layer, like a `ConnectionError` or `TimeoutError`, a `meta` object is often attached to the error object that includes metadata useful for debugging, like request and response information. Because this can include potentially sensitive data, like authentication secrets in an `Authorization` header, the client takes measures to redact common sources of sensitive data when this metadata is attached and serialized.
-
-If your configuration requires extra headers or other configurations that may include sensitive data, you may want to adjust these settings to account for that.
-
-By default, the `redaction` option is set to `{ type: 'replace' }`, which recursively searches for sensitive key names, case insensitive, and replaces their values with the string `[redacted]`.
-
-[source,js]
----
-const { Client } = require('@elastic/elasticsearch')
-
-const client = new Client({
-  cloud: { id: '<cloud-id>' },
-  auth: { apiKey: 'base64EncodedKey' },
-})
-
-try {
-  await client.indices.create({ index: 'my_index' })
-} catch (err) {
-  console.log(err.meta.meta.request.options.headers.authorization) // prints "[redacted]"
-}
----
-
-If you would like to redact additional properties, you can include additional key names to search and replace:
-
-[source,js]
----
-const { Client } = require('@elastic/elasticsearch')
-
-const client = new Client({
-  cloud: { id: '<cloud-id>' },
-  auth: { apiKey: 'base64EncodedKey' },
-  headers: { 'X-My-Secret-Password': 'shhh it's a secret!' },
-  redaction: {
-    type: "replace",
-    additionalKeys: ["x-my-secret-password"]
-  }
-})
-
-try {
-  await client.indices.create({ index: 'my_index' })
-} catch (err) {
-  console.log(err.meta.meta.request.options.headers['X-My-Secret-Password']) // prints "[redacted]"
-}
----
-
-Alternatively, if you know you're not going to use the metadata at all, setting the redaction type to `remove` will remove all optional sources of potentially sensitive data entirely, or replacing them with `null` for required properties.
-
-[source,js]
----
-const { Client } = require('@elastic/elasticsearch')
-
-const client = new Client({
-  cloud: { id: '<cloud-id>' },
-  auth: { apiKey: 'base64EncodedKey' },
-  redaction: { type: "remove" }
-})
-
-try {
-  await client.indices.create({ index: 'my_index' })
-} catch (err) {
-  console.log(err.meta.meta.request.options.headers) // undefined
-}
----
-
-Finally, if you prefer to turn off redaction altogether, perhaps while debugging on a local developer environment, you can set the redaction type to `off`. This will revert the client to pre-8.11.0 behavior, where basic redaction is only performed during common serialization methods like `console.log` and `JSON.stringify`.
-
-WARNING: Setting `redaction.type` to `off` is not recommended in production environments.
-
-[source,js]
----
-const { Client } = require('@elastic/elasticsearch')
-
-const client = new Client({
-  cloud: { id: '<cloud-id>' },
-  auth: { apiKey: 'base64EncodedKey' },
-  redaction: { type: "off" }
-})
-
-try {
-  await client.indices.create({ index: 'my_index' })
-} catch (err) {
-  console.log(err.meta.meta.request.options.headers.authorization) // the actual header value will be logged
-}
----
-
 [discrete]
 ==== Migrate to v8

--- a/docs/basic-config.asciidoc
+++ b/docs/basic-config.asciidoc
@ -260,11 +260,11 @@ _Default:_ `false`
 _Default:_ `null`

 |`maxResponseSize`
-|`number` - When configured, it verifies that the uncompressed response size is lower than the configured number, if it's higher it will abort the request. It cannot be higher than buffer.constants.MAX_STRING_LENGTH +
+|`number` - When configured, it verifies that the uncompressed response size is lower than the configured number, if it's higher it will abort the request. It cannot be higher than buffer.constants.MAX_STRING_LENTGH +
 _Default:_ `null`

 |`maxCompressedResponseSize`
-|`number` - When configured, it verifies that the compressed response size is lower than the configured number, if it's higher it will abort the request. It cannot be higher than buffer.constants.MAX_LENGTH +
+|`number` - When configured, it verifies that the compressed response size is lower than the configured number, if it's higher it will abort the request. It cannot be higher than buffer.constants.MAX_LENTGH +
 _Default:_ `null`

 |===
--- a/docs/changelog.asciidoc
+++ b/docs/changelog.asciidoc
@ -1,234 +1,6 @@
 [[changelog-client]]
 == Release notes

-[discrete]
-=== 8.15.3
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Improved support for Elasticsearch `v8.15`
-
-Updated TypeScript types based on fixes and improvements to the Elasticsearch specification.
-
-[discrete]
-===== Drop testing artifacts from npm package
-
-Tap, the unit testing tool, was recently upgraded and started writing to a `.tap` directory. Since tests are run prior to an `npm publish` in CI, this directory was being included in the published package and bloating its size.
-
-[discrete]
-=== 8.15.2
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Improved support for Elasticsearch `v8.15`
-
-Updated TypeScript types based on fixes and improvements to the Elasticsearch specification.
-
-[discrete]
-=== 8.15.1
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Improved support for Elasticsearch `v8.15`
-
-Updated TypeScript types based on fixes and improvements to the Elasticsearch specification.
-
-[discrete]
-=== 8.15.0
-
-[discrete]
-==== Features
-
-[discrete]
-===== Support for Elasticsearch `v8.15.0`
-
-You can find all the API changes
-https://www.elastic.co/guide/en/elasticsearch/reference/8.15/release-notes-8.15.0.html[here].
-
-[discrete]
-===== OpenTelemetry zero-code instrumentation support
-
-For those that use an observability service that supports OpenTelemetry spans, the client will now automatically generate traces for each Elasticsearch request it makes.
-See {jsclient}/observability.html#_opentelemetry[the docs]
-for more information.
-
-[discrete]
-=== 8.14.1
-
-[discrete]
-==== Features
-
-[discrete]
-===== Improved support for Elasticsearch `8.14`
-
-Updated types based on fixes and changes to the Elasticsearch specification.
-
-[discrete]
-=== 8.14.0
-
-[discrete]
-==== Features
-
-[discrete]
-===== Support for Elasticsearch `v8.14.0`
-
-You can find all the API changes
-https://www.elastic.co/guide/en/elasticsearch/reference/8.14/release-notes-8.14.0.html[here].
-
-[discrete]
-===== ES|QL object API helper
-
-A helper method has been added that parses the response of an ES|QL query and converts it into an array of objects.
-A TypeScript type parameter can also be provided to improve developer experience when working with the result. https://github.com/elastic/elasticsearch-js/pull/2238[#2238]
-
-[discrete]
-===== `onSuccess` callback added to bulk helper
-
-The bulk helper now supports an `onSuccess` callback that will be called for each successful operation. https://github.com/elastic/elasticsearch-js/pull/2199[#2199]
-
-[discrete]
-===== Request retries are more polite
-
-https://github.com/elastic/elastic-transport-js/releases/tag/v8.6.0[`@elastic/transport` v8.6.0] was released, which refactored when and how failed requests are retried. Timed-out requests are no longer retried by default, and retries now use exponential backoff rather than running immediately.
-
-
-[discrete]
-=== 8.13.1
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Pin @elastic/transport to `~8.4.1`
-
-Switching from `^8.4.1` to `~8.4.1` ensures 8.13 client users are not required to update to Node.js v18+, which is a new requirement set by `@elastic/transport` v8.5.0. See https://github.com/elastic/elastic-transport-js/issues/91[elastic/elastic-transport-js#91] for details.
-
-v8.13.0 was also released depending on v8.4.0 of `@elastic/transport` instead of v8.4.1, which was unintentional.
-
-[discrete]
-=== 8.13.0
-
-[discrete]
-==== Features
-
-[discrete]
-===== Support for Elasticsearch `v8.13.0`
-
-You can find all the API changes
-https://www.elastic.co/guide/en/elasticsearch/reference/8.13/release-notes-8.13.0.html[here].
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Ensure new connections inherit client's set defaults https://github.com/elastic/elasticsearch-js/pull/2159[#2159]
-
-When instantiating a client, any connection-related defaults (e.g. `requestTimeout`) set on that client instance would not be inherited by nodes if they were entered as strings rather than a `ConnectionOptions` object.
-
-[discrete]
-=== 8.12.3
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Bump @elastic/transport to `~8.4.1`
-
-Switching from `^8.4.1` to `~8.4.1` ensures 8.12 client users are not required to update to Node.js v18+, which is a new requirement set by `@elastic/transport` v8.5.0. See https://github.com/elastic/elastic-transport-js/issues/91[elastic/elastic-transport-js#91] for details.
-
-[discrete]
-=== 8.12.2
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Upgrade transport to 8.4.1 https://github.com/elastic/elasticsearch-js/pull/2137[#2137]
-
-Upgrades `@elastic/transport` to 8.4.1 to resolve https://github.com/elastic/elastic-transport-js/pull/83[a bug] where arrays in error diagnostics were unintentionally transformed into objects.
-
-[discrete]
-=== 8.12.1
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Fix hang in bulk helper semaphore https://github.com/elastic/elasticsearch-js/pull/2027[#2027]
-
-The failing state could be reached when a server's response times are slower than flushInterval.
-
-[discrete]
-=== 8.12.0
-
-[discrete]
-=== Features
-
-[discrete]
-===== Support for Elasticsearch `v8.12.0`
-
-You can find all the API changes
-https://www.elastic.co/guide/en/elasticsearch/reference/8.12/release-notes-8.12.0.html[here].
-
-[discrete]
-=== 8.11.1
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Bump @elastic/transport to `~8.4.0`
-
-Switching from `^8.4.0` to `~8.4.0` ensures 8.11 client users are not required to update to Node.js v18+, which is a new requirement set by `@elastic/transport` v8.5.0. See https://github.com/elastic/elastic-transport-js/issues/91[elastic/elastic-transport-js#91] for details.
-
-[discrete]
-=== 8.11.0
-
-[discrete]
-==== Features
-
-[discrete]
-===== Support for Elasticsearch `v8.11.0`
-
-You can find all the API changes
-https://www.elastic.co/guide/en/elasticsearch/reference/8.11/release-notes-8.11.0.html[here].
-
-[discrete]
-===== Enhanced support for redacting potentially sensitive data https://github.com/elastic/elasticsearch-js/pull/2095[#2095]
-
-`@elastic/transport` https://github.com/elastic/elastic-transport-js/releases/tag/v8.4.0[version 8.4.0] introduces enhanced measures for ensuring that request metadata attached to some `Error` objects is redacted. This functionality is primarily to address custom logging solutions that don't use common serialization methods like `JSON.stringify`, `console.log`, or `util.inspect`, which were already accounted for.
-
-See <<redaction>> for more information.
-
-[discrete]
-=== 8.10.1
-
-[discrete]
-==== Fixes
-
-[discrete]
-===== Bump @elastic/transport to `~8.3.4`
-
-Switching from `^8.3.4` to `~8.3.4` ensures 8.10 client users are not required to update to Node.js v18+, which is a new requirement set by `@elastic/transport` v8.5.0. See https://github.com/elastic/elastic-transport-js/issues/91[elastic/elastic-transport-js#91] for details.
-
-[discrete]
-=== 8.10.0
-
-[discrete]
-==== Features
-
-[discrete]
-===== Support for Elasticsearch `v8.10.0`
-
-You can find all the API changes
-https://www.elastic.co/guide/en/elasticsearch/reference/8.10/release-notes-8.10.0.html[here].
-
 [discrete]
 === 8.9.2

@ -266,7 +38,7 @@ https://www.elastic.co/guide/en/elasticsearch/reference/8.9/release-notes-8.9.0.
 [discrete]
 ===== Allow document to be overwritten in `onDocument` iteratee of bulk helper https://github.com/elastic/elasticsearch-js/pull/1732[#1732]

-In the {jsclient}/client-helpers.html#bulk-helper[bulk helper], documents could not be modified before being sent to Elasticsearch. It is now possible to {jsclient}/client-helpers.html#_modifying_a_document_before_operation[modify a document] before sending it.
+In the https://www.elastic.co/guide/en/elasticsearch/client/javascript-api/current/client-helpers.html#bulk-helper[bulk helper], documents could not be modified before being sent to Elasticsearch. It is now possible to https://www.elastic.co/guide/en/elasticsearch/client/javascript-api/current/client-helpers.html#_modifying_a_document_before_operation[modify a document] before sending it.

 [discrete]
 ==== Fixes
@ -547,7 +319,7 @@ client.search({ params }, { options }, (err, result) => {
 client.search({ params }, { options })
  .then(console.log)
  .catch(console.log)
-
+  
 // async-style (sugar syntax on top of promises)
 const response = await client.search({ params }, { options })
 console.log(response)
@ -602,9 +374,6 @@ The client API leaks HTTP-related notions in many places, and removing them woul

 This could be a rather big breaking change, so a double solution could be used during the 8.x lifecycle. (accepting body keys without them being wrapped in the body as well as the current solution).

-To convert code from 7.x, you need to remove the `body` parameter in all the endpoints request.
-For instance, this is an example for the `search` endpoint:
-
 [source,js]
 ----
 // from
@ -643,12 +412,6 @@ If you weren't extending the internals of the client, this won't be a breaking c
 The client API leaks HTTP-related notions in many places, and removing them would definitely improve the DX.
 The client will expose a new request-specific option to still get the full response details.

-The new behaviour returns the `body` value directly as response.
-If you want to have the 7.x response format, you need to add `meta : true` in the request.
-This will return all the HTTP meta information, including the `body`.
-
-For instance, this is an example for the `search` endpoint:
-
 [source,js]
 ----
 // from
@ -707,7 +470,7 @@ If you weren't extending the internals of the client, this won't be a breaking c

 *Breaking: Yes* | *Migration effort: Medium*

-Currently, every path or query parameter could be expressed in both `snake_case` and `camelCase`. Internally the client will convert everything to `snake_case`.
+Currently, every path or query parameter could be expressed in both `snake_case` and `camelCase`. Internally the client will convert everything to `snake_case`. 
 This was done in an effort to reduce the friction of migrating from the legacy to the new client, but now it no longer makes sense.
 If you are already using `snake_case` keys, this won't be a breaking change for you.

--- a/docs/configuration.asciidoc
+++ b/docs/configuration.asciidoc
@ -2,11 +2,10 @@
 == Configuration


-The client is designed to be easily configured for your needs. In the following
+The client is designed to be easily configured for your needs. In the following 
 section, you can see the possible options that you can use to configure it.

 * <<basic-config>>
 * <<advanced-config>>
-* <<timeout-best-practices>>
 * <<child>>
 * <<client-testing>>
--- a/docs/connecting.asciidoc
+++ b/docs/connecting.asciidoc
@ -11,8 +11,6 @@ This page contains the information you need to connect and use the Client with
 * <<client-faas-env, Using the Client in a Function-as-a-Service Environment>>
 * <<client-connect-proxy, Connecting through a proxy>>
 * <<client-error-handling, Handling errors>>
-* <<keep-alive, Keep-alive connections>>
-* <<close-connections, Closing a client's connections>>
 * <<product-check, Automatic product check>>

 [[authentication]]
@ -661,51 +659,6 @@ a|* `name` - `string`
 * `headers` - `object`, the response status code
 |===

-[[keep-alive]]
-[discrete]
-=== Keep-alive connections
-
-By default, the client uses persistent, keep-alive connections to reduce the overhead of creating a new HTTP connection for each Elasticsearch request.
-If you are using the default `UndiciConnection` connection class, it maintains a pool of 256 connections with a keep-alive of 10 minutes.
-If you are using the legacy `HttpConnection` connection class, it maintains a pool of 256 connections with a keep-alive of 1 minute.
-
-If you need to disable keep-alive connections, you can override the HTTP agent with your preferred https://nodejs.org/api/http.html#http_new_agent_options[HTTP agent options]:
-
-[source,js]
----
-const client = new Client({
-  node: 'http://localhost:9200',
-  // the function takes as parameter the option
-  // object passed to the Connection constructor
-  agent: (opts) => new CustomAgent()
-})
----
-
-Or you can disable the HTTP agent entirely:
-
-[source,js]
----
-const client = new Client({
-  node: 'http://localhost:9200',
-  // Disable agent and keep-alive
-  agent: false
-})
----
-
-[discrete]
-[[close-connections]]
-=== Closing a client's connections
-
-If you would like to close all open connections being managed by an instance of the client, use the `close()` function:
-
-[source,js]
----
-const client = new Client({
-  node: 'http://localhost:9200'
-});
-client.close();
----
-
 [discrete]
 [[product-check]]
 === Automatic product check
--- a/docs/doc_examples/00272f75a6afea91f8554ef7cda0c1f2.asciidoc
+++ b/docs/doc_examples/00272f75a6afea91f8554ef7cda0c1f2.asciidoc
@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.security.clearCachedRealms({
-  realms: "default_file,ldap1",
-});
-console.log(response);
----
--- a/docs/doc_examples/004743b9c9f61588926ccf734696b713.asciidoc
+++ b/docs/doc_examples/004743b9c9f61588926ccf734696b713.asciidoc
@ -1,11 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.forcemerge({
-  index: ".ds-my-data-stream-2099.03.07-000001",
-  max_num_segments: 1,
-});
-console.log(response);
----
--- a/docs/doc_examples/006e0e16c9f1da58c0bfe57377f7fc38.asciidoc
+++ b/docs/doc_examples/006e0e16c9f1da58c0bfe57377f7fc38.asciidoc
@ -1,20 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.create({
-  index: "my-index-000001",
-  settings: {
-    analysis: {
-      analyzer: {
-        my_analyzer: {
-          tokenizer: "whitespace",
-          filter: ["stemmer"],
-        },
-      },
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/007179b5e241da650562a5f0a5007823.asciidoc
+++ b/docs/doc_examples/007179b5e241da650562a5f0a5007823.asciidoc
@ -1,40 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.watcher.putWatch({
-  id: "cluster_health_watch",
-  trigger: {
-    schedule: {
-      interval: "10s",
-    },
-  },
-  input: {
-    http: {
-      request: {
-        host: "localhost",
-        port: 9200,
-        path: "/_cluster/health",
-      },
-    },
-  },
-  condition: {
-    compare: {
-      "ctx.payload.status": {
-        eq: "red",
-      },
-    },
-  },
-  actions: {
-    send_email: {
-      email: {
-        to: "username@example.org",
-        subject: "Cluster Status Warning",
-        body: "Cluster status is RED",
-      },
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/008ed823c89e703c447ac89c6b689833.asciidoc
+++ b/docs/doc_examples/008ed823c89e703c447ac89c6b689833.asciidoc
@ -1,8 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.migration.postFeatureUpgrade();
-console.log(response);
----
--- a/docs/doc_examples/0091fc75271b1fbbd4269622a4881e8b.asciidoc
+++ b/docs/doc_examples/0091fc75271b1fbbd4269622a4881e8b.asciidoc
@ -1,16 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.search({
-  index: "my-index",
-  query: {
-    match: {
-      "http.clientip": "40.135.0.0",
-    },
-  },
-  fields: ["http.clientip"],
-});
-console.log(response);
----
--- a/docs/doc_examples/00b3b6d76a368ae71277ea24af318693.asciidoc
+++ b/docs/doc_examples/00b3b6d76a368ae71277ea24af318693.asciidoc
@ -1,8 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.shardStores();
-console.log(response);
----
--- a/docs/doc_examples/00c05aa931fc985985e3e21c93cf43ff.asciidoc
+++ b/docs/doc_examples/00c05aa931fc985985e3e21c93cf43ff.asciidoc
@ -1,15 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.renderSearchTemplate({
-  source: '{ "query": {{#toJson}}my_query{{/toJson}} }',
-  params: {
-    my_query: {
-      match_all: {},
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/00d65f7b9daa1c6b18eedd8ace206bae.asciidoc
+++ b/docs/doc_examples/00d65f7b9daa1c6b18eedd8ace206bae.asciidoc
@ -1,12 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.analyze({
-  tokenizer: "standard",
-  filter: ["asciifolding"],
-  text: "açaí à la carte",
-});
-console.log(response);
----
--- a/docs/doc_examples/00e0c964c79fcc1876ab957da2ffce82.asciidoc
+++ b/docs/doc_examples/00e0c964c79fcc1876ab957da2ffce82.asciidoc
@ -1,67 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.create({
-  index: "italian_example",
-  settings: {
-    analysis: {
-      filter: {
-        italian_elision: {
-          type: "elision",
-          articles: [
-            "c",
-            "l",
-            "all",
-            "dall",
-            "dell",
-            "nell",
-            "sull",
-            "coll",
-            "pell",
-            "gl",
-            "agl",
-            "dagl",
-            "degl",
-            "negl",
-            "sugl",
-            "un",
-            "m",
-            "t",
-            "s",
-            "v",
-            "d",
-          ],
-          articles_case: true,
-        },
-        italian_stop: {
-          type: "stop",
-          stopwords: "_italian_",
-        },
-        italian_keywords: {
-          type: "keyword_marker",
-          keywords: ["esempio"],
-        },
-        italian_stemmer: {
-          type: "stemmer",
-          language: "light_italian",
-        },
-      },
-      analyzer: {
-        rebuilt_italian: {
-          tokenizer: "standard",
-          filter: [
-            "italian_elision",
-            "lowercase",
-            "italian_stop",
-            "italian_keywords",
-            "italian_stemmer",
-          ],
-        },
-      },
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/00fea15cbca83be9d5f1a024ff2ec708.asciidoc
+++ b/docs/doc_examples/00fea15cbca83be9d5f1a024ff2ec708.asciidoc
@ -1,19 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.inference.put({
-  task_type: "text_embedding",
-  inference_id: "my-e5-model",
-  inference_config: {
-    service: "elasticsearch",
-    service_settings: {
-      num_allocations: 1,
-      num_threads: 1,
-      model_id: ".multilingual-e5-small",
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/010d5e901a2690fa7b2396edbe6cd463.asciidoc
+++ b/docs/doc_examples/010d5e901a2690fa7b2396edbe6cd463.asciidoc
@ -1,13 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.putIndexTemplate({
-  name: "my-data-stream-template",
-  index_patterns: ["my-data-stream*"],
-  data_stream: {},
-  priority: 500,
-});
-console.log(response);
----
--- a/docs/doc_examples/014b788c879e4aaa1020672e45e25473.asciidoc
+++ b/docs/doc_examples/014b788c879e4aaa1020672e45e25473.asciidoc
@ -4,9 +4,12 @@
 [source, js]
 ----
 const response = await client.cluster.putSettings({
-  persistent: {
-    "xpack.security.transport.filter.enabled": false,
-  },
-});
-console.log(response);
+  body: {
+    transient: {
+      'cluster.routing.use_adaptive_replica_selection': false
+    }
+  }
+})
+console.log(response)
 ----
+
--- a/docs/doc_examples/015294a400986295039e52ebc62033be.asciidoc
+++ b/docs/doc_examples/015294a400986295039e52ebc62033be.asciidoc
@ -4,12 +4,15 @@
 [source, js]
 ----
 const response = await client.update({
-  index: "test",
-  id: 1,
-  doc: {
-    name: "new_name",
-  },
-  doc_as_upsert: true,
-});
-console.log(response);
+  index: 'test',
+  id: '1',
+  body: {
+    doc: {
+      name: 'new_name'
+    },
+    detect_noop: false
+  }
+})
+console.log(response)
 ----
+
--- a/docs/doc_examples/015e6e6132b6d6d44bddb06bc3b316ed.asciidoc
+++ b/docs/doc_examples/015e6e6132b6d6d44bddb06bc3b316ed.asciidoc
@ -1,46 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.search({
-  index: "retrievers_example",
-  retriever: {
-    rrf: {
-      retrievers: [
-        {
-          standard: {
-            query: {
-              range: {
-                year: {
-                  gt: 2023,
-                },
-              },
-            },
-          },
-        },
-        {
-          standard: {
-            query: {
-              term: {
-                topic: "elastic",
-              },
-            },
-          },
-        },
-      ],
-      rank_window_size: 10,
-      rank_constant: 1,
-    },
-  },
-  _source: false,
-  aggs: {
-    topics: {
-      terms: {
-        field: "topic",
-      },
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/0163af36c8472ac0c5160c8b716f5b26.asciidoc
+++ b/docs/doc_examples/0163af36c8472ac0c5160c8b716f5b26.asciidoc
@ -1,24 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.search({
-  index: "sales",
-  size: 0,
-  filter_path: "aggregations",
-  query: {
-    term: {
-      type: "t-shirt",
-    },
-  },
-  aggs: {
-    avg_price: {
-      avg: {
-        field: "price",
-      },
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/0165d22da5f2fc7678392b31d8eb5566.asciidoc
+++ b/docs/doc_examples/0165d22da5f2fc7678392b31d8eb5566.asciidoc
@ -1,18 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.inference.put({
-  task_type: "rerank",
-  inference_id: "my-rerank-model",
-  inference_config: {
-    service: "cohere",
-    service_settings: {
-      model_id: "rerank-english-v3.0",
-      api_key: "{{COHERE_API_KEY}}",
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/019e329ed5a930aef825266822e7377a.asciidoc
+++ b/docs/doc_examples/019e329ed5a930aef825266822e7377a.asciidoc
@ -1,26 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.create({
-  index: "asciifold_example",
-  settings: {
-    analysis: {
-      analyzer: {
-        standard_asciifolding: {
-          tokenizer: "standard",
-          filter: ["my_ascii_folding"],
-        },
-      },
-      filter: {
-        my_ascii_folding: {
-          type: "asciifolding",
-          preserve_original: true,
-        },
-      },
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/01ae196538fac197eedbbf458a4ef31b.asciidoc
+++ b/docs/doc_examples/01ae196538fac197eedbbf458a4ef31b.asciidoc
@ -1,36 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.create({
-  index: "idx",
-  settings: {
-    index: {
-      mapping: {
-        source: {
-          mode: "synthetic",
-        },
-      },
-    },
-  },
-  mappings: {
-    properties: {
-      kwd: {
-        type: "keyword",
-        ignore_above: 3,
-      },
-    },
-  },
-});
-console.log(response);
-
-const response1 = await client.index({
-  index: "idx",
-  id: 1,
-  document: {
-    kwd: ["foo", "foo", "bang", "bar", "baz"],
-  },
-});
-console.log(response1);
----
--- a/docs/doc_examples/01b23f09d2b7f140faf649eadbbf3ac3.asciidoc
+++ b/docs/doc_examples/01b23f09d2b7f140faf649eadbbf3ac3.asciidoc
@ -1,37 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.cluster.putComponentTemplate({
-  name: "component_template1",
-  template: {
-    mappings: {
-      properties: {
-        "@timestamp": {
-          type: "date",
-        },
-      },
-    },
-  },
-});
-console.log(response);
-
-const response1 = await client.cluster.putComponentTemplate({
-  name: "runtime_component_template",
-  template: {
-    mappings: {
-      runtime: {
-        day_of_week: {
-          type: "keyword",
-          script: {
-            source:
-              "emit(doc['@timestamp'].value.dayOfWeekEnum.getDisplayName(TextStyle.FULL, Locale.ENGLISH))",
-          },
-        },
-      },
-    },
-  },
-});
-console.log(response1);
----
--- a/docs/doc_examples/01bc0f2ed30eb3dd23511d01ce0ac6e1.asciidoc
+++ b/docs/doc_examples/01bc0f2ed30eb3dd23511d01ce0ac6e1.asciidoc
@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.transform.startTransform({
-  transform_id: "ecommerce_transform",
-});
-console.log(response);
----
--- a/docs/doc_examples/01cd0ea360282a2c591a366679d7187d.asciidoc
+++ b/docs/doc_examples/01cd0ea360282a2c591a366679d7187d.asciidoc
@ -1,12 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.tasks.list({
-  human: "true",
-  detailed: "true",
-  actions: "indices:data/write/bulk",
-});
-console.log(response);
----
--- a/docs/doc_examples/01dc7bdc223bd651574ed2d3954a5b1c.asciidoc
+++ b/docs/doc_examples/01dc7bdc223bd651574ed2d3954a5b1c.asciidoc
@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.watcher.executeWatch({
-  id: "my_watch",
-});
-console.log(response);
----
--- a/docs/doc_examples/01f50acf7998b24969f451e922d145eb.asciidoc
+++ b/docs/doc_examples/01f50acf7998b24969f451e922d145eb.asciidoc
@ -1,39 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.create({
-  index: "basque_example",
-  settings: {
-    analysis: {
-      filter: {
-        basque_stop: {
-          type: "stop",
-          stopwords: "_basque_",
-        },
-        basque_keywords: {
-          type: "keyword_marker",
-          keywords: ["Adibidez"],
-        },
-        basque_stemmer: {
-          type: "stemmer",
-          language: "basque",
-        },
-      },
-      analyzer: {
-        rebuilt_basque: {
-          tokenizer: "standard",
-          filter: [
-            "lowercase",
-            "basque_stop",
-            "basque_keywords",
-            "basque_stemmer",
-          ],
-        },
-      },
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/020c95db88ef356093f03be84893ddf9.asciidoc
+++ b/docs/doc_examples/020c95db88ef356093f03be84893ddf9.asciidoc
@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.ccr.followStats({
-  index: "<index>",
-});
-console.log(response);
----
--- a/docs/doc_examples/020de6b6cb960a76297452725a38889f.asciidoc
+++ b/docs/doc_examples/020de6b6cb960a76297452725a38889f.asciidoc
@ -1,20 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.search({
-  query: {
-    has_child: {
-      type: "child",
-      query: {
-        match_all: {},
-      },
-      max_children: 10,
-      min_children: 2,
-      score_mode: "min",
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/025155da86802ebf4c3aeee5aab692f9.asciidoc
+++ b/docs/doc_examples/025155da86802ebf4c3aeee5aab692f9.asciidoc
@ -1,28 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.create({
-  index: "sales",
-  mappings: {
-    properties: {
-      tags: {
-        type: "keyword",
-      },
-      comments: {
-        type: "nested",
-        properties: {
-          username: {
-            type: "keyword",
-          },
-          comment: {
-            type: "text",
-          },
-        },
-      },
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/02520ac7816b2c4cf8fb413fd16122f2.asciidoc
+++ b/docs/doc_examples/02520ac7816b2c4cf8fb413fd16122f2.asciidoc
@ -1,11 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.ml.flushJob({
-  job_id: "low_request_rate",
-  calc_interim: true,
-});
-console.log(response);
----
--- a/docs/doc_examples/025b54db0edc50c24ea48a2bd94366ad.asciidoc
+++ b/docs/doc_examples/025b54db0edc50c24ea48a2bd94366ad.asciidoc
@ -0,0 +1,14 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: 'twitter',
+  size: '0',
+  q: 'extra:test',
+  filter_path: 'hits.total'
+})
+console.log(response)
+----
+
--- a/docs/doc_examples/0264e994a7e68561e2ca6be0f0d90ee9.asciidoc
+++ b/docs/doc_examples/0264e994a7e68561e2ca6be0f0d90ee9.asciidoc
@ -1,23 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.search({
-  aggs: {
-    JapaneseCars: {
-      terms: {
-        field: "make",
-        include: ["mazda", "honda"],
-      },
-    },
-    ActiveCarManufacturers: {
-      terms: {
-        field: "make",
-        exclude: ["rover", "jensen"],
-      },
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/0280247e0cf2e561c548f22c9fb31163.asciidoc
+++ b/docs/doc_examples/0280247e0cf2e561c548f22c9fb31163.asciidoc
@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.security.invalidateToken({
-  username: "myuser",
-});
-console.log(response);
----
--- a/docs/doc_examples/02853293a5b7cd9cc7a886eb413bbeb6.asciidoc
+++ b/docs/doc_examples/02853293a5b7cd9cc7a886eb413bbeb6.asciidoc
@ -1,28 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.analyze({
-  tokenizer: "keyword",
-  char_filter: [
-    {
-      type: "mapping",
-      mappings: [
-        "٠ => 0",
-        "١ => 1",
-        "٢ => 2",
-        "٣ => 3",
-        "٤ => 4",
-        "٥ => 5",
-        "٦ => 6",
-        "٧ => 7",
-        "٨ => 8",
-        "٩ => 9",
-      ],
-    },
-  ],
-  text: "My license plate is ٢٥٠١٥",
-});
-console.log(response);
----
--- a/docs/doc_examples/028f6d6ac2594e20b78b8a8f8cbad49d.asciidoc
+++ b/docs/doc_examples/028f6d6ac2594e20b78b8a8f8cbad49d.asciidoc
@ -0,0 +1,43 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  body: {
+    aggs: {
+      countries: {
+        terms: {
+          field: 'artist.country',
+          order: [
+            {
+              'rock>playback_stats.avg': 'desc'
+            },
+            {
+              _count: 'desc'
+            }
+          ]
+        },
+        aggs: {
+          rock: {
+            filter: {
+              term: {
+                genre: 'rock'
+              }
+            },
+            aggs: {
+              playback_stats: {
+                stats: {
+                  field: 'play_count'
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+})
+console.log(response)
+----
+
--- a/docs/doc_examples/029de2f5383a42e1ac4ca1565bd2a130.asciidoc
+++ b/docs/doc_examples/029de2f5383a42e1ac4ca1565bd2a130.asciidoc
@ -1,21 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.create({
-  index: "my-index-000001",
-  mappings: {
-    properties: {
-      full_name: {
-        type: "text",
-        index_prefixes: {
-          min_chars: 1,
-          max_chars: 10,
-        },
-      },
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/02c48d461536709c3fc8a0e8147c3787.asciidoc
+++ b/docs/doc_examples/02c48d461536709c3fc8a0e8147c3787.asciidoc
@ -1,24 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.ingest.putPipeline({
-  id: "pipelineB",
-  description: "outer pipeline",
-  processors: [
-    {
-      pipeline: {
-        name: "pipelineA",
-      },
-    },
-    {
-      set: {
-        field: "outer_pipeline_set",
-        value: "outer",
-      },
-    },
-  ],
-});
-console.log(response);
----
--- a/docs/doc_examples/02f65c6bab8f40bf3ce18160623d1870.asciidoc
+++ b/docs/doc_examples/02f65c6bab8f40bf3ce18160623d1870.asciidoc
@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.getTemplate({
-  name: "template_1",
-});
-console.log(response);
----
--- a/docs/doc_examples/02fad6b80bb29c2a7e6840db2fc67b18.asciidoc
+++ b/docs/doc_examples/02fad6b80bb29c2a7e6840db2fc67b18.asciidoc
@ -1,38 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.create({
-  index: "my-index-000001",
-  mappings: {
-    properties: {
-      my_wildcard: {
-        type: "wildcard",
-      },
-    },
-  },
-});
-console.log(response);
-
-const response1 = await client.index({
-  index: "my-index-000001",
-  id: 1,
-  document: {
-    my_wildcard: "This string can be quite lengthy",
-  },
-});
-console.log(response1);
-
-const response2 = await client.search({
-  index: "my-index-000001",
-  query: {
-    wildcard: {
-      my_wildcard: {
-        value: "*quite*lengthy",
-      },
-    },
-  },
-});
-console.log(response2);
----
--- a/docs/doc_examples/032eac56b798bea29390e102538f4a26.asciidoc
+++ b/docs/doc_examples/032eac56b798bea29390e102538f4a26.asciidoc
@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.refresh({
-  index: "my-index-000001,my-index-000002",
-});
-console.log(response);
----
--- a/docs/doc_examples/033778305d52746f5ce0a2a922c8e521.asciidoc
+++ b/docs/doc_examples/033778305d52746f5ce0a2a922c8e521.asciidoc
@ -0,0 +1,22 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  body: {
+    aggs: {
+      genres: {
+        terms: {
+          script: {
+            source: "doc['genre'].value",
+            lang: 'painless'
+          }
+        }
+      }
+    }
+  }
+})
+console.log(response)
+----
+
--- a/docs/doc_examples/033838729cfb5d1a28d04f69ee78d924.asciidoc
+++ b/docs/doc_examples/033838729cfb5d1a28d04f69ee78d924.asciidoc
@ -1,26 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.index({
-  index: "example",
-  document: {
-    location: {
-      type: "Polygon",
-      orientation: "LEFT",
-      coordinates: [
-        [
-          [-177, 10],
-          [176, 15],
-          [172, 0],
-          [176, -15],
-          [-177, -10],
-          [-177, 10],
-        ],
-      ],
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/0350410d11579f4e876c798ce1eaef5b.asciidoc
+++ b/docs/doc_examples/0350410d11579f4e876c798ce1eaef5b.asciidoc
@ -1,36 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.index({
-  index: "my-index-000001",
-  id: 5,
-  refresh: "true",
-  document: {
-    query: {
-      bool: {
-        should: [
-          {
-            match: {
-              message: {
-                query: "Japanese art",
-                _name: "query1",
-              },
-            },
-          },
-          {
-            match: {
-              message: {
-                query: "Holand culture",
-                _name: "query2",
-              },
-            },
-          },
-        ],
-      },
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/0350ff5ebb8207c004eb771088339cb4.asciidoc
+++ b/docs/doc_examples/0350ff5ebb8207c004eb771088339cb4.asciidoc
@ -1,38 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.search({
-  index: "example-index",
-  retriever: {
-    rrf: {
-      retrievers: [
-        {
-          standard: {
-            query: {
-              term: {
-                text: "blue shoes sale",
-              },
-            },
-          },
-        },
-        {
-          standard: {
-            query: {
-              sparse_vector: {
-                field: "ml.tokens",
-                inference_id: "my_elser_model",
-                query: "What blue shoes are on sale?",
-              },
-            },
-          },
-        },
-      ],
-      rank_window_size: 50,
-      rank_constant: 20,
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/03582fc93683e573062bcfda45e01d69.asciidoc
+++ b/docs/doc_examples/03582fc93683e573062bcfda45e01d69.asciidoc
@ -1,29 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.create({
-  index: "my-index-000001",
-  settings: {
-    analysis: {
-      analyzer: {
-        my_custom_analyzer: {
-          type: "custom",
-          tokenizer: "standard",
-          char_filter: ["html_strip"],
-          filter: ["lowercase", "asciifolding"],
-        },
-      },
-    },
-  },
-});
-console.log(response);
-
-const response1 = await client.indices.analyze({
-  index: "my-index-000001",
-  analyzer: "my_custom_analyzer",
-  text: "Is this déjà vu</b>?",
-});
-console.log(response1);
----
--- a/docs/doc_examples/035a7a919eb6513b4769a3727b7d6447.asciidoc
+++ b/docs/doc_examples/035a7a919eb6513b4769a3727b7d6447.asciidoc
@ -1,11 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.analyze({
-  analyzer: "whitespace",
-  text: "The quick brown fox.",
-});
-console.log(response);
----
--- a/docs/doc_examples/03891265df2111a38e0b6b24c1b967e1.asciidoc
+++ b/docs/doc_examples/03891265df2111a38e0b6b24c1b967e1.asciidoc
@ -1,8 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.security.getServiceAccounts();
-console.log(response);
----
--- a/docs/doc_examples/03b1d76fa0b773d5b7d74ecb7e1e1a80.asciidoc
+++ b/docs/doc_examples/03b1d76fa0b773d5b7d74ecb7e1e1a80.asciidoc
@ -1,14 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.snapshot.restore({
-  repository: "my_repository",
-  snapshot: "my_snapshot_2099.05.06",
-  indices: "my-index,logs-my_app-default",
-  rename_pattern: "(.+)",
-  rename_replacement: "restored-$1",
-});
-console.log(response);
----
--- a/docs/doc_examples/03c4b815bf1e6a8c5cfcc6ddf94bc093.asciidoc
+++ b/docs/doc_examples/03c4b815bf1e6a8c5cfcc6ddf94bc093.asciidoc
@ -1,11 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.sql.query({
-  format: "txt",
-  query: "SELECT * FROM library ORDER BY page_count DESC LIMIT 5",
-});
-console.log(response);
----
--- a/docs/doc_examples/04412d11783dac25b5fd2ec5407078a3.asciidoc
+++ b/docs/doc_examples/04412d11783dac25b5fd2ec5407078a3.asciidoc
@ -1,12 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.connector.updateApiKeyId({
-  connector_id: "my-connector",
-  api_key_id: "my-api-key-id",
-  api_key_secret_id: "my-connector-secret-id",
-});
-console.log(response);
----
--- a/docs/doc_examples/044b2f99e7438e408685b258db17f863.asciidoc
+++ b/docs/doc_examples/044b2f99e7438e408685b258db17f863.asciidoc
@ -1,12 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.eql.search({
-  index: "my-data-stream",
-  query: '\n    process where process.name == "regsvr32.exe"\n  ',
-  size: 50,
-});
-console.log(response);
----
--- a/docs/doc_examples/046b2249bbc49e77848c114cee940f17.asciidoc
+++ b/docs/doc_examples/046b2249bbc49e77848c114cee940f17.asciidoc
@ -1,52 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.search({
-  index: "my-index",
-  retriever: {
-    rrf: {
-      retrievers: [
-        {
-          standard: {
-            query: {
-              multi_match: {
-                query: "How is the weather in Jamaica?",
-                fields: ["title", "description"],
-              },
-            },
-          },
-        },
-        {
-          standard: {
-            query: {
-              text_expansion: {
-                "ml.inference.title_expanded.predicted_value": {
-                  model_id: ".elser_model_2",
-                  model_text: "How is the weather in Jamaica?",
-                },
-              },
-            },
-          },
-        },
-        {
-          standard: {
-            query: {
-              text_expansion: {
-                "ml.inference.description_expanded.predicted_value": {
-                  model_id: ".elser_model_2",
-                  model_text: "How is the weather in Jamaica?",
-                },
-              },
-            },
-          },
-        },
-      ],
-      window_size: 10,
-      rank_constant: 20,
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/0470d7101637568b9d3d1239f06325a7.asciidoc
+++ b/docs/doc_examples/0470d7101637568b9d3d1239f06325a7.asciidoc
@ -1,27 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.transport.request({
-  method: "PUT",
-  path: "/_internal/desired_nodes/&lt;history_id&gt;/&lt;version&gt;",
-  body: {
-    nodes: [
-      {
-        settings: {
-          "node.name": "instance-000187",
-          "node.external_id": "instance-000187",
-          "node.roles": ["data_hot", "master"],
-          "node.attr.data": "hot",
-          "node.attr.logical_availability_zone": "zone-0",
-        },
-        processors: 8,
-        memory: "58gb",
-        storage: "2tb",
-      },
-    ],
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/047266b0d20fdb62ebc72d51952c8f6d.asciidoc
+++ b/docs/doc_examples/047266b0d20fdb62ebc72d51952c8f6d.asciidoc
@ -4,14 +4,20 @@
 [source, js]
 ----
 const response = await client.search({
-  query: {
-    multi_match: {
-      query: "Will Smith",
-      type: "cross_fields",
-      fields: ["first_name", "last_name"],
-      operator: "and",
-    },
-  },
-});
-console.log(response);
+  body: {
+    query: {
+      multi_match: {
+        query: 'Will Smith',
+        type: 'cross_fields',
+        fields: [
+          'first_name',
+          'last_name'
+        ],
+        operator: 'and'
+      }
+    }
+  }
+})
+console.log(response)
 ----
+
--- a/docs/doc_examples/048652b6abfe195da8ea8cef10ee01b1.asciidoc
+++ b/docs/doc_examples/048652b6abfe195da8ea8cef10ee01b1.asciidoc
@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.transform.resetTransform({
-  transform_id: "ecommerce_transform",
-});
-console.log(response);
----
--- a/docs/doc_examples/048d8abd42d094bbdcf4452a58ccb35b.asciidoc
+++ b/docs/doc_examples/048d8abd42d094bbdcf4452a58ccb35b.asciidoc
@ -0,0 +1,17 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.create({
+  index: 'twitter',
+  id: '1',
+  body: {
+    user: 'kimchy',
+    post_date: '2009-11-15T14:12:12',
+    message: 'trying out Elasticsearch'
+  }
+})
+console.log(response)
+----
+
--- a/docs/doc_examples/04d586a536061ec1045d0bb2dc3d1a5f.asciidoc
+++ b/docs/doc_examples/04d586a536061ec1045d0bb2dc3d1a5f.asciidoc
@ -1,31 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.ingest.putPipeline({
-  id: "set_os",
-  description: "sets the value of host.os.name from the field os",
-  processors: [
-    {
-      set: {
-        field: "host.os.name",
-        value: "{{{os}}}",
-      },
-    },
-  ],
-});
-console.log(response);
-
-const response1 = await client.ingest.simulate({
-  id: "set_os",
-  docs: [
-    {
-      _source: {
-        os: "Ubuntu",
-      },
-    },
-  ],
-});
-console.log(response1);
----
--- a/docs/doc_examples/04d6ce0c903bd468afbecd3aa1c4a78a.asciidoc
+++ b/docs/doc_examples/04d6ce0c903bd468afbecd3aa1c4a78a.asciidoc
@ -1,27 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.ingest.putPipeline({
-  id: "my-pipeline-id",
-  description: "My optional pipeline description",
-  processors: [
-    {
-      set: {
-        description: "My optional processor description",
-        field: "my-keyword-field",
-        value: "foo",
-      },
-    },
-  ],
-  _meta: {
-    reason: "set my-keyword-field to foo",
-    serialization: {
-      class: "MyPipeline",
-      id: 10,
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/04de2e3a9c00c2056b07bf9cf9e63a99.asciidoc
+++ b/docs/doc_examples/04de2e3a9c00c2056b07bf9cf9e63a99.asciidoc
@ -1,20 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.inference.put({
-  task_type: "text_embedding",
-  inference_id: "google_vertex_ai_embeddings",
-  inference_config: {
-    service: "googlevertexai",
-    service_settings: {
-      service_account_json: "<service_account_json>",
-      model_id: "<model_id>",
-      location: "<location>",
-      project_id: "<project_id>",
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/04f5dd677c777bcb15d7d5fa63275fc8.asciidoc
+++ b/docs/doc_examples/04f5dd677c777bcb15d7d5fa63275fc8.asciidoc
@ -4,8 +4,9 @@
 [source, js]
 ----
 const response = await client.cluster.health({
-  wait_for_status: "yellow",
-  timeout: "50s",
-});
-console.log(response);
+  wait_for_status: 'yellow',
+  timeout: '50s'
+})
+console.log(response)
 ----
+
--- a/docs/doc_examples/04fe1e3a0047b0cdb10987b79fc3f3f3.asciidoc
+++ b/docs/doc_examples/04fe1e3a0047b0cdb10987b79fc3f3f3.asciidoc
@ -0,0 +1,30 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  body: {
+    query: {
+      term: {
+        user: 'kimchy'
+      }
+    },
+    sort: {
+      _script: {
+        type: 'number',
+        script: {
+          lang: 'painless',
+          source: "doc['field_name'].value * params.factor",
+          params: {
+            factor: 1.1
+          }
+        },
+        order: 'asc'
+      }
+    }
+  }
+})
+console.log(response)
+----
+
--- a/docs/doc_examples/0502284d4685c478eb68761f979f4303.asciidoc
+++ b/docs/doc_examples/0502284d4685c478eb68761f979f4303.asciidoc
@ -1,37 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.ml.evaluateDataFrame({
-  index: "house_price_predictions",
-  query: {
-    bool: {
-      filter: [
-        {
-          term: {
-            "ml.is_training": false,
-          },
-        },
-      ],
-    },
-  },
-  evaluation: {
-    regression: {
-      actual_field: "price",
-      predicted_field: "ml.price_prediction",
-      metrics: {
-        r_squared: {},
-        mse: {},
-        msle: {
-          offset: 10,
-        },
-        huber: {
-          delta: 1.5,
-        },
-      },
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/050b3947025fee403232b8e6e9112dab.asciidoc
+++ b/docs/doc_examples/050b3947025fee403232b8e6e9112dab.asciidoc
@ -1,12 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.sql.query({
-  format: "yaml",
-  query: "SELECT * FROM library ORDER BY page_count DESC",
-  fetch_size: 5,
-});
-console.log(response);
----
--- a/docs/doc_examples/05148cc541f447486d9daf15ab77292b.asciidoc
+++ b/docs/doc_examples/05148cc541f447486d9daf15ab77292b.asciidoc
@ -1,54 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.ilm.putLifecycle({
-  name: "logs",
-  policy: {
-    phases: {
-      hot: {
-        actions: {
-          rollover: {
-            max_primary_shard_size: "50gb",
-          },
-        },
-      },
-      warm: {
-        min_age: "30d",
-        actions: {
-          shrink: {
-            number_of_shards: 1,
-          },
-          forcemerge: {
-            max_num_segments: 1,
-          },
-        },
-      },
-      cold: {
-        min_age: "60d",
-        actions: {
-          searchable_snapshot: {
-            snapshot_repository: "found-snapshots",
-          },
-        },
-      },
-      frozen: {
-        min_age: "90d",
-        actions: {
-          searchable_snapshot: {
-            snapshot_repository: "found-snapshots",
-          },
-        },
-      },
-      delete: {
-        min_age: "735d",
-        actions: {
-          delete: {},
-        },
-      },
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/0518c673094fb18ecb491a3b78af4695.asciidoc
+++ b/docs/doc_examples/0518c673094fb18ecb491a3b78af4695.asciidoc
@ -1,23 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.ilm.putLifecycle({
-  name: "my_policy",
-  policy: {
-    phases: {
-      warm: {
-        actions: {
-          allocate: {
-            include: {
-              box_type: "hot,warm",
-            },
-          },
-        },
-      },
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/05284c8ea91769c09c8db47db8a6629a.asciidoc
+++ b/docs/doc_examples/05284c8ea91769c09c8db47db8a6629a.asciidoc
@ -1,10 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.cat.repositories({
-  v: "true",
-});
-console.log(response);
----
--- a/docs/doc_examples/053497b6960f80fd7b005b7c6d54358f.asciidoc
+++ b/docs/doc_examples/053497b6960f80fd7b005b7c6d54358f.asciidoc
@ -1,19 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.ilm.putLifecycle({
-  name: "my_policy",
-  policy: {
-    phases: {
-      delete: {
-        actions: {
-          delete: {},
-        },
-      },
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/05500e77aef581d92f6c605f7a48f7df.asciidoc
+++ b/docs/doc_examples/05500e77aef581d92f6c605f7a48f7df.asciidoc
@ -1,24 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.index({
-  index: "example",
-  document: {
-    location: {
-      type: "polygon",
-      coordinates: [
-        [
-          [1000, -1001],
-          [1001, -1001],
-          [1001, -1000],
-          [1000, -1000],
-          [1000, -1001],
-        ],
-      ],
-    },
-  },
-});
-console.log(response);
----
--- a/docs/doc_examples/059e04aaf093379401f665c33ac796dc.asciidoc
+++ b/docs/doc_examples/059e04aaf093379401f665c33ac796dc.asciidoc
@ -1,20 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
----
-const response = await client.indices.analyze({
-  tokenizer: "whitespace",
-  filter: [
-    {
-      type: "keyword_marker",
-      keywords: ["jumping"],
-    },
-    "stemmer",
-  ],
-  text: "fox running and jumping",
-  explain: true,
-  attributes: "keyword",
-});
-console.log(response);
----
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Josh Mock	a8da143bfc	Switch 8.9 clients to only get patch updates to transport (#2213 )	2024-04-09 12:54:05 -05:00
github-actions[bot]	f6f0747b8c	[Backport 8.9] Add important flag to proxy config docs (#2042 ) (cherry picked from commit `f7ed0394bf`) Co-authored-by: Josh Mock <joshua.mock@elastic.co>	2023-10-24 15:40:30 -05:00
Josh Mock	6e70735ac0	[Backport 8.9] Improve proxy configuration docs (#2035 ) (#2039 )	2023-10-24 14:10:52 -05:00
Elastic Machine	f85de4aaaa	Auto-generated code for 8.9 (#2023 )	2023-09-28 11:30:53 -05:00
Elastic Machine	10d4d18dfe	Auto-generated code for 8.9 (#2018 )	2023-09-22 11:31:46 -05:00
James Rodewig	36afd130f8	[8.9] [DOCS] Fix `welcome-to-elastic` link (#2007 ) (#2009 )	2023-09-14 11:26:01 -05:00
Josh Mock	3186f4fc63	[Backport 8.9] Upgrade transport: skip adding new nodes that aren't ready yet (#1995 ) (#2005 )	2023-09-12 12:02:38 -05:00
Josh Mock	0096710263	[Backport 8.9] Pin untrusted Github Action to a commit hash (#1986 ) (#1991 )	2023-08-28 14:54:11 -05:00
Elastic Machine	fc34ebc329	Auto-generated code for 8.9 (#1977 )	2023-08-23 10:33:37 -05:00
github-actions[bot]	af6a9245c2	[Backport 8.9] Fix branch name checker for automatic codegen script (#1982 ) Co-authored-by: Josh Mock <joshua.mock@elastic.co>	2023-08-22 11:57:29 -05:00
github-actions[bot]	811e952d2d	[Backport 8.9] Update codegen task to be runnable via CI (#1973 ) Co-authored-by: Josh Mock <joshua.mock@elastic.co>	2023-08-17 16:08:19 -05:00
Josh Mock	a8ae21f461	Bump to 8.9.1 (#1970 )	2023-08-17 11:14:44 -05:00
github-actions[bot]	b1389cfebe	[Backport 8.9] Upgrade transport (#1969 ) Co-authored-by: Josh Mock <joshua.mock@elastic.co>	2023-08-11 13:00:09 -05:00
Josh Mock	5b08121507	Clean up package.json canary side effect (#1964 )	2023-07-25 17:13:53 -05:00
github-actions[bot]	2a65740d62	[Backport 8.9] Changelog for 8.9.0 (#1962 ) Co-authored-by: Josh Mock <joshua.mock@elastic.co>	2023-07-25 16:46:42 -05:00
Josh Mock	ab764ae5c7	Codegen for 8.9 (#1956 )	2023-07-25 13:02:04 -05:00
github-actions[bot]	29dfffef9f	[Backport 8.9] Add docs for bulk helper improvement (#1958 ) Co-authored-by: Josh Mock <joshua.mock@elastic.co>	2023-07-25 11:40:39 -05:00
github-actions[bot]	3ccd149249	[Backport 8.9] Update user agent format (#1959 ) Co-authored-by: Josh Mock <joshua.mock@elastic.co>	2023-07-25 11:13:56 -05:00
Josh Mock	e88999f144	[Backport 8.9] Allow document to be overwritten in `onDocument` iteratee of bulk helper (#1732 )Co-authored-by: Josh Mock <joshua.mock@elastic.co> (#1953 ) Co-authored-by: Robert Da Silva <mail@robdasilva.com>	2023-07-20 15:46:52 -05:00
github-actions[bot]	485e57a375	[Backport 8.9] [DOCS] Restructures repo README (#1950 ) Co-authored-by: István Zoltán Szabó <szabosteve@gmail.com>	2023-07-19 15:19:15 -05:00
github-actions[bot]	b92146c708	[Backport 8.9] [DOCS] Changes getting started button link on landing page (#1935 ) Co-authored-by: István Zoltán Szabó <szabosteve@gmail.com>	2023-07-05 13:51:25 -05:00
github-actions[bot]	111d126d8c	[DOCS] Adds getting started content based on the template (#1929 ) (#1931 ) Co-authored-by: Josh Mock <joshua.mock@elastic.co> Co-authored-by: István Zoltán Szabó <szabosteve@gmail.com>	2023-07-05 16:47:51 +02:00
Josh Mock	135abcb850	Fix version in package.json	2023-06-28 16:07:06 -05:00
Josh Mock	1641930396	Canary version bump	2023-06-23 16:46:20 -05:00
Josh Mock	2b7d96e1e2	Canary version bump + missing file	2023-06-23 16:45:44 -05:00
Josh Mock	642f8309e9	Update APIs to latest 8.9.0	2023-06-23 16:42:22 -05:00