chore(release): v2.2.0

Author: leeyeh

bower.json

@@ -1,6 +1,6 @@
 {
   "name": "leancloud-storage",
-  "version": "2.1.4",
+  "version": "2.2.0",
   "homepage": "https://github.com/leancloud/javascript-sdk",
   "authors": [
     "LeanCloud <support@leancloud.rocks>"

changelog.md

@@ -1,3 +1,15 @@
+# 2.2.0 (2017-04-25)
+### Bug Fixes
+* 修复了 Safari 隐身模式下用户无法登录的问题
+
+### Features
+* 短信支持图形验证码（需要在控制台应用选项「启用短信图形验证码」）
+  * 新增 `Cloud.requestCaptcha` 与 `Cloud.verifyCaptcha` 方法请求、校验图形验证码。
+  * `Cloud.requestSmsCode`，`User.requestLoginSmsCode`，`User.requestMobilePhoneVerify` 与 `User.requestPasswordResetBySmsCode` 方法增加了 `authOptions.validateToken` 参数。没有提供有效的 validateToken 的请求会被拒绝。
+* 支持客户端查询 ACL（需要在控制台应用选项启用「查询时返回值包括 ACL」）
+  * 增加 `Query#includeACL` 方法。
+  * `Object#fetch` 与 `File#fetch` 方法增加了 `fetchOptions.includeACL` 参数。
+
 ## 2.1.4 (2017-03-27)
 ### Bug Fixes
 * 如果在创建 `Role` 时不指定 `acl` 参数，SDK 会自动为其设置一个「默认 acl」，这导致了通过 Query 得到或使用 `Object.createWithoutData` 方法得到 `Role` 也会被意外的设置 acl。这个版本修复了这个问题。
@@ -18,7 +30,7 @@
 ### Bug Fixes
 * 修复了使用 masterKey 获取一个 object 后再次 save 可能会报 ACL 格式不正确的问题。
 
-## 2.1.0 (2017-01-20)
+# 2.1.0 (2017-01-20)
 ### Bug Fixes
 * 修复了 `File#toJSON` 序列化结果中缺失 objectId 等字段的问题
 * 修复了使用 `Query#containsAll`、`Query#containedIn` 或 `Query#notContainedIn` 方法传入大数组时查询结果可能为空的问题

package.json

@@ -1,6 +1,6 @@
 {
   "name": "leancloud-storage",
-  "version": "2.1.4",
+  "version": "2.2.0",
   "main": "./dist/node/index.js",
   "description": "LeanCloud JavaScript SDK.",
   "repository": {

src/utils/index.js

@@ -15,11 +15,11 @@ const ensureArray = target => {
 
 const transformFetchOptions = ({ keys, include, includeACL } = {}) => {
   const fetchOptions = {};
-  if (_.isArray(keys)) {
-    fetchOptions.keys = keys.join(',');
+  if (keys) {
+    fetchOptions.keys = ensureArray(keys).join(',');
   }
-  if (_.isArray(include)) {
-    fetchOptions.include = include.join(',');
+  if (include) {
+    fetchOptions.include = ensureArray(include).join(',');
   }
   if (includeACL) {
     fetchOptions.returnACL = includeACL;

src/version.js

@@ -1 +1 @@
-module.exports = '2.1.4';
+module.exports = '2.2.0';

storage.d.ts

@@ -8,6 +8,12 @@ declare namespace AV {
     export var applicationKey: string;
     export var masterKey: string;
 
+    interface FetchOptions {
+      keys?: string | string[];
+      include?: string | string[];
+      includeACL?: boolean;
+    }
+
     export interface AuthOptions {
         /**
          * In Cloud Code and Node only, causes the Master Key to be used for this request.
@@ -126,15 +132,15 @@ declare namespace AV {
         static withURL(name: string, url: string): File;
         static createWithoutData(objectId: string): File;
 
-        destroy<T>(): Promise<T>;
-        fetch<T>(options?: AuthOptions): Promise<T>;
+        destroy(): Promise<void>;
+        fetch(fetchOptions?: FetchOptions, options?: AuthOptions): Promise<File>;
         metaData(): any;
         metaData(metaKey: string): any;
         metaData(metaKey: string, metaValue: any): any;
         name(): string;
         ownerId(): string;
         url(): string;
-        save<T>(options?: AuthOptions): Promise<T>;
+        save(options?: AuthOptions): Promise<File>;
         setACL(acl?: ACL): any;
         size(): any;
         thumbnailURL(width: number, height: number): string;
@@ -254,7 +260,7 @@ declare namespace AV {
         destroy<T>(options?: Object.DestroyOptions): Promise<T>;
         dirty(attr: String): boolean;
         escape(attr: string): string;
-        fetch<T>(fetchOptions?: any, options?: Object.FetchOptions): Promise<T>;
+        fetch<T>(fetchOptions?: FetchOptions, options?: AuthOptions): Promise<T>;
         fetchWhenSave(enable: boolean): any;
         get(attr: string): any;
         getACL(): ACL;
@@ -280,8 +286,6 @@ declare namespace AV {
 
         interface DestroyAllOptions extends AuthOptions { }
 
-        interface FetchOptions extends AuthOptions { }
-
         interface SaveOptions extends AuthOptions, SilentOption, WaitOption { }
 
         interface SaveAllOptions extends AuthOptions { }
@@ -440,6 +444,7 @@ declare namespace AV {
         greaterThanOrEqualTo(key: string, value: any): Query;
         include(key: string): Query;
         include(keys: string[]): Query;
+        includeACL(value?: boolean): Query;
         lessThan(key: string, value: any): Query;
         lessThanOrEqualTo(key: string, value: any): Query;
         limit(n: number): Query;