feat: add dev command + default gateway

- dev CLI API is in place with options according to #9
- default command (`gramps dev`) will now run a basic gateway
- added `node-cleanup` to handle cleanup on process exit

re #11, re #16

Author: jlengstorf

bin/dev.js

@@ -0,0 +1,67 @@
+import path from 'path';
+import yargs from 'yargs';
+import startDefaultGateway from '../lib/gateway';
+
+const getDirPath = dir => path.resolve(process.cwd(), dir);
+
+export const command = 'dev';
+export const description = 'run a GraphQL gateway for local development';
+
+export const builder = yargs =>
+  yargs
+    .group(['data-source'], 'Choose data source(s) for local development:')
+    .option('data-source', {
+      alias: ['data-sources', 'd'],
+      description: 'path to one or more data sources',
+      type: 'array',
+    })
+    .group(['gateway'], 'Choose a GraphQL gateway to run the data sources:')
+    .option('gateway', {
+      alias: 'g',
+      description: 'path to a GraphQL gateway start script',
+      type: 'string',
+    })
+    .coerce('d', srcArr => srcArr.map(getDirPath))
+    .coerce('g', getDirPath)
+    .group(['live', 'mock'], 'Choose real or mock data:')
+    .options({
+      live: {
+        alias: 'l',
+        conflicts: 'mock',
+        description: 'run GraphQL with live data',
+      },
+      mock: {
+        alias: 'm',
+        conflicts: 'live',
+        description: 'run GraphQL offline with mock data',
+      },
+    })
+    .group('no-transpile', 'Turn Babel on or off:')
+    .options({
+      transpile: {
+        description: 'don’t transpile data sources (point to a build dir)',
+        type: 'boolean',
+        default: true,
+      },
+    });
+
+export const handler = ({
+  dataSources = [],
+  mock = false,
+  gateway,
+  transpile,
+}) => {
+  console.log({
+    dataSources,
+    gateway,
+    mock,
+    transpile,
+  });
+
+  if (!gateway) {
+    startDefaultGateway({
+      dataSources,
+      enableMockData: mock,
+    });
+  }
+};

bin/gramps.js

@@ -1,5 +1,21 @@
+import { EOL } from 'os';
 import yargs from 'yargs';
-import * as start from './start/start';
+import cleanup from 'node-cleanup';
 
-const argv = yargs.command('start [dir]', 'Start development server', start)
-  .argv;
+import { description, version } from '../package.json';
+import dev from './dev';
+// import cleanup from '../lib/cleanup';
+
+yargs
+  .command(dev)
+  .demandCommand()
+  .help().argv;
+
+cleanup(
+  () => {
+    // console.log('exiting...');
+  },
+  {
+    ctrl_C: `${EOL}${EOL}Thanks for using GrAMPS!`,
+  },
+);

bin/index.js

@@ -1,3 +1,4 @@
 #!/usr/bin/env node
+
 require('reify');
 require('./gramps');

bin/start/start.js

@@ -0,0 +1,20 @@
+export default (options, err) => {
+  process.stdin.resume();
+
+  console.log('Buh-bye!');
+
+  if (err) {
+    console.error(err);
+  }
+
+  if (options.cleanup) {
+    console.log('cleaning up');
+  }
+
+  if (options.exit) {
+    console.log('exiting...');
+
+    // Runs the cleanup process
+    process.exit(); // eslint-disable-line no-process-exit
+  }
+};

lib/cleanup.js

@@ -0,0 +1,33 @@
+/*
+ * This is a default gateway (server) to be used during local data source
+ * development. If the `--gateway` option is supplied, this is NOT used.
+ */
+import Express from 'express';
+import getPort from 'get-port';
+import bodyParser from 'body-parser';
+import gramps from '@gramps/gramps';
+import { GraphQLSchema } from 'graphql';
+import { graphqlExpress } from 'apollo-server-express';
+import playground from 'graphql-playground-middleware-express';
+
+const GRAPHQL_ENDPOINT = '/graphql';
+const TESTING_ENDPOINT = '/playground';
+const DEFAULT_PORT = 8080;
+
+async function startServer(app) {
+  const PORT = await getPort(DEFAULT_PORT);
+  app.listen(PORT, () => {
+    console.log(`=> http://localhost:${PORT}${TESTING_ENDPOINT}`);
+  });
+}
+
+export default config => {
+  const app = Express();
+  const GraphQLOptions = gramps(config);
+
+  app.use(bodyParser.json());
+  app.use(GRAPHQL_ENDPOINT, graphqlExpress(GraphQLOptions));
+  app.use(TESTING_ENDPOINT, playground({ endpoint: GRAPHQL_ENDPOINT }));
+
+  startServer(app);
+};