feat: findAndCount (#653)

Author: sdjdd

src/object.js

@@ -1736,6 +1736,10 @@ module.exports = function(AV) {
                       method: method,
                       path: path,
                       body: json,
+                      params:
+                        options && options.fetchWhenSave
+                          ? { fetchWhenSave: true }
+                          : undefined,
                     };
                   }),
                 },

src/query.js

@@ -379,6 +379,24 @@ module.exports = function(AV) {
         return request.then(this._parseResponse.bind(this));
       },
 
+      /**
+       * Retrieves both AVObjects and total count.
+       *
+       * @since 4.12.0
+       * @param {AuthOptions} options
+       * @return {Promise} A tuple contains results and count.
+       */
+      findAndCount(options) {
+        const params = this._getParams();
+        params.count = 1;
+        const request = this._createRequest(params, options);
+
+        return request.then(response => [
+          this._parseResponse(response),
+          response.count,
+        ]);
+      },
+
       /**
        * scan a Query. masterKey required.
        *

storage.d.ts

@@ -411,7 +411,9 @@ export namespace Object {
     query?: Query<T>;
   }
 
-  interface SaveAllOptions extends AuthOptions {}
+  interface SaveAllOptions extends AuthOptions {
+    fetchWhenSave?: boolean;
+  }
 
   interface SetOptions extends SilentOption {}
 }
@@ -581,6 +583,7 @@ export class Query<T extends Queriable> extends BaseQuery<T> {
   endsWith(key: string, suffix: string): this;
   equalTo(key: string, value: any): this;
   exists(key: string): this;
+  findAndCount(options?: AuthOptions): Promise<[T[], number]>;
   first(options?: AuthOptions): Promise<T | undefined>;
   get(objectId: string, options?: AuthOptions): Promise<T>;
   greaterThan(key: string, value: any): this;