[Search] Fix documentation for preview client (#29598)

sdk/search/search-documents/README.md

@@ -4,30 +4,30 @@
 
 The Azure AI Search service is well suited for the following application scenarios:
 
-* Consolidate varied content types into a single searchable index.
+- Consolidate varied content types into a single searchable index.
   To populate an index, you can push JSON documents that contain your content,
   or if your data is already in Azure, create an indexer to pull in data
   automatically.
-* Attach skillsets to an indexer to create searchable content from images
+- Attach skillsets to an indexer to create searchable content from images
   and unstructured documents. A skillset leverages APIs from Azure AI Services
   for built-in OCR, entity recognition, key phrase extraction, language
   detection, text translation, and sentiment analysis. You can also add
   custom skills to integrate external processing of your content during
   data ingestion.
-* In a search client application, implement query logic and user experiences
+- In a search client application, implement query logic and user experiences
   similar to commercial web search engines and chat-style apps.
 
 Use the @azure/search-documents client library to:
 
-* Submit queries using vector, keyword, and hybrid query forms.
-* Implement filtered queries for metadata, geospatial search, faceted navigation, 
+- Submit queries using vector, keyword, and hybrid query forms.
+- Implement filtered queries for metadata, geospatial search, faceted navigation,
   or to narrow results based on filter criteria.
-* Create and manage search indexes.
-* Upload and update documents in the search index.
-* Create and manage indexers that pull data from Azure into an index.
-* Create and manage skillsets that add AI enrichment to data ingestion.
-* Create and manage analyzers for advanced text analysis or multi-lingual content.
-* Optimize results through semantic ranking and scoring profiles to factor in business logic or freshness.
+- Create and manage search indexes.
+- Upload and update documents in the search index.
+- Create and manage indexers that pull data from Azure into an index.
+- Create and manage skillsets that add AI enrichment to data ingestion.
+- Create and manage analyzers for advanced text analysis or multi-lingual content.
+- Optimize results through semantic ranking and scoring profiles to factor in business logic or freshness.
 
 Key links:
 
@@ -152,6 +152,7 @@ An Azure AI Search service contains one or more indexes that provide persistent
 exposes operations on these resources through three main client types.
 
 - `SearchClient` helps with:
+
   - [Searching](https://docs.microsoft.com/azure/search/search-lucene-query-architecture)
     your indexed documents using [vector queries](https://learn.microsoft.com/azure/search/vector-search-how-to-query),
     [keyword queries](https://learn.microsoft.com/azure/search/search-query-create)
@@ -163,6 +164,7 @@ exposes operations on these resources through three main client types.
   - [Adding, Updating or Deleting Documents](https://docs.microsoft.com/rest/api/searchservice/addupdate-or-delete-documents) documents from an index
 
 - `SearchIndexClient` allows you to:
+
   - [Create, delete, update, or configure a search index](https://docs.microsoft.com/rest/api/searchservice/index-operations)
   - [Declare custom synonym maps to expand or rewrite queries](https://docs.microsoft.com/rest/api/searchservice/synonym-map-operations)
 
@@ -176,7 +178,7 @@ exposes operations on these resources through three main client types.
 
 ### Documents
 
-An item stored inside a search index. The shape of this document is described in the index using `Field`s. Each Field has a name, a datatype, and additional metadata such as if it is searchable or filterable.
+An item stored inside a search index. The shape of this document is described in the index using the `fields` property. Each `SearchField` has a name, a datatype, and additional metadata such as if it is searchable or filterable.
 
 ### Pagination
 
@@ -423,17 +425,26 @@ main();
 Text embeddings can be queried using the `vector` search parameter. See [Query vectors](https://learn.microsoft.com/azure/search/vector-search-how-to-query) and [Filter vector queries](https://learn.microsoft.com/azure/search/vector-search-filters) for more information.
 
 ```js
-const { SearchClient, AzureKeyCredential, odata } = require("@azure/search-documents");
+const { SearchClient, AzureKeyCredential } = require("@azure/search-documents");
 
-const searchClient = new SearchClient("<endpoint>", "<indexName>", new AzureKeyCredential("<apiKey>"));
+const searchClient = new SearchClient(
+  "<endpoint>",
+  "<indexName>",
+  new AzureKeyCredential("<apiKey>")
+);
 
 async function main() {
-  const queryVector = [...]
+  const queryVector = [...];
   const searchResults = await searchClient.search("*", {
-    vector: {
-      fields: ["descriptionVector"],
-      kNearestNeighborsCount: 3,
-      value: queryVector,
+    vectorSearchOptions: {
+      queries: [
+        {
+          kind: "vector",
+          vector: queryVector,
+          fields: ["descriptionVector"],
+          kNearestNeighborsCount: 3,
+        },
+      ],
     },
   });
   for await (const result of searchResults.results) {

sdk/search/search-documents/samples/v12-beta/typescript/src/bufferedSenderAutoFlushSize.ts

@@ -6,11 +6,11 @@
  */
 
 import {
-  AzureKeyCredential,
-  GeographyPoint,
-  SearchClient,
-  SearchIndexClient,
-  SearchIndexingBufferedSender,
+    AzureKeyCredential,
+    GeographyPoint,
+    SearchClient,
+    SearchIndexClient,
+    SearchIndexingBufferedSender
 } from "@azure/search-documents";
 import { Hotel } from "./interfaces";
 import { createIndex, delay, documentKeyRetriever, WAIT_TIME } from "./setup";

sdk/search/search-documents/samples/v12-beta/typescript/src/bufferedSenderAutoFlushTimer.ts

@@ -6,12 +6,12 @@
  */
 
 import {
-  AzureKeyCredential,
-  DEFAULT_FLUSH_WINDOW,
-  GeographyPoint,
-  SearchClient,
-  SearchIndexClient,
-  SearchIndexingBufferedSender,
+    AzureKeyCredential,
+    DEFAULT_FLUSH_WINDOW,
+    GeographyPoint,
+    SearchClient,
+    SearchIndexClient,
+    SearchIndexingBufferedSender
 } from "@azure/search-documents";
 import { Hotel } from "./interfaces";
 import { createIndex, delay, documentKeyRetriever, WAIT_TIME } from "./setup";

sdk/search/search-documents/samples/v12-beta/typescript/src/bufferedSenderManualFlush.ts

@@ -6,11 +6,11 @@
  */
 
 import {
-  AzureKeyCredential,
-  GeographyPoint,
-  SearchClient,
-  SearchIndexClient,
-  SearchIndexingBufferedSender,
+    AzureKeyCredential,
+    GeographyPoint,
+    SearchClient,
+    SearchIndexClient,
+    SearchIndexingBufferedSender
 } from "@azure/search-documents";
 import { Hotel } from "./interfaces";
 import { createIndex, delay, documentKeyRetriever, WAIT_TIME } from "./setup";

sdk/search/search-documents/samples/v12-beta/typescript/src/dataSourceConnectionOperations.ts

@@ -6,9 +6,9 @@
  */
 
 import {
-  AzureKeyCredential,
-  SearchIndexerClient,
-  SearchIndexerDataSourceConnection,
+    AzureKeyCredential,
+    SearchIndexerClient,
+    SearchIndexerDataSourceConnection
 } from "@azure/search-documents";
 
 import * as dotenv from "dotenv";

sdk/search/search-documents/samples/v12-beta/typescript/src/indexOperations.ts

@@ -6,10 +6,10 @@
  */
 
 import {
-  AzureKeyCredential,
-  SearchIndex,
-  SearchIndexClient,
-  SearchIndexStatistics,
+    AzureKeyCredential,
+    SearchIndex,
+    SearchIndexClient,
+    SearchIndexStatistics
 } from "@azure/search-documents";
 
 import * as dotenv from "dotenv";

sdk/search/search-documents/samples/v12-beta/typescript/src/indexerOperations.ts

@@ -6,10 +6,10 @@
  */
 
 import {
-  AzureKeyCredential,
-  SearchIndexer,
-  SearchIndexerClient,
-  SearchIndexerStatus,
+    AzureKeyCredential,
+    SearchIndexer,
+    SearchIndexerClient,
+    SearchIndexerStatus
 } from "@azure/search-documents";
 
 import * as dotenv from "dotenv";

sdk/search/search-documents/samples/v12-beta/typescript/src/searchClientOperations.ts

@@ -6,11 +6,11 @@
  */
 
 import {
-  AzureKeyCredential,
-  GeographyPoint,
-  SearchClient,
-  SearchIndexClient,
-  SelectFields,
+    AzureKeyCredential,
+    GeographyPoint,
+    SearchClient,
+    SearchIndexClient,
+    SelectFields
 } from "@azure/search-documents";
 import { Hotel } from "./interfaces";
 import { createIndex, delay, WAIT_TIME } from "./setup";

sdk/search/search-documents/samples/v12-beta/typescript/src/skillSetOperations.ts

@@ -6,9 +6,9 @@
  */
 
 import {
-  AzureKeyCredential,
-  SearchIndexerClient,
-  SearchIndexerSkillset,
+    AzureKeyCredential,
+    SearchIndexerClient,
+    SearchIndexerSkillset
 } from "@azure/search-documents";
 
 import * as dotenv from "dotenv";

sdk/search/search-documents/samples/v12-beta/typescript/src/stickySession.ts

@@ -7,10 +7,10 @@
  */
 
 import {
-  AzureKeyCredential,
-  odata,
-  SearchClient,
-  SearchIndexClient,
+    AzureKeyCredential,
+    odata,
+    SearchClient,
+    SearchIndexClient
 } from "@azure/search-documents";
 import { Hotel } from "./interfaces";
 import { createIndex, delay, WAIT_TIME } from "./setup";

sdk/search/search-documents/samples/v12-beta/typescript/src/vectorSearch.ts

@@ -6,10 +6,10 @@
  */
 
 import {
-  AzureKeyCredential,
-  GeographyPoint,
-  SearchClient,
-  SearchIndexClient,
+    AzureKeyCredential,
+    GeographyPoint,
+    SearchClient,
+    SearchIndexClient
 } from "@azure/search-documents";
 import { Hotel } from "./interfaces";
 import { createIndex, delay, WAIT_TIME } from "./setup";

sdk/search/search-documents/test/public/node/searchClient.spec.ts

@@ -5,8 +5,8 @@ import { env, isLiveMode, Recorder } from "@azure-tools/test-recorder";
 import { assert } from "chai";
 import { Context, Suite } from "mocha";
 
-import { OpenAIClient } from "@azure/openai";
 import { versionsToTest } from "@azure-tools/test-utils";
+import { OpenAIClient } from "@azure/openai";
 import {
   AutocompleteResult,
   AzureKeyCredential,