Merge branch 'master' of github.com:parse-community/Parse-SDK-JS into bug/server-6899/embedded_document_increment

Author: rdhelms

.eslintignore

@@ -1,34 +1,69 @@
 {
-    "root": true,
-    "extends": "eslint:recommended",
-    "env": {
-        "node": true,
-        "es6": true
-    },
-    "parser": "babel-eslint",
-    "globals": { 
-        "wx": true 
-    },
-    "plugins": [
-        "flowtype"
+  "root": true,
+  "extends": [
+    "eslint:recommended",
+    "plugin:jsdoc/recommended"
+  ],
+  "env": {
+    "node": true,
+    "es6": true
+  },
+  "parser": "babel-eslint",
+  "globals": { 
+    "wx": true 
+  },
+  "plugins": [
+    "flowtype",
+    "jsdoc"
+  ],
+  "parserOptions": {
+    "ecmaVersion": 6,
+    "sourceType": "module"
+  },
+  "rules": {
+    "indent": ["error", 2],
+    "linebreak-style": ["error", "unix"],
+    "no-trailing-spaces": 2,
+    "eol-last": 2,
+    "space-in-parens": ["error", "never"],
+    "no-multiple-empty-lines": 1,
+    "prefer-const": "error",
+    "space-infix-ops": "error",
+    "no-useless-escape": "off",
+    "no-var": "error",
+    "no-console": 0,
+    "no-prototype-builtins": "off",
+    "require-atomic-updates": "off",
+    "jsdoc/require-jsdoc": 0,
+    "jsdoc/require-returns-description": 0,
+    "jsdoc/require-param-description": 0,
+    "jsdoc/require-property-description": 0,
+    "jsdoc/require-param-type": 0,
+    "jsdoc/check-param-names": [
+      "error",
+      {
+        "allowExtraTrailingParamDocs": true
+      }
     ],
-    "parserOptions": {
-        "ecmaVersion": 6,
-        "sourceType": "module"
-    },
-    "rules": {
-        "indent": ["error", 2],
-        "linebreak-style": ["error", "unix"],
-        "no-trailing-spaces": 2,
-        "eol-last": 2,
-        "space-in-parens": ["error", "never"],
-        "no-multiple-empty-lines": 1,
-        "prefer-const": "error",
-        "space-infix-ops": "error",
-        "no-useless-escape": "off",
-        "no-var": "error",
-        "no-console": 0,
-        "no-prototype-builtins": "off",
-        "require-atomic-updates": "off"
-    }
+    "jsdoc/check-tag-names": [
+      "error",
+      {
+        "definedTags": [
+          "flow",
+          "flow-weak"
+        ]
+      }
+    ],
+    "jsdoc/no-undefined-types": [
+      "error",
+      {
+        "definedTypes": [
+          "AuthProvider",
+          "AsyncStorage",
+          "LocalDatastoreController",
+          "Parse"
+        ]
+      }
+    ]
+  }
 }

.eslintrc.json

@@ -1,7 +1,52 @@
 # Parse-SDK-JS
 
 ### master
-[Full Changelog](https://github.com/parse-community/Parse-SDK-JS/compare/2.15.0...master)
+[Full Changelog](https://github.com/parse-community/Parse-SDK-JS/compare/2.18.0...master)
+
+## 2.18.0
+[Full Changelog](https://github.com/parse-community/Parse-SDK-JS/compare/2.17.0...2.18.0)
+
+**Features**
+- Support query.findAll() ([#1233](https://github.com/parse-community/Parse-SDK-JS/pull/1233))
+
+**Improvements**
+- Pass objects into query.equalTo / query.notEqualTo ([#1235](https://github.com/parse-community/Parse-SDK-JS/pull/1235))
+- Improving legacy initialization setters/getters ([#1237](https://github.com/parse-community/Parse-SDK-JS/pull/1237))
+- Remove deprecated backbone options from Parse.Push ([#1238](https://github.com/parse-community/Parse-SDK-JS/pull/1238))
+- Code Coverage and Unit Tests ([#1241](https://github.com/parse-community/Parse-SDK-JS/pull/1241))
+
+**Fixes**
+- Prevent crashing LiveQueryClient if emitter error is not set ([#1241](https://github.com/parse-community/Parse-SDK-JS/pull/1241))
+- Handle LiveQuery subscription socket error ([#1241](https://github.com/parse-community/Parse-SDK-JS/pull/1241))
+- Set WeChat socket handlers before connecting ([#1241](https://github.com/parse-community/Parse-SDK-JS/pull/1241))
+- Parse.Installation validating attribute error ([#1241](https://github.com/parse-community/Parse-SDK-JS/pull/1241))
+
+## 2.17.0
+[Full Changelog](https://github.com/parse-community/Parse-SDK-JS/compare/2.16.0...2.17.0)
+
+**Improvements**
+- User LogIn with usePost option ([#1229](https://github.com/parse-community/Parse-SDK-JS/pull/1229))
+
+## 2.16.0
+[Full Changelog](https://github.com/parse-community/Parse-SDK-JS/compare/2.15.0...2.16.0)
+
+Idempotency enforcement for client requests. This deduplicates requests where the client intends to send one request to Parse Server but due to network issues the server receives the request multiple times. (Parse-Server 4.3.0+)
+**Caution, this is an experimental feature that may not be appropriate for production.**
+
+To enable use either of the following:
+* `Parse.CoreManager.set('IDEMPOTENCY', true)`
+* `Parse.idempotency = true`
+
+**Features**
+- Idempotency Request ([#1210](https://github.com/parse-community/Parse-SDK-JS/pull/1210))
+
+**Improvements**
+- Allow Pin of unsaved objects in LocalDatastore ([#1225](https://github.com/parse-community/Parse-SDK-JS/pull/1225))
+
+**Fixes**
+- crypto-js crashing React Native ([#1218](https://github.com/parse-community/Parse-SDK-JS/pull/1218))
+- Schema mismatch error on add / remove empty array on Relation  ([#1222](https://github.com/parse-community/Parse-SDK-JS/pull/1222))
+- query.select error on null fields ([#1223](https://github.com/parse-community/Parse-SDK-JS/pull/1223))
 
 ## 2.15.0
 [Full Changelog](https://github.com/parse-community/Parse-SDK-JS/compare/2.14.0...2.15.0)

Assets/img/logo_large.png renamed to .github/parse-logo.png

@@ -1,9 +1,11 @@
 # Contributing to the Parse JavaScript SDK
+
 We want to make contributing to this project as easy and transparent as possible.
 
 If you're looking to get started, but want to ease yourself into the codebase, look for issues tagged [good first task](https://github.com/parse-community/Parse-SDK-JS/labels/good%20first%20task). These are simple yet valuable tasks that should be easy to get started.
 
 ## `master` is unsafe
+
 Our goal is to keep `master` stable, but there may be changes that your application may not be compatible with. We'll do our best to publicize any breaking changes, but try to use our specific releases in any production environment.
 
 ## Setting up the project for debugging and contributing:
@@ -63,6 +65,7 @@ To run the integration tests, you will need a valid mongodb running on your loca
 Use `npm run integration` in order to run the integration tests. If you have the vscode Jasmine extension installed (as recommended), you can run your tests by clicking the *Run* or the *Debug* lens that appears near by the test.
 
 ### Pull Requests
+
 We actively welcome your pull requests. When we get one, we'll run some Parse-specific integration tests on it first. From here, we'll need to get a core member to sign off on the changes and then merge the pull request. For API changes we may need to fix internal uses, which could cause some delay. We'll do our best to provide updates and feedback throughout the process.
 
 1. Fork the repo and create your branch from `master`.
@@ -72,9 +75,11 @@ We actively welcome your pull requests. When we get one, we'll run some Parse-sp
 5. Make sure your code lints.
 
 ### Known Issues
+
 We use GitHub issues to track public bugs. We will keep a close eye on this and try to make it clear when we have an internal fix in progress. Before filing a new issue, try to make sure your problem doesn't already exist.
 
 ### Reporting New Issues
+
 Not all issues are SDK issues. If you're unsure whether your bug is with the SDK or backend, you can test to see if it reproduces with our [REST API][rest-api] and [Parse API Console][parse-api-console]. If it does, you can report backend bugs [here][bug-reports].
 If the issue only reproduces with the JS SDK, you can [open an issue](https://github.com/parse-community/parse-server/issues) on this repository.
 
@@ -87,9 +92,11 @@ Details are key. The more information you provide us the easier it'll be for us
 * Anything else you find relevant.
 
 ### Security Bugs
+
 Parse Community has a [responsible Vulnerability Disclosure Program](https://github.com/parse-community/parse-server/blob/master/SECURITY.md) for the safe disclosure of security bugs. In those cases, please go through the process outlined on that page and do not file a public issue.
 
 ## Coding Style
+
 * Most importantly, match the existing code style as much as possible.
 * We use [Flow](http://flowtype.org/) and ES6 for this codebase. Use modern syntax whenever possible.
 * Keep lines within 80 characters.
@@ -100,6 +107,7 @@ Parse Community has a [responsible Vulnerability Disclosure Program](https://git
 This project adheres to the [Contributor Covenant Code of Conduct](https://github.com/parse-community/parse-server/blob/master/CODE_OF_CONDUCT.md). By participating, you are expected to honor this code.
 
 ## License
+
 By contributing to the Parse JavaScript SDK, you agree that your contributions will be licensed under its license.
 
  [google-group]: https://groups.google.com/forum/#!forum/parse-developers

CHANGELOG.md

@@ -1,5 +1,5 @@
 <p align="center">
-    <img alt="Parse Platform" src="Assets/img/logo_large.png" width="200">
+    <img alt="Parse Platform" src="https://github.com/parse-community/Parse-SDK-JS/raw/master/.github/parse-logo.png" width="200">
 </p>
 
 <h2 align="center">Parse SDK for JavaScript</h2>
@@ -40,6 +40,8 @@ To use the npm modules for a browser based application, include it as you normal
 
 ```js
 const Parse = require('parse');
+// ES6 Minimized
+import Parse from 'parse/dist/parse.min.js';
 ```
 
 For server-side applications or Node.js command line tools, include `'parse/node'`:
@@ -77,7 +79,7 @@ Types are updated manually after every release. If a definition doesn't exist, p
 
 With Parse SDK 2.0.0, gone are the backbone style callbacks and Parse.Promises.
 
-We have curated a [migration guide](2.0.0.md) that should help you migrate your code.
+We have curated a [migration guide][migration] that should help you migrate your code.
 
 ## 3rd Party Authentications
 
@@ -103,7 +105,7 @@ And don't forget, if you plan to deploy it remotely, you should run `npm install
 
 ## Contributing
 
-We really want Parse to be yours, to see it grow and thrive in the open source community. Please see the [Contributing to Parse Javascript SDK guide](CONTRIBUTING.md).
+We really want Parse to be yours, to see it grow and thrive in the open source community. Please see the [Contributing to Parse Javascript SDK guide][contributing].
 
 ## License
 
@@ -120,7 +122,9 @@ of patent rights can be found in the PATENTS file in the same directory.
 As of April 5, 2017, Parse, LLC has transferred this code to the parse-community organization, and will no longer be contributing to or distributing this code.
 
 [3rd-party-auth]: http://docs.parseplatform.org/parse-server/guide/#oauth-and-3rd-party-authentication
+[contributing]: https://github.com/parse-community/Parse-SDK-JS/blob/master/CONTRIBUTING.md
 [custom-auth-module]: https://docs.parseplatform.org/js/guide/#custom-authentication-module
 [link-with]: https://docs.parseplatform.org/js/guide/#linking-users
+[migration]: https://github.com/parse-community/Parse-SDK-JS/blob/master/2.0.0.md
 [open-collective-link]: https://opencollective.com/parse-server
 [types-parse]: https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/parse 

CONTRIBUTING.md

@@ -1,14 +1,14 @@
 const pkg = require('./package.json');
 const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
+const { exec } = require('child_process');
 
 const rmDir = function(dirPath) {
-  if(fs.existsSync(dirPath)) {
+  if (fs.existsSync(dirPath)) {
     const files = fs.readdirSync(dirPath);
     files.forEach(function(file) {
       const curPath = path.join(dirPath, file);
-      if(fs.lstatSync(curPath).isDirectory()) { 
+      if (fs.lstatSync(curPath).isDirectory()) {
         rmDir(curPath);
       } else {
         fs.unlinkSync(curPath);
@@ -18,8 +18,18 @@ const rmDir = function(dirPath) {
   }
 };
 
-const exec = function(cmd) {
-  execSync(cmd, { stdio: 'inherit' });
+const execCommand = function(cmd) {
+  return new Promise((resolve, reject) => {
+    exec(cmd, (error, stdout, stderr) => {
+      if (error) {
+        console.warn(error);
+        return reject(error);
+      }
+      const output = stdout ? stdout : stderr;
+      console.log(output);
+      resolve(output);
+    });
+  });
 };
 
 console.log(`Building JavaScript SDK v${pkg.version}...\n`)
@@ -32,20 +42,25 @@ rmDir(path.join(__dirname, 'lib'));
 const crossEnv = 'npm run cross-env';
 const gulp = 'npm run gulp';
 
-console.log('Browser Release:');
-exec(`${crossEnv} PARSE_BUILD=browser ${gulp} compile`);
-
-console.log('Weapp Release:');
-exec(`${crossEnv} PARSE_BUILD=weapp ${gulp} compile`);
-
-console.log('Node.js Release:');
-exec(`${crossEnv} PARSE_BUILD=node ${gulp} compile`);
-
-console.log('React Native Release:');
-exec(`${crossEnv} PARSE_BUILD=react-native ${gulp} compile`);
+(async function() {
+  console.log('Browser Release:');
+  console.log('Weapp Release:');
+  console.log('Node.js Release:');
+  console.log('React Native Release:');
+  await Promise.all([
+    execCommand(`${crossEnv} PARSE_BUILD=browser ${gulp} compile`),
+    execCommand(`${crossEnv} PARSE_BUILD=weapp ${gulp} compile`),
+    execCommand(`${crossEnv} PARSE_BUILD=node ${gulp} compile`),
+    execCommand(`${crossEnv} PARSE_BUILD=react-native ${gulp} compile`),
+  ]);
 
-console.log('Bundling and minifying for CDN distribution:');
-exec(`${gulp} browserify`);
-exec(`${gulp} browserify-weapp`);
-exec(`${gulp} minify`);
-exec(`${gulp} minify-weapp`);
+  console.log('Bundling and minifying for CDN distribution:');
+  await Promise.all([
+    execCommand(`${gulp} browserify`),
+    execCommand(`${gulp} browserify-weapp`),
+  ]);
+  await Promise.all([
+    execCommand(`${gulp} minify`),
+    execCommand(`${gulp} minify-weapp`),
+  ]);
+}());