Backport #2540 to 8.16 (#2542)

(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

@@ -12,6 +12,8 @@ jobs:
       src-only: "${{ steps.changes.outputs.src-only }}"
     steps:
       - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
       - uses: dorny/paths-filter/@v3.0.2
         id: changes
         with:
@@ -30,11 +32,13 @@ 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
+        with:
+          persist-credentials: false
 
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
@@ -53,12 +57,18 @@ jobs:
         run: |
           npm run test:unit
 
+      - name: ECMAScript module test
+        run: |
+          npm run test:esm
+
   license:
     name: License check
     runs-on: ubuntu-latest
 
     steps:
       - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
 
       - name: Use Node.js
         uses: actions/setup-node@v4
@@ -87,6 +97,8 @@ jobs:
 
     steps:
       - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
 
       - name: Use Bun
         uses: oven-sh/setup-bun@v2
@@ -103,6 +115,10 @@ jobs:
         run: |
           bun run test:unit-bun
 
+      - name: ECMAScript module test
+        run: |
+          bun run test:esm
+
   auto-approve:
     name: Auto-approve
     needs: [test, license]

.github/workflows/npm-publish.yml

@@ -14,6 +14,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
         with:
+          persist-credentials: false
           ref: ${{ github.event.inputs.branch }}
       - uses: actions/setup-node@v4
         with:

.github/workflows/serverless-patch.yml

@@ -28,12 +28,14 @@ jobs:
     steps:
       - uses: actions/checkout@v4
         with:
+          persist-credentials: false
           repository: elastic/elasticsearch-js
           ref: main
           path: stack
           fetch-depth: 0
       - uses: actions/checkout@v4
         with:
+          persist-credentials: false
           repository: elastic/elasticsearch-serverless-js
           ref: main
           path: serverless
@@ -44,8 +46,8 @@ jobs:
         with:
           token: ${{ secrets.GH_TOKEN }}
           path: serverless
-          title: 'Apply patch from elastic/elasticsearch-js#${{ github.event.pull_request.number }}'
-          commit-message: 'Apply patch from elastic/elasticsearch-js#${{ github.event.pull_request.number }}'
+          title: "Apply patch from elastic/elasticsearch-js#${{ github.event.pull_request.number }}"
+          commit-message: "Apply patch from elastic/elasticsearch-js#${{ github.event.pull_request.number }}"
           body-path: /tmp/pr_body
-          draft: '${{ steps.apply-patch.outputs.PR_DRAFT }}'
-          add-paths: ':!*.rej'
+          draft: "${{ steps.apply-patch.outputs.PR_DRAFT }}"
+          add-paths: ":!*.rej"

.gitignore

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

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

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

docs/connecting.asciidoc

@@ -349,7 +349,7 @@ In this case, the result will be:
   body: object | boolean
   statusCode: number
   headers: object
-  warnings: [string],
+  warnings: string[],
   meta: object
 }
 ----
@@ -410,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]

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,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.transport.request({
+  method: "POST",
+  path: "/_query/async",
+  querystring: {
+    format: "json",
+  },
+  body: {
+    query:
+      "\n    FROM my-index-000001,cluster_one:my-index-000001,cluster_two:my-index*\n    | STATS COUNT(http.response.status_code) BY user.id\n    | LIMIT 2\n  ",
+    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/0dfde6a9d953822fd4b3aa0121ddd8fb.asciidoc

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

docs/doc_examples/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

@@ -0,0 +1,15 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.transport.request({
+  method: "GET",
+  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/16634cfa7916cf4e8048a1d70e6240f2.asciidoc

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

docs/doc_examples/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/19c00c6b29bc7dbc5e92b3668da2da93.asciidoc

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

docs/doc_examples/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/2a1eece9a59ac1773edcf0a932c26de0.asciidoc

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

docs/doc_examples/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/2afdf0d83724953aa2875b5fb37d60cc.asciidoc

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

docs/doc_examples/2bb41b0b4876ce98cd0cd8fb6d337f18.asciidoc

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

docs/doc_examples/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/3f1fe5f5f99b98d0891f38003e10b636.asciidoc

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

docs/doc_examples/405511f7c1f12cc0a227b4563fe7b2e2.asciidoc

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

docs/doc_examples/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.transport.request({
+  method: "POST",
+  path: "/_inference/completion/openai-completion/_stream",
+  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/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/57dc15e5ad663c342fd5c1d86fcd1b29.asciidoc

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

docs/doc_examples/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,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.transport.request({
+  method: "POST",
+  path: "/_query/async",
+  querystring: {
+    format: "json",
+  },
+  body: {
+    query:
+      "\n    FROM cluster_one:my-index*,cluster_two:logs*\n    | STATS COUNT(http.response.status_code) BY user.id\n    | LIMIT 2\n  ",
+    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);
+----