Backport #2543 (#2544)

(cherry picked from commit ed3cace127)

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

.buildkite/pipeline.yml

@@ -6,7 +6,7 @@ steps:
     env:
       NODE_VERSION: "{{ matrix.nodejs }}"
       TEST_SUITE: "{{ matrix.suite }}"
-      STACK_VERSION: 8.15.0
+      STACK_VERSION: 8.16.0
     matrix:
       setup:
         suite:

.dockerignore

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

.github/make.sh

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

.github/workflows/auto-merge.yml

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

.github/workflows/nodejs.yml

@@ -11,8 +11,10 @@ jobs:
     outputs:
       src-only: "${{ steps.changes.outputs.src-only }}"
     steps:
-      - uses: actions/checkout@v4
-      - uses: dorny/paths-filter/@v3.0.2
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+        with:
+          persist-credentials: false
+      - uses: dorny/paths-filter/@de90cc6fb38fc0963ad72b210f1f284cd68cea36 # v3.0.2
         id: changes
         with:
           filters: |
@@ -30,14 +32,16 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        node-version: [18.x, 20.x, 22.x]
+        node-version: [18.x, 20.x, 22.x, 23.x]
         os: [ubuntu-latest, windows-latest, macOS-latest]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+        with:
+          persist-credentials: false
 
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4
         with:
           node-version: ${{ matrix.node-version }}
 
@@ -53,15 +57,21 @@ jobs:
         run: |
           npm run test:unit
 
+      - name: ECMAScript module test
+        run: |
+          npm run test:esm
+
   license:
     name: License check
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+        with:
+          persist-credentials: false
 
       - name: Use Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4
         with:
           node-version: 22.x
 
@@ -86,10 +96,12 @@ jobs:
         os: [ubuntu-latest, windows-latest, macOS-latest]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+        with:
+          persist-credentials: false
 
       - name: Use Bun
-        uses: oven-sh/setup-bun@v2
+        uses: oven-sh/setup-bun@4bc047ad259df6fc24a6c9b0f9a0cb08cf17fbe5 # v2
 
       - name: Install
         run: |
@@ -103,12 +115,6 @@ jobs:
         run: |
           bun run test:unit-bun
 
-  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
+      - name: ECMAScript module test
+        run: |
+          bun run test:esm

.github/workflows/npm-publish.yml

@@ -12,10 +12,11 @@ jobs:
       contents: write
       id-token: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
         with:
+          persist-credentials: false
           ref: ${{ github.event.inputs.branch }}
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4
         with:
           node-version: "22.x"
           registry-url: "https://registry.npmjs.org"

.github/workflows/serverless-patch.yml

@@ -26,26 +26,28 @@ jobs:
         )
       )
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
         with:
+          persist-credentials: false
           repository: elastic/elasticsearch-js
           ref: main
           path: stack
           fetch-depth: 0
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
         with:
+          persist-credentials: false
           repository: elastic/elasticsearch-serverless-js
           ref: main
           path: serverless
       - name: Apply patch from stack to serverless
         id: apply-patch
         run: $GITHUB_WORKSPACE/stack/.github/workflows/serverless-patch.sh
-      - uses: peter-evans/create-pull-request@v6
+      - uses: peter-evans/create-pull-request@c5a7806660adbe173f04e3e038b0ccdcd758773c # 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 }}'
+          title: "Apply patch from elastic/elasticsearch-js#${{ github.event.pull_request.number }}"
+          commit-message: "Apply patch from elastic/elasticsearch-js#${{ github.event.pull_request.number }}"
           body-path: /tmp/pr_body
-          draft: '${{ steps.apply-patch.outputs.PR_DRAFT }}'
-          add-paths: ':!*.rej'
+          draft: "${{ steps.apply-patch.outputs.PR_DRAFT }}"
+          add-paths: ":!*.rej"

.github/workflows/stale.yml

@@ -8,7 +8,7 @@ jobs:
   stale:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/stale@v8
+      - uses: actions/stale@1160a2240286f5da8ec72b1c0816ce2481aabf84 # v8
         with:
           stale-issue-label: stale
           stale-pr-label: stale

.gitignore

@@ -65,3 +65,6 @@ test/bundlers/parcel-test/.parcel-cache
 lib
 junit-output
 bun.lockb
+test-results
+processinfo
+.tap

.npmignore

@@ -73,3 +73,4 @@ CONTRIBUTING.md
 
 src
 bun.lockb
+.tap

catalog-info.yaml

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

docs/basic-config.asciidoc

