fix(GraphQL): Unable to run queries with order as array

.github/stale.yml

@@ -4,13 +4,18 @@ daysUntilStale: 45
 daysUntilClose: 7
 # Issues with these labels will never be considered stale
 exemptLabels:
-  - pinned
-  - security
-  - good first issue
-  - up-for-grabs
   - bug
   - enhancement
+  - feature request
+  - good first issue
+  - hacktoberfest
   - help wanted
+  - needs investigation
+  - needs more info
+  - question
+  - pinned
+  - security
+  - up-for-grabs
 # Label to use when marking an issue as stale
 staleLabel: wontfix
 # Limit to only `issues` not `pulls`

.gitignore

@@ -56,3 +56,6 @@ lib/
 
 # Folder created by FileSystemAdapter
 /files
+
+# Redis Dump
+dump.rdb

.travis.yml

@@ -1,14 +1,16 @@
 language: node_js
-dist: trusty
+dist: xenial
 services:
 - postgresql
 - redis-server
 - docker
 addons:
-  postgresql: '9.5'
+  postgresql: '11'
   apt:
     packages:
-    - postgresql-9.5-postgis-2.3
+    - postgresql-11
+    - postgresql-11-postgis-2.5
+    - postgresql-11-postgis-2.5-scripts
 branches:
   only:
   - master
@@ -18,23 +20,29 @@ branches:
 cache:
   directories:
   - "$HOME/.npm"
+  - ".eslintcache"
 stage: test
 env:
   global:
   - COVERAGE_OPTION='./node_modules/.bin/nyc'
+  - PGPORT=5432
   matrix:
   - MONGODB_VERSION=4.0.4 MONGODB_TOPOLOGY=replicaset MONGODB_STORAGE_ENGINE=wiredTiger
   - MONGODB_VERSION=3.6.9
   - PARSE_SERVER_TEST_DB=postgres
   - PARSE_SERVER_TEST_CACHE=redis
-  - NODE_VERSION=11.4.0
+  - NODE_VERSION=12.12.0
 matrix:
   allow_failures:
-  - env: NODE_VERSION=11.4.0
+  - env: NODE_VERSION=12.12.0
 before_install:
 - nvm install $NODE_VERSION
 - nvm use $NODE_VERSION
 - npm install -g greenkeeper-lockfile@1
+- sudo sed -i 's/port = 5433/port = 5432/' /etc/postgresql/11/main/postgresql.conf
+- sudo cp /etc/postgresql/{10,11}/main/pg_hba.conf
+- sudo service postgresql stop
+- sudo service postgresql start 11
 before_script:
 - node -e 'require("./lib/index.js")'
 - psql -c 'create database parse_server_postgres_adapter_test_database;' -U postgres

CONTRIBUTING.md

@@ -29,7 +29,7 @@ Once you have babel running in watch mode, you can start making changes to parse
 
 ### Good to know:
 
-* The lib/ folder is not commited, so never make changes in there.
+* The `lib/` folder is not commited, so never make changes in there.
 * Always make changes to files in the `src/` folder.
 * All the tests should point to sources in the `lib/` folder.
 

README.md

@@ -78,8 +78,14 @@ The fastest and easiest way to get started is to run MongoDB and Parse Server lo
 
 ## Running Parse Server
 
