feat: change startup method (#923)

Author: dblythy

_includes/graphql/getting-started.md

@@ -68,6 +68,7 @@ const parseGraphQLServer = new ParseGraphQLServer(
 );
 
 // (Optional) Mounts the REST API
+await parseServer.start();
 app.use('/parse', parseServer.app);
 // Mounts the GraphQL API using graphQLPath: '/graphql'
 parseGraphQLServer.applyGraphQL(app);

_includes/js/users.md

@@ -512,7 +512,8 @@ const api = new ParseServer({
   ...
 });
 ...
-app.use('/parse', api);
+await api.start();
+app.use('/parse', api.app);
 ```
 
 Use the `CustomAuth`:

_includes/parse-server/file-adapters.md

@@ -24,6 +24,7 @@ const api = new ParseServer({
     enableForAuthenticatedUser: true,
   }
 });
+await api.start();
 ```
 
 # Configuring File Adapters
@@ -64,6 +65,7 @@ const api = new ParseServer({
   encryptionKey: process.env.PARSE_SERVER_ENCRYPTION_KEY, //Add your file key here. Keep it secret
   ...
 });
+await api.start();
 ```
 
 Be sure not to lose your key or change it after encrypting files.
@@ -101,6 +103,7 @@ const api = new ParseServer({
   //No encryptionKey here
   ...
 });
+await api.start();
 
 //This can take awhile depending on how many files and how larger they are. It will attempt to rotate the key of all files in your filesSubDirectory
 //It is not recommended to do this on the production server, deploy a development server to complete the process.
@@ -421,6 +424,7 @@ const api = new ParseServer({
   filesAdapter: new FSFilesAdapter(), //No encryptionKey supplied
   ...
 });
+await api.start();
 
 //This can take awhile depending on how many files and how larger they are. It will attempt to rotate the key of all files in your filesSubDirectory
 //It is not recommended to do this on the production server, deploy a development server to complete the process.

_includes/parse-server/usage.md

@@ -16,7 +16,7 @@ const api = new ParseServer({
 });
 ```
 
-The parameters are as follows:
+A few of the [Parse Server Options](https://parseplatform.org/parse-server/api/master/ParseServerOptions.html) are as follows:
 
 * `databaseURI`: Connection string for your database.
 * `cloud`: Path to your app’s Cloud Code.
@@ -32,17 +32,20 @@ The parameters are as follows:
 * `auth`: Configure support for [3rd party authentication](#oauth-and-3rd-party-authentication).
 * `maxUploadSize`: Maximum file upload size. Make sure your server does not restrict max request body size (e.g. nginx.conf `client_max_body_size 100m;`)
 
-The Parse Server object was built to be passed directly into `app.use`, which will mount the Parse API at a specified path in your Express app:
+Next, Parse Server can be started with the `.start` method. This ensures that the database connection is establised, cloud code is registered, and any other startup actions.
+
+In order to access an express middleware for `app.use`, you can all `.app` value. This will mount the Parse API at a specified path in your Express app:
 
 ```js
 const express = require('express');
 const ParseServer = require('parse-server').ParseServer;
 
 const app = express();
 const api = new ParseServer({ ... });
+await api.start();
 
 // Serve the Parse API at /parse URL prefix
-app.use('/parse', api);
+app.use('/parse', api.app);
 
 const port = 1337;
 app.listen(port, function() {