adding query for a search api v2; refactoring request code

Author: AleksandrRogov

.github/README.md

@@ -347,7 +347,7 @@ Property Name | Type | Operation(s) Supported | Description
 action | `Object` | `callAction` | A JavaScript object that represents a Dynamics 365 Web API action.
 actionName | `string` | `callAction` | Web API Action name.
 addAnnotations | `boolean` | `retrieveCsdlMetadata` | If set to `true` the document will include many different kinds of annotations that can be useful. Most annotations are not included by default because they increase the total size of the document.
-apply | `string` | `retrieveMultiple`, `retrieveAll` | Sets the $apply system query option to aggregate and group your data dynamically. [More Info](https://docs.microsoft.com/en-us/powerapps/developer/common-data-service/webapi/query-data-web-api#aggregate-and-grouping-results)
+apply | `string` | `retrieveMultiple`, `retrieveAll` | Sets the $apply system query option to aggregate and group your data dynamically. [More Info](https://learn.microsoft.com/en-us/power-apps/developer/data-platform/webapi/query/aggregate-data)
 async | `boolean` | All | **XHR requests only!** Indicates whether the requests should be made synchronously or asynchronously. Default value is `true` (asynchronously).
 bypassCustomPluginExecution | `boolean` | `create`, `update`, `upsert`, `delete` | If set to true, the request bypasses custom business logic, all synchronous plug-ins and real-time workflows are disabled. Check for special exceptions in Microsft Docs. [More Info](https://docs.microsoft.com/en-us/powerapps/developer/data-platform/bypass-custom-business-logic)
 collection | `string` | All | Entity Collection name.

dist/browser/esm/dynamics-web-api.js

@@ -797,30 +797,66 @@ export interface CsdlMetadataRequest extends BaseRequest {
 }
 export type SearchMode = "any" | "all";
 export type SearchType = "simple" | "full";
+export type SearchEntity = {
+    /**Logical name of the table. Specifies scope of the query. */
+    name: string;
+    /**List of columns that needs to be projected when table documents are returned in response. If empty, only the table primary name is returned. */
+    selectColumns?: string[];
+    /**List of columns to scope the query on. If empty, only the table primary name is searched on.*/
+    searchColumns?: string[];
+    /**Filters applied on the entity.*/
+    filter?: string;
+};
+export type SearchOptions = {
+    /**Values can be simple or lucene. */
+    querytype?: "simple" | "lucene";
+    /**Enables intelligent query workflow to return probable set of results if no good matches are found for the search request terms.*/
+    besteffortsearchenabled?: boolean;
+    /**Enable ranking of results in the response optimized for display in search results pages where results are grouped by table.*/
+    searchmode?: SearchMode;
+    /**When specified as all the search terms must be matched in order to consider the document as a match. Setting its value to any defaults to matching any word in the search term.*/
+    grouprankingenabled?: boolean;
+};
 export interface SearchQueryBase {
     /**The search parameter value contains the term to be searched for and has a 100-character limit. For suggestions, min 3 characters in addition. */
     search: string;
     /**The default table list searches across all Dataverse search–configured tables and columns. The default list is configured by your administrator when Dataverse search is enabled. */
-    entities?: string[];
+    entities?: string[] | SearchEntity[];
     /**Filters are applied while searching data and are specified in standard OData syntax. */
     filter?: string;
 }
-export interface Search extends SearchQueryBase {
+export interface Query extends SearchQueryBase {
+    /**V2. Whether to return the total record count.*/
+    count?: boolean;
     /**Facets support the ability to drill down into data results after they've been retrieved. */
     facets?: string[];
-    /**Specify true to return the total record count; otherwise false. The default is false. */
+    /**
+     * Specify true to return the total record count; otherwise false. The default is false.
+     * @deprecated Use "count".
+     */
     returnTotalRecordCount?: boolean;
     /**Specifies the number of search results to skip. */
     skip?: number;
     /**Specifies the number of search results to retrieve. The default is 50, and the maximum value is 100. */
     top?: number;
     /**A list of comma-separated clauses where each clause consists of a column name followed by 'asc' (ascending, which is the default) or 'desc' (descending). This list specifies how to order the results in order of precedence. */
     orderBy?: string[];
-    /**Specifies whether any or all the search terms must be matched to count the document as a match. The default is 'any'. */
+    /**V2. Options are settings configured to search a search term. */
+    options?: SearchOptions[];
+    /**
+     * Specifies whether any or all the search terms must be matched to count the document as a match. The default is 'any'.
+     * @deprecated Use "options.searchmode".
+     */
     searchMode?: SearchMode;
-    /**The search type specifies the syntax of a search query. Using 'simple' selects simple query syntax and 'full' selects Lucene query syntax. The default is 'simple'. */
+    /**
+     * For V2, use "options.querytype". The search type specifies the syntax of a search query. Using 'simple' selects simple query syntax and 'full' selects Lucene query syntax. The default is 'simple'.
+     * @deprecated Use "options.querytype".
+     */
     searchType?: SearchType;
 }
+/**@deprecated Use Query instead */
+export interface Search extends Query {
+}
 export interface Suggest extends SearchQueryBase {
     /**Use fuzzy search to aid with misspellings. The default is false. */
     useFuzzy?: boolean;
@@ -833,9 +869,12 @@ export interface Autocomplete extends SearchQueryBase {
     /**Use fuzzy search to aid with misspellings. The default is false. */
     useFuzzy?: boolean;
 }
-export interface SearchRequest extends BaseRequest {
+export interface QueryRequest extends BaseRequest {
     /**Search query object */
-    query: Search;
+    query: Query;
+}
+/**@deprecated Use QueryRequest instead. */
+export interface SearchRequest extends QueryRequest {
 }
 export interface SuggestRequest extends BaseRequest {
     /**Suggestion query object */
@@ -1053,7 +1092,7 @@ type SearchFunction = {
      * @param request - An object that represents all possible options for a current request.
      * @returns {Promise<SearchResponse<TValue>>} Search result
      */
-    <TValue = any>(request: SearchRequest): Promise<SearchResponse<TValue>>;
+    <TValue = any>(request: QueryRequest): Promise<SearchResponse<TValue>>;
 };
 type SuggestFunction = {
     /**