Merged PR 177491: [JS SDK simplify functions]: Add orderByTarget for TopNFilterBuilder and rename resizePage to resizeActivePage

**This PR adds the following features in JS SDK:**
1. Rename resizePage to resizeActivePage at report level
2. Add orderByTarget method that receives a target so the user can provide a target object, and add the capability to support aggregation targets
3. Removed withTarget method

**Checklist**
- [X] Build and test scripts are passing, if available
- [X] Open errors/warning details are shared with the reviewer
- [X] There are no violations to the applicable coding guidelines
- [X] Application has a consistent exception management setup
- [X] Code does not contain commented code
- [X] Is testing performed and results captured in ADO and list of test cases executed shared in PR?
- [X] Generic exception type is not handled
- [X] Stacktrace of error is not returned
- [X] All external packages/libraries are installed from an online package manager

Related work items: #600574

Author: Anchal Gupta

dist/powerbi-client.d.ts

@@ -1493,7 +1493,7 @@ declare module "report" {
          * Updates the size of active page in report.
          *
          * ```javascript
-         * report.resizePage(pageSizeType, width, height)
+         * report.resizeActivePage(pageSizeType, width, height)
          *   .catch(error => { ... });
          * ```
          *
@@ -1502,7 +1502,7 @@ declare module "report" {
          * @param {number} height
          * @returns {Promise<IHttpPostMessageResponse<void>>}
          */
-        resizePage(pageSizeType: PageSizeType, width?: number, height?: number): Promise<IHttpPostMessageResponse<void>>;
+        resizeActivePage(pageSizeType: PageSizeType, width?: number, height?: number): Promise<IHttpPostMessageResponse<void>>;
         /**
          * Updates the position of a visual in a page.
          *
@@ -2290,14 +2290,14 @@ declare module "factories" {
     export const routerFactory: IRouterFactory;
 }
 declare module "FilterBuilders/filterBuilder" {
-    import { Filter } from "powerbi-models";
+    import { Filter, IFilterTarget } from "powerbi-models";
     /**
      * Generic filter builder for BasicFilter, AdvancedFilter, RelativeDate, RelativeTime and TopN
      *
      * @interface IFilterBuilder
      */
     export interface IFilterBuilder {
-        withTarget(table: string, column: string): IFilterBuilder;
+        withTargetObject(target: IFilterTarget): IFilterBuilder;
         build(): Filter;
     }
 }
@@ -2316,17 +2316,6 @@ declare module "FilterBuilders/basicFilterBuilder" {
         private values;
         private operator;
         private isRequireSingleSelection;
-        /**
-         * Sets target property for Basic filter
-         *
-         * ```javascript
-         *
-         * const basicFilterBuilder = new BasicFilterBuilder().withTarget(tableName, columnName);
-         * ```
-         *
-         * @returns {BasicFilterBuilder}
-         */
-        withTarget(table: string, column: string): BasicFilterBuilder;
         /**
          * Sets target property for Basic filter with target object
          *
@@ -2413,17 +2402,6 @@ declare module "FilterBuilders/advancedFilterBuilder" {
         private target;
         private logicalOperator;
         private conditions;
-        /**
-         * Sets target property for Advanced filter
-         *
-         * ```javascript
-         *
-         * const advancedFilterBuilder = new AdvancedFilterBuilder().withTarget(tableName, columnName);
-         * ```
-         *
-         * @returns {AdvancedFilterBuilder}
-         */
-        withTarget(table: string, column: string): AdvancedFilterBuilder;
         /**
          * Sets target property for Advanced filter with target object
          *
@@ -2487,7 +2465,7 @@ declare module "FilterBuilders/advancedFilterBuilder" {
     }
 }
 declare module "FilterBuilders/topNFilterBuilder" {
-    import { IFilterTarget, TopNFilter } from "powerbi-models";
+    import { IFilterTarget, ITarget, TopNFilter } from "powerbi-models";
     import { IFilterBuilder } from "FilterBuilders/filterBuilder";
     /**
      * Power BI Top N filter builder component
@@ -2500,18 +2478,7 @@ declare module "FilterBuilders/topNFilterBuilder" {
         private target;
         private itemCount;
         private operator;
-        private orderByTarget;
-        /**
-         * Sets target property for Top N filter
-         *
-         * ```javascript
-         *
-         * const topNFilterBuilder = new TopNFilterBuilder().withTarget(tableName, columnName);
-         * ```
-         *
-         * @returns {TopNFilterBuilder}
-         */
-        withTarget(table: string, column: string): TopNFilterBuilder;
+        private orderByTargetValue;
         /**
          * Sets target property for Top N filter with target object
          *
@@ -2554,12 +2521,12 @@ declare module "FilterBuilders/topNFilterBuilder" {
          *
          * ```javascript
          *
-         * const topNFilterBuilder = new TopNFilterBuilder().orderBy(table, measure);
+         * const topNFilterBuilder = new TopNFilterBuilder().orderByTarget(target);
          * ```
          *
          * @returns {TopNFilterBuilder}
          */
-        orderBy(table: string, measure: string): TopNFilterBuilder;
+        orderByTarget(target: ITarget): TopNFilterBuilder;
         /**
          * Creates Top N filter
          *
@@ -2589,19 +2556,6 @@ declare module "FilterBuilders/relativeDateFilterBuilder" {
         private timeUnitsCount;
         private timeUnitType;
         private isTodayIncluded;
-        /**
-         * Sets target property for Relative Date filter
-         *
-         * ```javascript
-         *
-         * const relativeDateFilterBuilder = new RelativeDateFilterBuilder().withTarget(tableName, columnName);
-         * ```
-         *
-         * @param {string} table - Defines the table on which filter will be applied
-         * @param {string} column - Defines the column on which filter will be applied
-         * @returns {RelativeDateFilterBuilder}
-         */
-        withTarget(table: string, column: string): RelativeDateFilterBuilder;
         /**
          * Sets target property for Relative Date filter with target object
          *
@@ -2649,7 +2603,7 @@ declare module "FilterBuilders/relativeDateFilterBuilder" {
          *
          * ```javascript
          *
-         * const relativeDateFilterBuilder = new RelativeDateFilterBuilder().orderBy(timeUnitsCount, timeUnitType);
+         * const relativeDateFilterBuilder = new RelativeDateFilterBuilder().inNext(timeUnitsCount, timeUnitType);
          * ```
          *
          * @param {number} timeUnitsCount - The amount of time units
@@ -2697,19 +2651,6 @@ declare module "FilterBuilders/relativeTimeFilterBuilder" {
         private operator;
         private timeUnitsCount;
         private timeUnitType;
-        /**
-         * Sets target property for Relative Time filter
-         *
-         * ```javascript
-         *
-         * const relativeTimeFilterBuilder = new RelativeTimeFilterBuilder().withTarget(tableName, columnName);
-         * ```
-         *
-         * @param {string} table - Defines the table on which filter will be applied
-         * @param {string} column - Defines the column on which filter will be applied
-         * @returns {RelativeTimeFilterBuilder}
-         */
-        withTarget(table: string, column: string): RelativeTimeFilterBuilder;
         /**
          * Sets target property for Relative Time filter with target object
          *
@@ -2757,7 +2698,7 @@ declare module "FilterBuilders/relativeTimeFilterBuilder" {
          *
          * ```javascript
          *
-         * const relativeTimeFilterBuilder = new RelativeTimeFilterBuilder().orderBy(timeUnitsCount, timeUnitType);
+         * const relativeTimeFilterBuilder = new RelativeTimeFilterBuilder().inNext(timeUnitsCount, timeUnitType);
          * ```
          *
          * @param {number} timeUnitsCount - The amount of time units

dist/powerbi.js

@@ -23,21 +23,6 @@ export class AdvancedFilterBuilder implements IFilterBuilder {
   private logicalOperator: AdvancedFilterLogicalOperators;
   private conditions: IAdvancedFilterCondition[] = [];
 
-  /**
-   * Sets target property for Advanced filter
-   *
-   * ```javascript
-   *
-   * const advancedFilterBuilder = new AdvancedFilterBuilder().withTarget(tableName, columnName);
-   * ```
-   *
-   * @returns {AdvancedFilterBuilder}
-   */
-  withTarget(table: string, column: string): AdvancedFilterBuilder {
-    this.target = { table: table, column: column };
-    return this;
-  }
-
   /**
    * Sets target property for Advanced filter with target object
    *

dist/powerbi.min.js

@@ -22,21 +22,6 @@ export class BasicFilterBuilder implements IFilterBuilder {
   private operator: BasicFilterOperators;
   private isRequireSingleSelection = false;
 
-  /**
-   * Sets target property for Basic filter
-   *
-   * ```javascript
-   *
-   * const basicFilterBuilder = new BasicFilterBuilder().withTarget(tableName, columnName);
-   * ```
-   *
-   * @returns {BasicFilterBuilder}
-   */
-  withTarget(table: string, column: string): BasicFilterBuilder {
-    this.target = { table: table, column: column };
-    return this;
-  }
-
   /**
    * Sets target property for Basic filter with target object
    *