@@ -252,8 +252,8 @@ const client = new Client({
 ----
 
 |`disablePrototypePoisoningProtection`
-|`boolean`, `'proto'`, `'constructor'` - By the default the client will protect you against prototype poisoning attacks. Read https://web.archive.org/web/20200319091159/https://hueniverse.com/square-brackets-are-the-enemy-ff5b9fd8a3e8?gi=184a27ee2a08[this article] to learn more. If needed you can disable prototype poisoning protection entirely or one of the two checks. Read the `secure-json-parse` https://github.com/fastify/secure-json-parse[documentation] to learn more. +
-_Default:_ `false`
+|`boolean`, `'proto'`, `'constructor'` - The client can protect you against prototype poisoning attacks. Read https://web.archive.org/web/20200319091159/https://hueniverse.com/square-brackets-are-the-enemy-ff5b9fd8a3e8?gi=184a27ee2a08[this article] to learn more about this security concern. If needed, you can enable prototype poisoning protection entirely (`false`) or one of the two checks (`'proto'` or `'constructor'`). For performance reasons, it is disabled by default. Read the `secure-json-parse` https://github.com/fastify/secure-json-parse[documentation] to learn more. +
+_Default:_ `true`
 
 |`caFingerprint`
 |`string` - If configured, verify that the fingerprint of the CA certificate that has signed the certificate of the server matches the supplied fingerprint. Only accepts SHA256 digest fingerprints. +

docs/changelog.asciidoc

@@ -1,6 +1,119 @@
 [[changelog-client]]
 == Release notes
 
+[discrete]
+=== 8.17.0
+
+[discrete]
+==== Features
+
+[discrete]
+===== Support for Elasticsearch `v8.17`
+
+You can find all the API changes
+https://www.elastic.co/guide/en/elasticsearch/reference/8.17/release-notes-8.17.0.html[here].
+
+[discrete]
+=== 8.16.3
+
+[discrete]
+==== Fixes
+
+[discrete]
+===== Improved support for Elasticsearch `v8.16`
+
+Updated TypeScript types based on fixes and improvements to the Elasticsearch specification.
+
+[discrete]
+=== 8.16.2
+
+[discrete]
+==== Fixes
+
+[discrete]
+===== Improved support for Elasticsearch `v8.16`
+
+Updated TypeScript types based on fixes and improvements to the Elasticsearch specification.
+
+[discrete]
+===== Drop testing artifacts from npm package
+
+Tap, the unit testing tool used by this project, was recently upgraded and started writing to a `.tap` directory. Since tests are run prior to an `npm publish` in CI, this directory was being included in the published package and bloating its size.
+
+[discrete]
+=== 8.16.1
+
+[discrete]
+==== Fixes
+
+[discrete]
+===== Fix ECMAScript imports
+
+Fixed package configuration to correctly support native ECMAScript `import` syntax.
+
+[discrete]
+=== 8.16.0
+
+[discrete]
+==== Features
+
+[discrete]
+===== Support for Elasticsearch `v8.16`
+
+You can find all the API changes
+https://www.elastic.co/guide/en/elasticsearch/reference/8.16/release-notes-8.16.0.html[here].
+
+[discrete]
+===== Support Apache Arrow in ES|QL helper
+
+The ES|QL helper can now return results as an Apache Arrow `Table` or `RecordBatchReader`, which enables high-performance calculations on ES|QL results, even if the response data is larger than the system's available memory. See <<esql-helper>> for more information.
+
+[discrete]
+==== Fixes
+
+[discrete]
+===== Pass prototype poisoning options to serializer correctly
+
+The client's `disablePrototypePoisoningProtection` option was set to `true` by default, but when it was set to any other value it was ignored, making it impossible to enable prototype poisoning protection without providing a custom serializer implementation.
+
+[discrete]
+=== 8.15.3
+
+[discrete]
+==== Fixes
+
+[discrete]
+===== Improved support for Elasticsearch `v8.15`
+
+Updated TypeScript types based on fixes and improvements to the Elasticsearch specification.
+
+[discrete]
+===== Drop testing artifacts from npm package
+
+Tap, the unit testing tool, was recently upgraded and started writing to a `.tap` directory. Since tests are run prior to an `npm publish` in CI, this directory was being included in the published package and bloating its size.
+
+[discrete]
+=== 8.15.2
+
+[discrete]
+==== Fixes
+
+[discrete]
+===== Improved support for Elasticsearch `v8.15`
+
+Updated TypeScript types based on fixes and improvements to the Elasticsearch specification.
+
+[discrete]
+=== 8.15.1
+
+[discrete]
+==== Fixes
+
+[discrete]
+===== Improved support for Elasticsearch `v8.15`
+
+Updated TypeScript types based on fixes and improvements to the Elasticsearch specification.
+
 [discrete]
 === 8.15.0
 

docs/configuration.asciidoc

@@ -2,10 +2,11 @@
 == 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>>

docs/connecting.asciidoc

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

docs/doc_examples/015e6e6132b6d6d44bddb06bc3b316ed.asciidoc

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

docs/doc_examples/0165d22da5f2fc7678392b31d8eb5566.asciidoc

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

docs/doc_examples/01ae196538fac197eedbbf458a4ef31b.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       kwd: {
         type: "keyword",

docs/doc_examples/01b23f09d2b7f140faf649eadbbf3ac3.asciidoc

@@ -26,7 +26,7 @@ const response1 = await client.cluster.putComponentTemplate({
           type: "keyword",
           script: {
             source:
-              "emit(doc['@timestamp'].value.dayOfWeekEnum.getDisplayName(TextStyle.FULL, Locale.ROOT))",
+              "emit(doc['@timestamp'].value.dayOfWeekEnum.getDisplayName(TextStyle.FULL, Locale.ENGLISH))",
           },
         },
       },

docs/doc_examples/01cd0ea360282a2c591a366679d7187d.asciidoc

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

docs/doc_examples/05e637284bc3bedd46e0b7c26ad983c4.asciidoc

@@ -4,7 +4,7 @@
 [source, js]
 ----
 const response = await client.ingest.putPipeline({
-  id: "alibabacloud_ai_search_embeddings",
+  id: "alibabacloud_ai_search_embeddings_pipeline",
   processors: [
     {
       inference: {

docs/doc_examples/0709a38613d2de90d418ce12b36af30e.asciidoc

@@ -0,0 +1,8 @@
+// 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.reroute();
+console.log(response);
+----

docs/doc_examples/083b92e8ea264e49bf9fd40fc6a3094b.asciidoc

@@ -14,6 +14,7 @@ const response = await client.inference.put({
         min_number_of_allocations: 3,
         max_number_of_allocations: 10,
       },
+      num_threads: 1,
       model_id: ".multilingual-e5-small",
     },
   },

docs/doc_examples/0b4e50f1b5a0537cbb1a41276bb51c54.asciidoc

@@ -10,7 +10,7 @@ const response = await client.search({
       type: "keyword",
       script: {
         source:
-          "emit(doc['@timestamp'].value.dayOfWeekEnum\n        .getDisplayName(TextStyle.FULL, Locale.ROOT))",
+          "emit(doc['@timestamp'].value.dayOfWeekEnum\n        .getDisplayName(TextStyle.FULL, Locale.ENGLISH))",
       },
     },
   },

docs/doc_examples/0bc6155e0c88062a4d8490da49db3aa8.asciidoc

@@ -0,0 +1,49 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "retrievers_example_nested",
+  retriever: {
+    rrf: {
+      retrievers: [
+        {
+          standard: {
+            query: {
+              nested: {
+                path: "nested_field",
+                inner_hits: {
+                  name: "nested_vector",
+                  _source: false,
+                  fields: ["nested_field.paragraph_id"],
+                },
+                query: {
+                  knn: {
+                    field: "nested_field.nested_vector",
+                    query_vector: [1, 0, 0.5],
+                    k: 10,
+                  },
+                },
+              },
+            },
+          },
+        },
+        {
+          standard: {
+            query: {
+              term: {
+                topic: "ai",
+              },
+            },
+          },
+        },
+      ],
+      rank_window_size: 10,
+      rank_constant: 1,
+    },
+  },
+  _source: ["topic"],
+});
+console.log(response);
+----

docs/doc_examples/0bee07a581c5776e068f6f4efad5a399.asciidoc

@@ -0,0 +1,15 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.esql.asyncQuery({
+  format: "json",
+  body: {
+    query:
+      "\n    FROM my-index-000001,cluster_one:my-index-000001,cluster_two:my-index*\n    | STATS COUNT(http.response.status_code) BY user.id\n    | LIMIT 2\n  ",
+    include_ccs_metadata: true,
+  },
+});
+console.log(response);
+----

docs/doc_examples/0c52af573c9401a2a687e86a4beb182b.asciidoc

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

docs/doc_examples/0c8be7aec84ea86b243904f5d4162f5a.asciidoc

@@ -0,0 +1,18 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "cooking_blog",
+  query: {
+    match: {
+      title: {
+        query: "fluffy pancakes breakfast",
+        minimum_should_match: 2,
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/0d30077cd34e93377a3a86f2ebd69415.asciidoc

@@ -9,7 +9,7 @@ const response = await client.connector.put({
   name: "My Connector",
   description: "My Connector to sync data to Elastic index from Google Drive",
   service_type: "google_drive",
-  language: "english",
+  language: "en",
 });
 console.log(response);
 ----

docs/doc_examples/0d689ac6e78be5d438f9b5d441be2b44.asciidoc

@@ -0,0 +1,57 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "retrievers_example",
+  retriever: {
+    rrf: {
+      retrievers: [
+        {
+          standard: {
+            query: {
+              term: {
+                topic: "elastic",
+              },
+            },
+          },
+        },
+        {
+          rrf: {
+            retrievers: [
+              {
+                standard: {
+                  query: {
+                    query_string: {
+                      query:
+                        "(information retrieval) OR (artificial intelligence)",
+                      default_field: "text",
+                    },
+                  },
+                },
+              },
+              {
+                knn: {
+                  field: "vector",
+                  query_vector: [0.23, 0.67, 0.89],
+                  k: 3,
+                  num_candidates: 5,
+                },
+              },
+            ],
+            rank_window_size: 10,
+            rank_constant: 1,
+          },
+        },
+      ],
+      rank_window_size: 10,
+      rank_constant: 1,
+    },
+  },
+  _source: false,
+  size: 1,
+  explain: true,
+});
+console.log(response);
+----

docs/doc_examples/0e31b8ad176b31028becf9500989bcbd.asciidoc

@@ -0,0 +1,21 @@
+// 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: "watsonx-embeddings",
+  inference_config: {
+    service: "watsonxai",
+    service_settings: {
+      api_key: "<api_key>",
+      url: "<url>",
+      model_id: "ibm/slate-30m-english-rtrvr",
+      project_id: "<project_id>",
+      api_version: "2024-03-14",
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/11be807bdeaeecc8174dec88e0851ea7.asciidoc

@@ -5,7 +5,11 @@
 ----
 const response = await client.transport.request({
   method: "GET",
-  path: "/_ingest/geoip/database/my-database-id",
+  path: "/_connector/_sync_job",
+  querystring: {
+    connector_id: "my-connector-id",
+    size: "1",
+  },
 });
 console.log(response);
 ----

docs/doc_examples/12e9e758f7f18a6cbf27e9d0aea57a19.asciidoc

@@ -0,0 +1,18 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.update({
+  index: ".elastic-connectors",
+  id: "connector_id",
+  doc: {
+    features: {
+      native_connector_api_keys: {
+        enabled: true,
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/1522a9297151d7046e6345b9b27539ca.asciidoc

@@ -0,0 +1,19 @@
+// 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.updateConfiguration({
+  connector_id: "my-connector-id",
+  values: {
+    host: "127.0.0.1",
+    port: 5432,
+    username: "myuser",
+    password: "mypassword",
+    database: "chinook",
+    schema: "public",
+    tables: "album,artist",
+  },
+});
+console.log(response);
+----

docs/doc_examples/15f769bbd7b5fddeb3353ae726b71b14.asciidoc

@@ -0,0 +1,28 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "my-index-bit-vectors",
+  query: {
+    script_score: {
+      query: {
+        match_all: {},
+      },
+      script: {
+        source: "dotProduct(params.query_vector, 'my_dense_vector')",
+        params: {
+          query_vector: [
+            0.23, 1.45, 3.67, 4.89, -0.56, 2.34, 3.21, 1.78, -2.45, 0.98, -0.12,
+            3.45, 4.56, 2.78, 1.23, 0.67, 3.89, 4.12, -2.34, 1.56, 0.78, 3.21,
+            4.12, 2.45, -1.67, 0.34, -3.45, 4.56, -2.78, 1.23, -0.67, 3.89,
+            -4.34, 2.12, -1.56, 0.78, -3.21, 4.45, 2.12, 1.67,
+          ],
+        },
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/16a7ce08b4a6b3af269f27eecc71d664.asciidoc

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

docs/doc_examples/17316a81c9dbdd120b7754116bf0461c.asciidoc

@@ -0,0 +1,26 @@
+// 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.createApiKey({
+  name: "my-connector-api-key",
+  role_descriptors: {
+    "my-connector-connector-role": {
+      cluster: ["monitor", "manage_connector"],
+      indices: [
+        {
+          names: [
+            "my-index_name",
+            ".search-acl-filter-my-index_name",
+            ".elastic-connectors*",
+          ],
+          privileges: ["all"],
+          allow_restricted_indices: false,
+        },
+      ],
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/17b1647c8509543f2388c886f2584a20.asciidoc

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

docs/doc_examples/193704020a19714dec390452a4e75e8d.asciidoc

@@ -3,8 +3,8 @@
 
 [source, js]
 ----
-const response = await client.cluster.reroute({
-  metric: "none",
+const response = await client.indices.create({
+  index: "books",
 });
 console.log(response);
 ----

docs/doc_examples/1a7483796087053ba55029d0dc2ab356.asciidoc

@@ -0,0 +1,19 @@
+// 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: "mv",
+  refresh: "true",
+  document: {
+    a: [2, null, 1],
+  },
+});
+console.log(response);
+
+const response1 = await client.esql.query({
+  query: "FROM mv | LIMIT 1",
+});
+console.log(response1);
+----

docs/doc_examples/1c330f0fc9eac19d0edeb8c4017b9b93.asciidoc

@@ -4,7 +4,7 @@
 [source, js]
 ----
 const response = await client.ingest.putPipeline({
-  id: "hugging_face_embeddings",
+  id: "hugging_face_embeddings_pipeline",
   processors: [
     {
       inference: {

docs/doc_examples/1c9dac4183a3532c91dbd1a46907729b.asciidoc

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

docs/doc_examples/1cbecd19be22979aefb45b4f160e77ea.asciidoc

@@ -4,7 +4,7 @@
 [source, js]
 ----
 const response = await client.ingest.putPipeline({
-  id: "google_vertex_ai_embeddings",
+  id: "google_vertex_ai_embeddings_pipeline",
   processors: [
     {
       inference: {

docs/doc_examples/1fb2c77c0988bc6545040b20e3afa7e9.asciidoc

@@ -0,0 +1,33 @@
+// 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.createApiKey({
+  name: "john-api-key",
+  expiration: "1d",
+  role_descriptors: {
+    "sharepoint-online-role": {
+      index: [
+        {
+          names: ["sharepoint-search-application"],
+          privileges: ["read"],
+          query: {
+            template: {
+              params: {
+                access_control: ["john@example.co", "Engineering Members"],
+              },
+              source:
+                '\n              {\n                "bool": {\n                  "should": [\n                    {\n                      "bool": {\n                        "must_not": {\n                          "exists": {\n                            "field": "_allow_access_control"\n                          }\n                        }\n                      }\n                    },\n                    {\n                      "terms": {\n                        "_allow_access_control.enum": {{#toJson}}access_control{{/toJson}}\n                      }\n                    }\n                  ]\n                }\n              }\n              ',
+            },
+          },
+        },
+      ],
+      restriction: {
+        workflows: ["search_application_query"],
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/216e24f05cbb82c1718713fbab8623d2.asciidoc

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

docs/doc_examples/21d41e8cbd107fbdf0901f885834dafc.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       card: {
         type: "wildcard",

docs/doc_examples/22b176a184517cf1b5801f5eb4f17f97.asciidoc

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

docs/doc_examples/24a037008e0fc2550ecb6a5d36c04a93.asciidoc

@@ -10,7 +10,7 @@ const response = await client.search({
     "date.day_of_week": {
       type: "keyword",
       script:
-        "emit(doc['date'].value.dayOfWeekEnum.getDisplayName(TextStyle.FULL, Locale.ROOT))",
+        "emit(doc['date'].value.dayOfWeekEnum.getDisplayName(TextStyle.FULL, Locale.ENGLISH))",
     },
   },
   aggs: {

docs/doc_examples/2577acb462b95bd4394523cf2f8a661f.asciidoc

@@ -1,28 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.esql.query({
-  format: "txt",
-  query:
-    "\n      FROM library\n    | SORT page_count DESC\n    | KEEP name, author\n    | LOOKUP era ON author\n    | LIMIT 5\n  ",
-  tables: {
-    era: {
-      author: {
-        keyword: [
-          "Frank Herbert",
-          "Peter F. Hamilton",
-          "Vernor Vinge",
-          "Alastair Reynolds",
-          "James S.A. Corey",
-        ],
-      },
-      era: {
-        keyword: ["The New Wave", "Diamond", "Diamond", "Diamond", "Hadron"],
-      },
-    },
-  },
-});
-console.log(response);
-----

docs/doc_examples/2968ffb8135f77ba3a9b876dd4918119.asciidoc

@@ -11,7 +11,7 @@ const response = await client.reindex({
   },
   dest: {
     index: "azure-ai-studio-embeddings",
-    pipeline: "azure_ai_studio_embeddings",
+    pipeline: "azure_ai_studio_embeddings_pipeline",
   },
 });
 console.log(response);

docs/doc_examples/2a67608dadbf220a2f040f3a79d3677d.asciidoc

@@ -0,0 +1,35 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.ingest.putPipeline({
+  id: "attachment",
+  description: "Extract attachment information including original binary",
+  processors: [
+    {
+      attachment: {
+        field: "data",
+        remove_binary: false,
+      },
+    },
+  ],
+});
+console.log(response);
+
+const response1 = await client.index({
+  index: "my-index-000001",
+  id: "my_id",
+  pipeline: "attachment",
+  document: {
+    data: "e1xydGYxXGFuc2kNCkxvcmVtIGlwc3VtIGRvbG9yIHNpdCBhbWV0DQpccGFyIH0=",
+  },
+});
+console.log(response1);
+
+const response2 = await client.get({
+  index: "my-index-000001",
+  id: "my_id",
+});
+console.log(response2);
+----

docs/doc_examples/2bb41b0b4876ce98cd0cd8fb6d337f18.asciidoc

@@ -1,16 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.cluster.putSettings({
-  persistent: {
-    "cluster.indices.close.enable": false,
-    "indices.recovery.max_bytes_per_sec": "50mb",
-  },
-  transient: {
-    "*": null,
-  },
-});
-console.log(response);
-----

docs/doc_examples/2c079d1ae4819a0c206b9e1aa5623523.asciidoc

@@ -0,0 +1,77 @@
+// 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: {
+      attributes: {
+        type: "passthrough",
+        priority: 10,
+        properties: {
+          id: {
+            type: "keyword",
+          },
+        },
+      },
+    },
+  },
+});
+console.log(response);
+
+const response1 = await client.index({
+  index: "my-index-000001",
+  id: 1,
+  document: {
+    attributes: {
+      id: "foo",
+      zone: 10,
+    },
+  },
+});
+console.log(response1);
+
+const response2 = await client.search({
+  index: "my-index-000001",
+  query: {
+    bool: {
+      must: [
+        {
+          match: {
+            id: "foo",
+          },
+        },
+        {
+          match: {
+            zone: 10,
+          },
+        },
+      ],
+    },
+  },
+});
+console.log(response2);
+
+const response3 = await client.search({
+  index: "my-index-000001",
+  query: {
+    bool: {
+      must: [
+        {
+          match: {
+            "attributes.id": "foo",
+          },
+        },
+        {
+          match: {
+            "attributes.zone": 10,
+          },
+        },
+      ],
+    },
+  },
+});
+console.log(response3);
+----

docs/doc_examples/2c86840a46242a38cf82024a9321be46.asciidoc

@@ -0,0 +1,28 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.indices.create({
+  index: "my-explicit-mappings-books",
+  mappings: {
+    dynamic: false,
+    properties: {
+      name: {
+        type: "text",
+      },
+      author: {
+        type: "text",
+      },
+      release_date: {
+        type: "date",
+        format: "yyyy-MM-dd",
+      },
+      page_count: {
+        type: "integer",
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/2d0244c020075595acb625aa5ba8f455.asciidoc

@@ -0,0 +1,25 @@
+// 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: "idx_keep",
+  id: 1,
+  document: {
+    path: {
+      to: [
+        {
+          foo: [3, 2, 1],
+        },
+        {
+          foo: [30, 20, 10],
+        },
+      ],
+      bar: "baz",
+    },
+    ids: [200, 100, 300, 100],
+  },
+});
+console.log(response);
+----

docs/doc_examples/2e7844477b41fcfa9efefee4ec0e7101.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({
+  index: "my-index-000001",
+  retriever: {
+    rule: {
+      match_criteria: {
+        query_string: "puggles",
+        user_country: "us",
+      },
+      ruleset_ids: ["my-ruleset"],
+      retriever: {
+        rrf: {
+          retrievers: [
+            {
+              standard: {
+                query: {
+                  query_string: {
+                    query: "pugs",
+                  },
+                },
+              },
+            },
+            {
+              standard: {
+                query: {
+                  query_string: {
+                    query: "puggles",
+                  },
+                },
+              },
+            },
+          ],
+        },
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/30d051f534aeb884176eedb2c11dac85.asciidoc

@@ -0,0 +1,23 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.inference.put({
+  task_type: "rerank",
+  inference_id: "my-elastic-rerank",
+  inference_config: {
+    service: "elasticsearch",
+    service_settings: {
+      model_id: ".rerank-v1",
+      num_threads: 1,
+      adaptive_allocations: {
+        enabled: true,
+        min_number_of_allocations: 1,
+        max_number_of_allocations: 4,
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/310bdfb0d0d75bac7bff036a3fe51d4d.asciidoc

@@ -4,7 +4,7 @@
 [source, js]
 ----
 const response = await client.ingest.putPipeline({
-  id: "azure_ai_studio_embeddings",
+  id: "azure_ai_studio_embeddings_pipeline",
   processors: [
     {
       inference: {

docs/doc_examples/334811cfceb6858aeec5b3461717dd63.asciidoc

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

docs/doc_examples/339c4e5af9f9069ad9912aa574488b59.asciidoc

@@ -0,0 +1,52 @@
+// 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-bit-vectors",
+  mappings: {
+    properties: {
+      my_dense_vector: {
+        type: "dense_vector",
+        index: false,
+        element_type: "bit",
+        dims: 40,
+      },
+    },
+  },
+});
+console.log(response);
+
+const response1 = await client.index({
+  index: "my-index-bit-vectors",
+  id: 1,
+  document: {
+    my_dense_vector: [8, 5, -15, 1, -7],
+  },
+});
+console.log(response1);
+
+const response2 = await client.index({
+  index: "my-index-bit-vectors",
+  id: 2,
+  document: {
+    my_dense_vector: [-1, 115, -3, 4, -128],
+  },
+});
+console.log(response2);
+
+const response3 = await client.index({
+  index: "my-index-bit-vectors",
+  id: 3,
+  document: {
+    my_dense_vector: [2, 18, -5, 0, -124],
+  },
+});
+console.log(response3);
+
+const response4 = await client.indices.refresh({
+  index: "my-index-bit-vectors",
+});
+console.log(response4);
+----

docs/doc_examples/36ac0ef9ea63efc431580f7ade8ad53c.asciidoc

@@ -11,7 +11,7 @@ const response = await client.reindex({
   },
   dest: {
     index: "openai-embeddings",
-    pipeline: "openai_embeddings",
+    pipeline: "openai_embeddings_pipeline",
   },
 });
 console.log(response);

docs/doc_examples/3a489743e49902df38e3368cae00717a.asciidoc

@@ -0,0 +1,8 @@
+// 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.nodes.hotThreads();
+console.log(response);
+----

docs/doc_examples/3a4953663a5a3809b692c27446e16b7f.asciidoc

@@ -11,7 +11,7 @@ const response = await client.reindex({
   },
   dest: {
     index: "amazon-bedrock-embeddings",
-    pipeline: "amazon_bedrock_embeddings",
+    pipeline: "amazon_bedrock_embeddings_pipeline",
   },
 });
 console.log(response);

docs/doc_examples/3ab8f65fcb55a0e3664c55749ec41efd.asciidoc

@@ -29,6 +29,7 @@ const response = await client.indices.create({
             "arabic_normalization",
             "persian_normalization",
             "persian_stop",
+            "persian_stem",
           ],
         },
       },

docs/doc_examples/40f287bf733420bbab134b74c7d0ea5d.asciidoc

@@ -0,0 +1,16 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.index({
+  index: "amazon-reviews",
+  id: 1,
+  document: {
+    review_text:
+      "This product is lifechanging! I'm telling all my friends about it.",
+    review_vector: [0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8],
+  },
+});
+console.log(response);
+----

docs/doc_examples/43d9e314431336a6f084cea76dfd6489.asciidoc

@@ -0,0 +1,18 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "restaurants",
+  retriever: {
+    knn: {
+      field: "vector",
+      query_vector: [10, 22, 77],
+      k: 10,
+      num_candidates: 10,
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/44198781d164a15be633d4469485a544.asciidoc

@@ -0,0 +1,23 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "my-index-bit-vectors",
+  query: {
+    script_score: {
+      query: {
+        match_all: {},
+      },
+      script: {
+        source: "dotProduct(params.query_vector, 'my_dense_vector')",
+        params: {
+          query_vector: [8, 5, -15, 1, -7],
+        },
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/48e142e6c69014e0509d4c9251749d77.asciidoc

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

docs/doc_examples/49a19615ebe2c013b8321152163478ab.asciidoc

@@ -0,0 +1,42 @@
+// 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: 1,
+  refresh: "true",
+  document: {
+    text: "quick brown fox",
+  },
+});
+console.log(response);
+
+const response1 = await client.index({
+  index: "my-index-000001",
+  id: 2,
+  refresh: "true",
+  document: {
+    text: "quick fox",
+  },
+});
+console.log(response1);
+
+const response2 = await client.search({
+  index: "my-index-000001",
+  query: {
+    script_score: {
+      query: {
+        match: {
+          text: "quick brown fox",
+        },
+      },
+      script: {
+        source: "_termStats.termFreq().getAverage()",
+      },
+    },
+  },
+});
+console.log(response2);
+----

docs/doc_examples/49b31e23f8b9667b6a7b2734d55fb6ed.asciidoc

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

docs/doc_examples/4a72c68b96f44e80463084dfc0449d51.asciidoc

@@ -10,7 +10,7 @@ const response = await client.search({
       type: "keyword",
       script: {
         source:
-          "emit(doc['@timestamp'].value.dayOfWeekEnum.getDisplayName(TextStyle.FULL, Locale.ROOT))",
+          "emit(doc['@timestamp'].value.dayOfWeekEnum.getDisplayName(TextStyle.FULL, Locale.ENGLISH))",
       },
     },
   },

docs/doc_examples/4b91ad7c9b44e07db4a4e81390f19ad3.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.inference.streamInference({
+  task_type: "completion",
+  inference_id: "openai-completion",
+  body: {
+    input: "What is Elastic?",
+  },
+});
+console.log(response);
+----

docs/doc_examples/4da0cb8693e9ceceee2ba3b558014bbf.asciidoc

@@ -0,0 +1,38 @@
+// 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.updateByQuery({
+  index: "INDEX_NAME",
+  conflicts: "proceed",
+  query: {
+    bool: {
+      filter: [
+        {
+          match: {
+            object_type: "drive_item",
+          },
+        },
+        {
+          exists: {
+            field: "file",
+          },
+        },
+        {
+          range: {
+            lastModifiedDateTime: {
+              lte: "now-180d",
+            },
+          },
+        },
+      ],
+    },
+  },
+  script: {
+    source: "ctx._source.body = ''",
+    lang: "painless",
+  },
+});
+console.log(response);
+----

docs/doc_examples/4dc151eebefd484a28aed1a175743364.asciidoc

@@ -4,7 +4,7 @@
 [source, js]
 ----
 const response = await client.ingest.putPipeline({
-  id: "openai_embeddings",
+  id: "openai_embeddings_pipeline",
   processors: [
     {
       inference: {

docs/doc_examples/4edfb5934d14ad7655bd7e19a112b5c0.asciidoc

@@ -0,0 +1,55 @@
+// 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: "cooking_blog",
+  query: {
+    bool: {
+      must: [
+        {
+          term: {
+            tags: "vegetarian",
+          },
+        },
+        {
+          range: {
+            rating: {
+              gte: 4.5,
+            },
+          },
+        },
+      ],
+      should: [
+        {
+          term: {
+            category: "Main Course",
+          },
+        },
+        {
+          multi_match: {
+            query: "curry spicy",
+            fields: ["title^2", "description"],
+          },
+        },
+        {
+          range: {
+            date: {
+              gte: "now-1M/d",
+            },
+          },
+        },
+      ],
+      must_not: [
+        {
+          term: {
+            "category.keyword": "Dessert",
+          },
+        },
+      ],
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/4eeded40f30949e359714a5bb6c88612.asciidoc

@@ -11,7 +11,7 @@ const response = await client.reindex({
   },
   dest: {
     index: "elser-embeddings",
-    pipeline: "elser_embeddings",
+    pipeline: "elser_embeddings_pipeline",
   },
 });
 console.log(response);

docs/doc_examples/4f6694ef147a73b1163bde3c13779d26.asciidoc

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

docs/doc_examples/529671ffaf7cc75fe83a81d729788be4.asciidoc

@@ -0,0 +1,31 @@
+// 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.update({
+  index: ".elastic-connectors",
+  id: "connector_id",
+  doc: {
+    configuration: {
+      field_a: {
+        type: "str",
+        value: "",
+      },
+      field_b: {
+        type: "bool",
+        value: false,
+      },
+      field_c: {
+        type: "int",
+        value: 1,
+      },
+      field_d: {
+        type: "list",
+        value: "a,b",
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/533087d787b48878a0bf3fa8d0851b64.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.transport.request({
-  method: "DELETE",
-  path: "/_ingest/geoip/database/example-database-id",
-});
-console.log(response);
-----

docs/doc_examples/53d9d2ec9cb8d211772d764e76fe6890.asciidoc

@@ -0,0 +1,18 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.ingest.simulate({
+  id: "query_helper_pipeline",
+  docs: [
+    {
+      _source: {
+        content:
+          "artificial intelligence in medicine articles published in the last 12 months",
+      },
+    },
+  ],
+});
+console.log(response);
+----

docs/doc_examples/548a9b6f447bb820380c1c23e57c18c3.asciidoc

@@ -4,7 +4,7 @@
 [source, js]
 ----
 const response = await client.ingest.putPipeline({
-  id: "cohere_embeddings",
+  id: "cohere_embeddings_pipeline",
   processors: [
     {
       inference: {

docs/doc_examples/54a47b5d07e7bfbea75c77f35eaae18d.asciidoc

@@ -0,0 +1,15 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.indices.putMapping({
+  index: ".elastic-connectors-sync-jobs-v1",
+  properties: {
+    job_type: {
+      type: "keyword",
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/55085e6a2891040b6ac696561d0787c8.asciidoc

@@ -0,0 +1,32 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.indices.create({
+  index: "my-index-000002",
+  mappings: {
+    properties: {
+      attributes: {
+        type: "passthrough",
+        priority: 10,
+        properties: {
+          id: {
+            type: "keyword",
+          },
+        },
+      },
+      "resource.attributes": {
+        type: "passthrough",
+        priority: 20,
+        properties: {
+          id: {
+            type: "keyword",
+          },
+        },
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/551467688d8c701315d0a371850a4056.asciidoc

@@ -11,7 +11,7 @@ const response = await client.reindex({
   },
   dest: {
     index: "hugging-face-embeddings",
-    pipeline: "hugging_face_embeddings",
+    pipeline: "hugging_face_embeddings_pipeline",
   },
 });
 console.log(response);

docs/doc_examples/551799fef2f86e393db83a967e4a30d1.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       agg_metric: {
         type: "aggregate_metric_double",

docs/doc_examples/565386eee0951865a684e41fab53b40c.asciidoc

@@ -14,6 +14,7 @@ const response = await client.inference.put({
         min_number_of_allocations: 3,
         max_number_of_allocations: 10,
       },
+      num_threads: 1,
     },
   },
 });

docs/doc_examples/56da252798b8e7b006738428aa1a7f4c.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       my_range: {
         type: "long_range",

docs/doc_examples/58dd26afc919722e21358c91e112b27a.asciidoc

@@ -0,0 +1,18 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "cooking_blog",
+  query: {
+    range: {
+      date: {
+        gte: "2023-05-01",
+        lte: "2023-05-31",
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/5bba213a7f543190139d1a69ab2ed076.asciidoc

@@ -0,0 +1,15 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.esql.asyncQuery({
+  format: "json",
+  body: {
+    query:
+      "\n    FROM cluster_one:my-index*,cluster_two:logs*\n    | STATS COUNT(http.response.status_code) BY user.id\n    | LIMIT 2\n  ",
+    include_ccs_metadata: true,
+  },
+});
+console.log(response);
+----

docs/doc_examples/5ceb734e3affe00e2cdc29af748d95bf.asciidoc

@@ -0,0 +1,23 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.inference.put({
+  task_type: "sparse_embedding",
+  inference_id: "small_chunk_size",
+  inference_config: {
+    service: "elasticsearch",
+    service_settings: {
+      num_allocations: 1,
+      num_threads: 1,
+    },
+    chunking_settings: {
+      strategy: "sentence",
+      max_chunk_size: 100,
+      sentence_overlap: 0,
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/5cf12cc4f98d98dc79bead7e6556679c.asciidoc

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

docs/doc_examples/5daf8ede198be9b118da5bee9896cb00.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       flattened: {
         type: "flattened",

docs/doc_examples/5e021307d331a4483a5aa2198168451b.asciidoc

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

docs/doc_examples/5f16358ebb5d14b86f57612d5f92d923.asciidoc

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

docs/doc_examples/60d3f9a99cc91b43aaa7524a9a74dba0.asciidoc

@@ -0,0 +1,10 @@
+// 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.nodes.stats({
+  metric: "breaker",
+});
+console.log(response);
+----

docs/doc_examples/6329fb2840a4373ff6d342f2653247cb.asciidoc

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

docs/doc_examples/63a53fcb0717ae9033a679cbfc932851.asciidoc

@@ -0,0 +1,20 @@
+// 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: "completion",
+  inference_id: "alibabacloud_ai_search_completion",
+  inference_config: {
+    service: "alibabacloud-ai-search",
+    service_settings: {
+      host: "default-j01.platform-cn-shanghai.opensearch.aliyuncs.com",
+      api_key: "{{API_KEY}}",
+      service_id: "ops-qwen-turbo",
+      workspace: "default",
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/640dbeecb736bd25f6f2b392b76a7531.asciidoc

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

docs/doc_examples/68d7f7d4d268ee98caead5aef19933d6.asciidoc

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

docs/doc_examples/69541f0bb81ab3797926bb2a00607cda.asciidoc

@@ -0,0 +1,19 @@
+// 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-msmarco-minilm-model",
+  inference_config: {
+    service: "elasticsearch",
+    service_settings: {
+      num_allocations: 1,
+      num_threads: 1,
+      model_id: "cross-encoder__ms-marco-minilm-l-6-v2",
+    },
+  },
+});
+console.log(response);
+----