+Before you start make sure you have installed:
+
+- [NodeJS](https://www.npmjs.com/) that includes `npm` 
+- [MongoDB](https://www.mongodb.com/) or [PostgreSQL](https://www.postgresql.org/)
+- Optionally [Docker](https://www.docker.com/)
+
 ### Locally
-```
+```bash
 $ npm install -g parse-server mongodb-runner
 $ mongodb-runner start
 $ parse-server --appId APPLICATION_ID --masterKey MASTER_KEY --databaseURI mongodb://localhost/test
@@ -88,12 +94,12 @@ $ parse-server --appId APPLICATION_ID --masterKey MASTER_KEY --databaseURI mongo
 
 
 ### Inside a Docker container
-```
+```bash
 $ git clone https://github.com/parse-community/parse-server
 $ cd parse-server
 $ docker build --tag parse-server .
 $ docker run --name my-mongo -d mongo
-$ docker run --name my-parse-server --link my-mongo:mongo -d parse-server --appId APPLICATION_ID --masterKey MASTER_KEY --databaseURI mongodb://mongo/test
+$ docker run --name my-parse-server -p 1337:1337 --link my-mongo:mongo -d parse-server --appId APPLICATION_ID --masterKey MASTER_KEY --databaseURI mongodb://mongo/test
 ```
 
 You can use any arbitrary string as your application id and master key. These will be used by your clients to authenticate with the Parse Server.
@@ -107,7 +113,7 @@ That's it! You are now running a standalone version of Parse Server on your mach
 Now that you're running Parse Server, it is time to save your first object. We'll use the [REST API](http://docs.parseplatform.org/rest/guide), but you can easily do the same using any of the [Parse SDKs](http://parseplatform.org/#sdks). Run the following:
 
 ```bash
-curl -X POST \
+$ curl -X POST \
 -H "X-Parse-Application-Id: APPLICATION_ID" \
 -H "Content-Type: application/json" \
 -d '{"score":1337,"playerName":"Sean Plott","cheatMode":false}' \
@@ -144,7 +150,7 @@ $ curl -X GET \
 
 Keeping tracks of individual object ids is not ideal, however. In most cases you will want to run a query over the collection, like so:
 
-```
+```bash
 $ curl -X GET \
   -H "X-Parse-Application-Id: APPLICATION_ID" \
   http://localhost:1337/parse/classes/GameScore
@@ -418,10 +424,10 @@ Take a look at [Live Query Guide](https://docs.parseplatform.org/parse-server/gu
 
 The easiest way to run the Parse GraphQL API is through the CLI:
 
-```
+```bash
 $ npm install -g parse-server mongodb-runner
 $ mongodb-runner start
-$ parse-server --appId APPLICATION_ID --masterKey MASTER_KEY --databaseURI mongodb://localhost/test --mountGraphQL --mountPlayground
+$ parse-server --appId APPLICATION_ID --masterKey MASTER_KEY --databaseURI mongodb://localhost/test --publicServerURL http://localhost:1337/parse --mountGraphQL --mountPlayground
 ```
 
 After starting the server, you can visit http://localhost:1337/playground in your browser to start playing with your GraphQL API.
@@ -432,12 +438,12 @@ After starting the server, you can visit http://localhost:1337/playground in you
 
 You can also run the Parse GraphQL API inside a Docker container:
 
-```
+```bash
 $ git clone https://github.com/parse-community/parse-server
 $ cd parse-server
 $ docker build --tag parse-server .
 $ docker run --name my-mongo -d mongo
-$ docker run --name my-parse-server --link my-mongo:mongo -d parse-server --appId APPLICATION_ID --masterKey MASTER_KEY --databaseURI mongodb://mongo/test --mountGraphQL --mountPlayground
+$ docker run --name my-parse-server --link my-mongo:mongo -p 1337:1337 -d parse-server --appId APPLICATION_ID --masterKey MASTER_KEY --databaseURI mongodb://mongo/test --publicServerURL http://localhost:1337/parse --mountGraphQL --mountPlayground
 ```
 
 After starting the server, you can visit http://localhost:1337/playground in your browser to start playing with your GraphQL API.
@@ -446,9 +452,17 @@ After starting the server, you can visit http://localhost:1337/playground in you
 
 ### Using Express.js
 
-You can also mount the GraphQL API in an Express.js application together with the REST API or solo:
+You can also mount the GraphQL API in an Express.js application together with the REST API or solo. You first need to create a new project and install the required dependencies:
 
+```bash
+$ mkdir my-app
+$ cd my-app
+$ npm install parse-server express --save
 ```
+
+Then, create an `index.js` file with the following content:
+
+```js
 const express = require('express');
 const { default: ParseServer, ParseGraphQLServer } = require('parse-server');
 
@@ -458,7 +472,8 @@ const parseServer = new ParseServer({
   databaseURI: 'mongodb://localhost:27017/test',
   appId: 'APPLICATION_ID',
   masterKey: 'MASTER_KEY',
-  serverURL: 'http://localhost:1337/parse'
+  serverURL: 'http://localhost:1337/parse',
+  publicServerURL: 'http://localhost:1337/parse'
 });
 
 const parseGraphQLServer = new ParseGraphQLServer(
@@ -480,7 +495,14 @@ app.listen(1337, function() {
 });
 ```
 
-After starting the server, you can visit http://localhost:1337/playground in your browser to start playing with your GraphQL API.
+And finally start your app:
+
+```bash
+$ npx mongodb-runner start
+$ node index.js
+```
+
+After starting the app, you can visit http://localhost:1337/playground in your browser to start playing with your GraphQL API.
 
 ***Note:*** Do ***NOT*** mount the GraphQL Playground in production. [Parse Dashboard](https://github.com/parse-community/parse-dashboard) has a built-in GraphQL Playground and it is the recommended option for production apps.
 
@@ -504,43 +526,93 @@ You should receive the following response:
 }
 ```
 
-## Creating your first object
+## Creating your first class
 
-Since your application does not have a schema yet, you can use the generic `create` mutation to create your first object. Run the following:
+Since your application does not have any schema yet, you can use the `createClass` mutation to create your first class. Run the following:
 
 ```graphql
-mutation CreateObject {
-  create(className: "GameScore" fields: { score: 1337 playerName: "Sean Plott" cheatMode: false }) {
-    objectId
-    createdAt
+mutation CreateClass {
+  createClass(
+    name: "GameScore"
+    schemaFields: {
+      addStrings: [{ name: "playerName" }]
+      addNumbers: [{ name: "score" }]
+      addBooleans: [{ name: "cheatMode" }]
+    }
+  ) {
+    name
+    schemaFields {
+      name
+      __typename
+    }
   }
 }
 ```
 
-You should receive a response similar to this:
+You should receive the following response:
 
 ```json
 {
   "data": {
-    "create": {
-      "objectId": "CVuh0o0ioY",
-      "createdAt": "2019-08-27T06:35:15.641Z"
+    "createClass": {
+      "name": "GameScore",
+      "schemaFields": [
+        {
+          "name": "objectId",
+          "__typename": "SchemaStringField"
+        },
+        {
+          "name": "updatedAt",
+          "__typename": "SchemaDateField"
+        },
+        {
+          "name": "createdAt",
+          "__typename": "SchemaDateField"
+        },
+        {
+          "name": "playerName",
+          "__typename": "SchemaStringField"
+        },
+        {
+          "name": "score",
+          "__typename": "SchemaNumberField"
+        },
+        {
+          "name": "cheatMode",
+          "__typename": "SchemaBooleanField"
+        },
+        {
+          "name": "ACL",
+          "__typename": "SchemaACLField"
+        }
+      ]
     }
   }
 }
 ```
 
 ## Using automatically generated operations
 
-Parse Server learned from the first object that you created and now you have the `GameScore` class in your schema. You can now start using the automatically generated operations!
+Parse Server learned from the first class that you created and now you have the `GameScore` class in your schema. You can now start using the automatically generated operations!
 
-Run the following to create a second object:
+Run the following to create your first object:
 
 ```graphql
 mutation CreateGameScore {
-  createGameScore(fields: { score: 2558 playerName: "Luke Skywalker" cheatMode: false }) {
-    objectId
+  createGameScore(
+    fields: {
+      playerName: "Sean Plott"
+      score: 1337
+      cheatMode: false
+    }
+  ) {
+    id
+    updatedAt
     createdAt
+    playerName
+    score
+    cheatMode
+    ACL
   }
 }
 ```
@@ -551,8 +623,13 @@ You should receive a response similar to this:
 {
   "data": {
     "createGameScore": {
-      "objectId": "XyvErLoJ2O",
-      "createdAt": "2019-08-27T06:37:32.078Z"
+      "id": "XN75D94OBD",
+      "updatedAt": "2019-09-17T06:50:26.357Z",
+      "createdAt": "2019-09-17T06:50:26.357Z",
+      "playerName": "Sean Plott",
+      "score": 1337,
+      "cheatMode": false,
+      "ACL": null
     }
   }
 }
@@ -564,8 +641,13 @@ You can also run a query to this new class:
 query GameScores {
   gameScores {
     results {
+      id
+      updatedAt
+      createdAt
       playerName
       score
+      cheatMode
+      ACL
     }
   }
 }
@@ -579,12 +661,13 @@ You should receive a response similar to this:
     "gameScores": {
       "results": [
         {
+          "id": "XN75D94OBD",
+          "updatedAt": "2019-09-17T06:50:26.357Z",
+          "createdAt": "2019-09-17T06:50:26.357Z",
           "playerName": "Sean Plott",
-          "score": 1337
-        },
-        {
-          "playerName": "Luke Skywalker",
-          "score": 2558
+          "score": 1337,
+          "cheatMode": false,
+          "ACL": null
         }
       ]
     }
@@ -599,7 +682,7 @@ Parse GraphQL Server allows you to create a custom GraphQL schema with own queri
 To start creating your custom schema, you need to code a `schema.graphql` file and initialize Parse Server with `--graphQLSchema` and `--cloud` options:
 
 ```bash
-$ parse-server --appId APPLICATION_ID --masterKey MASTER_KEY --databaseURI mongodb://localhost/test --mountGraphQL --mountPlayground --graphQLSchema ./schema.graphql --cloud ./main.js
+$ parse-server --appId APPLICATION_ID --masterKey MASTER_KEY --databaseURI mongodb://localhost/test --publicServerURL http://localhost:1337/parse --cloud ./cloud/main.js --graphQLSchema ./cloud/schema.graphql --mountGraphQL --mountPlayground
 ```
 
 ### Creating your first custom query