[Feature] GraphQL support

Author: katopz

README.md

@@ -23,6 +23,7 @@
 - [x] Deploy with Docker
 - [x] Deploy with Docker Compose
 - [x] Deploy with one click
+- [x] GraphQL support `GRAPHQL_SUPPORT=true`, `GRAPHQL_SCHEMA=YOUR_SCHEMA_URL` (default to `./cloud/graphql/schema.js`)
 
 ## :tv: Overview
 ![Parse Server Diagram](https://github.com/yongjhih/docker-parse-server/raw/master/art/parse-server-diagram.png)
@@ -206,6 +207,17 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
     }
 }
 ```
+
+### :paperclip: GraphQL
+Run with GraphQL support.
+```shell
+GRAPHQL_SUPPORT=true APP_ID=YOUR_APP_ID MASTER_KEY=YOUR_MASTER_KEY SERVER_URL=http://localhost:1337/parse docker-compose up -d
+```
+> Make sure `./cloud/graphql/schema.js` is pushed to cloud code.  
+> Then navigate to [http://localhost:1337/graphql?query=%7B%0A%20%20hello%0A%7D%0A](http://localhost:1337/graphql?query=%7B%0A%20%20hello%0A%7D%0A)  
+
+![](./art/graphql.png)
+
 ## :eyes: See Also
 * https://github.com/ParsePlatform/parse-server
 * http://blog.parse.com/announcements/introducing-parse-server-and-the-database-migration-tool/

art/graphql.png

@@ -0,0 +1,18 @@
+var graphql = require('graphql')
+var GraphQLSchema = graphql.GraphQLSchema
+var GraphQLObjectType = graphql.GraphQLObjectType
+var GraphQLString = graphql.GraphQLString
+
+module.exports = new GraphQLSchema({
+  query: new GraphQLObjectType({
+    name: 'RootQueryType',
+    fields: {
+      hello: {
+        type: GraphQLString,
+        resolve() {
+          return 'world';
+        }
+      }
+    }
+  })
+});

cloud/graphql/schema.js

@@ -0,0 +1,18 @@
+var graphql = require('graphql')
+var GraphQLSchema = graphql.GraphQLSchema
+var GraphQLObjectType = graphql.GraphQLObjectType
+var GraphQLString = graphql.GraphQLString
+
+module.exports = new GraphQLSchema({
+  query: new GraphQLObjectType({
+    name: 'RootQueryType',
+    fields: {
+      hello: {
+        type: GraphQLString,
+        resolve() {
+          return 'world';
+        }
+      }
+    }
+  })
+});

dev/cloud/graphql/schema.js

@@ -61,6 +61,8 @@ parse-server:
     VIRTUAL_HOST:      $PARSE_SERVER_VIRTUAL_HOST
     LETSENCRYPT_HOST:  $PARSE_SERVER_LETSENCRYPT_HOST
     LETSENCRYPT_EMAIL: $PARSE_SERVER_LETSENCRYPT_EMAIL
+    GRAPHQL_SUPPORT:  $GRAPHQL_SUPPORT
+    GRAPHQL_SCHEMA:   $GRAPHQL_SCHEMA
   links:
     - mongo
   volumes_from:

docker-compose-le.yml

@@ -58,6 +58,8 @@ parse-server:
     AZURE_CONTAINER:  $AZURE_CONTAINER
     AZURE_ACCESS_KEY: $AZURE_ACCESS_KEY
     AZURE_DIRECT:     $AZURE_DIRECT
+    GRAPHQL_SUPPORT:  $GRAPHQL_SUPPORT
+    GRAPHQL_SCHEMA:   $GRAPHQL_SCHEMA
   links:
     - mongo
   volumes_from:

docker-compose-production.yml

@@ -57,6 +57,8 @@ parse-server:
     AZURE_CONTAINER:  $AZURE_CONTAINER
     AZURE_ACCESS_KEY: $AZURE_ACCESS_KEY
     AZURE_DIRECT:     $AZURE_DIRECT
+    GRAPHQL_SUPPORT:  $GRAPHQL_SUPPORT
+    GRAPHQL_SCHEMA:   $GRAPHQL_SCHEMA
   links:
     - mongo
   volumes_from:

docker-compose-without-dashboard.yml

@@ -60,6 +60,8 @@ parse-server:
     AZURE_DIRECT:     $AZURE_DIRECT
     LIVEQUERY_SUPPORT: $LIVEQUERY_SUPPORT
     LIVEQUERY_CLASSES: $LIVEQUERY_CLASSES
+    GRAPHQL_SUPPORT:  $GRAPHQL_SUPPORT
+    GRAPHQL_SCHEMA:   $GRAPHQL_SCHEMA
   links:
     - mongo
   volumes_from:

docker-compose.yml

@@ -272,3 +272,34 @@ if(liveQuery) {
     console.log('docker-parse-server running on ' + serverURL + ' (:' + port + mountPath + ')');
   });
 }
+
+// GraphQL
+var isSupportGraphQL = process.env.GRAPHQL_SUPPORT;
+var schemaURL = process.env.GRAPHQL_SCHEMA || './cloud/graphql/schema.js';
+
+console.log('isSupportGraphQL :', isSupportGraphQL);
+console.log('schemaURL :', schemaURL);
+
+if(isSupportGraphQL){
+    console.log('Starting GraphQL...');
+    
+    var IS_DEVELOPMENT = process.env.NODE_ENV !== 'production';
+
+    function getSchema() {
+        if (IS_DEVELOPMENT) {
+            delete require.cache[require.resolve(schemaURL)];
+        }
+
+        return require(schemaURL);
+    }
+
+    var graphQLHTTP = require('express-graphql');
+    app.use('/graphql', graphQLHTTP(function(request){ return {
+        graphiql: IS_DEVELOPMENT,
+        pretty: IS_DEVELOPMENT,
+        schema: getSchema()
+    }}));
+
+    // TOHAVE : Support custom `./graphql` path and maybe `port`?
+    isSupportGraphQL && console.log('GraphQL running on ' + serverURL.split(port + mountPath).join(port) + '/graphql');
+}

index.js

@@ -11,12 +11,14 @@
   "dependencies": {
     "docker-links": "^1.0.2",
     "express": "~4.11.x",
+    "express-graphql": "^0.6.1",
+    "graphql": "^0.8.2",
     "kerberos": "~0.0.x",
+    "mongodb": "2.1.18",
     "nodemon": "^1.8.1",
     "parse": "~1.8.0",
     "parse-server": "2.2.22",
-    "parse-server-azure-storage": "^1.1.0",
-    "mongodb":"2.1.18"
+    "parse-server-azure-storage": "^1.1.0"
   },
   "scripts": {
     "start": "nodemon --watch /parse/cloud index.js"