apollographql · helfer · Jun 29, 2017 · Jun 29, 2017 · Jun 29, 2017 · Jun 29, 2017
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,10 @@
 
 ### VNEXT
 
+### v1.0.0
+* Add package readmes for Express, Hapi, Koa, Restify ([@helfer](https://github.com/helfer)) in [#442](https://github.com/apollographql/graphql-server/pull/442)
+* Updated & fixed typescript typings ([@helfer](https://github.com/helfer)) in [#440](https://github.com/apollographql/graphql-server/pull/440)
+
 ### v0.9.0
 * Allow GraphiQLOptions to be a function ([@NeoPhi](https://github.com/NeoPhi)) on [#426](https://github.com/apollographql/graphql-server/pull/426)
 

diff --git a/lerna.json b/lerna.json
@@ -1,6 +1,6 @@
 {
   "lerna": "2.0.0-rc.4",
-  "version": "0.9.0",
+  "version": "1.0.0",
   "changelog": {
     "repo": "apollostack/graphql-server",
     "labels": {

diff --git a/packages/graphql-server-core/package.json b/packages/graphql-server-core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "graphql-server-core",
-  "version": "0.9.0",
+  "version": "1.0.0",
   "description": "Core engine for Apollo GraphQL server",
   "main": "dist/index.js",
   "scripts": {

diff --git a/packages/graphql-server-express/README.md b/packages/graphql-server-express/README.md
@@ -1,3 +1,57 @@
 # graphql-server-express
 
-This is the Express and Connect integration for the Apollo community GraphQL Server. [Read the docs.](http://dev.apollodata.com/tools/apollo-server/index.html)
+[![npm version](https://badge.fury.io/js/graphql-server-core.svg)](https://badge.fury.io/js/graphql-server-core)
+[![Build Status](https://travis-ci.org/apollographql/graphql-server.svg?branch=master)](https://travis-ci.org/apollographql/graphql-server)
+[![Coverage Status](https://coveralls.io/repos/github/apollographql/graphql-server/badge.svg?branch=master)](https://coveralls.io/github/apollographql/graphql-server?branch=master)
+[![Get on Slack](https://img.shields.io/badge/slack-join-orange.svg)](http://www.apollodata.com/#slack)
+
+This is the Express and Connect integration of GraphQL Server. GraphQL Server is a community-maintained open-source GraphQL server that works with all Node.js HTTP server frameworks: Express, Connect, Hapi, Koa and Restify. [Read the docs](http://dev.apollodata.com/tools/apollo-server/index.html).
+
+## Principles
+
+GraphQL Server is built with the following principles in mind:
+
+* **By the community, for the community**: GraphQL Server's development is driven by the needs of developers
+* **Simplicity**: by keeping things simple, GraphQL Server is easier to use, easier to contribute to, and more secure
+* **Performance**: GraphQL Server is well-tested and production-ready - no modifications needed
+
+
+Anyone is welcome to contribute to GraphQL Server, just read [CONTRIBUTING.md](./CONTRIBUTING.md), take a look at the [roadmap](./ROADMAP.md) and make your first PR!
+
+## Usage
+
+### Express
+
+```js
+import express from 'express';
+import bodyParser from 'body-parser';
+import { graphqlExpress } from 'graphql-server-express';
+
+const myGraphQLSchema = // ... define or import your schema here!
+const PORT = 3000;
+
+const app = express();
+
+// bodyParser is needed just for POST.
+app.use('/graphql', bodyParser.json(), graphqlExpress({ schema: myGraphQLSchema }));
+
+app.listen(PORT);
+```
+
+### Connect
+```js
+import connect from 'connect';
+import bodyParser from 'body-parser';
+import { graphqlConnect } from 'graphql-server-express';
+import http from 'http';
+
+const PORT = 3000;
+
+const app = connect();
+
+// bodyParser is needed just for POST.
+app.use('/graphql', bodyParser.json());
+app.use('/graphql', graphqlConnect({ schema: myGraphQLSchema }));
+
+http.createServer(app).listen(PORT);
+```
diff --git a/packages/graphql-server-express/package.json b/packages/graphql-server-express/package.json
@@ -1,6 +1,6 @@
 {
   "name": "graphql-server-express",
-  "version": "0.9.0",
+  "version": "1.0.0",
   "description": "Production-ready Node.js GraphQL server for Express and Connect",
   "main": "dist/index.js",
   "scripts": {
@@ -26,8 +26,8 @@
   },
   "homepage": "https://github.com/apollostack/graphql-server#readme",
   "dependencies": {
-    "graphql-server-core": "^0.9.0",
-    "graphql-server-module-graphiql": "^0.9.0"
+    "graphql-server-core": "^1.0.0",
+    "graphql-server-module-graphiql": "^1.0.0"
   },
   "devDependencies": {
     "@types/body-parser": "1.16.3",
@@ -38,7 +38,7 @@
     "connect": "^3.6.2",
     "connect-query": "^1.0.0",
     "express": "^4.15.3",
-    "graphql-server-integration-testsuite": "^0.9.0",
+    "graphql-server-integration-testsuite": "^1.0.0",
     "multer": "^1.3.0"
   },
   "peerDependencies": {

diff --git a/packages/graphql-server-hapi/README.md b/packages/graphql-server-hapi/README.md
@@ -1,3 +1,59 @@
 # graphql-server-hapi
 
-This is the Hapi integration for the Apollo community GraphQL Server. [Read the docs.](http://dev.apollodata.com/tools/apollo-server/index.html)
+[![npm version](https://badge.fury.io/js/graphql-server-core.svg)](https://badge.fury.io/js/graphql-server-core)
+[![Build Status](https://travis-ci.org/apollographql/graphql-server.svg?branch=master)](https://travis-ci.org/apollographql/graphql-server)
+[![Coverage Status](https://coveralls.io/repos/github/apollographql/graphql-server/badge.svg?branch=master)](https://coveralls.io/github/apollographql/graphql-server?branch=master)
+[![Get on Slack](https://img.shields.io/badge/slack-join-orange.svg)](http://www.apollodata.com/#slack)
+
+This is the Hapi integration of GraphQL Server. GraphQL Server is a community-maintained open-source GraphQL server that works with all Node.js HTTP server frameworks: Express, Connect, Hapi, Koa and Restify. [Read the docs](http://dev.apollodata.com/tools/apollo-server/index.html).
+
+## Principles
+
+GraphQL Server is built with the following principles in mind:
+
+* **By the community, for the community**: GraphQL Server's development is driven by the needs of developers
+* **Simplicity**: by keeping things simple, GraphQL Server is easier to use, easier to contribute to, and more secure
+* **Performance**: GraphQL Server is well-tested and production-ready - no modifications needed
+
+
+Anyone is welcome to contribute to GraphQL Server, just read [CONTRIBUTING.md](./CONTRIBUTING.md), take a look at the [roadmap](./ROADMAP.md) and make your first PR!
+
+## Usage
+
+With the Hapi plugins `graphqlHapi` and `graphiqlHapi` you can pass a route object that includes options to be applied to the route.  The example below enables CORS on the `/graphql` route.
+
+```js
+import hapi from 'hapi';
+import { graphqlHapi } from 'graphql-server-hapi';
+
+const server = new hapi.Server();
+
+const HOST = 'localhost';
+const PORT = 3000;
+
+server.connection({
+    host: HOST,
+    port: PORT,
+});
+
+server.register({
+    register: graphqlHapi,
+    options: {
+      path: '/graphql',
+      graphqlOptions: {
+        schema: myGraphQLSchema,
+      },
+      route: {
+        cors: true
+      }
+    },
+});
+
+server.start((err) => {
+    if (err) {
+        throw err;
+    }
+    console.log(`Server running at: ${server.info.uri}`);
+});
+```
+
diff --git a/packages/graphql-server-hapi/package.json b/packages/graphql-server-hapi/package.json
@@ -1,6 +1,6 @@
 {
   "name": "graphql-server-hapi",
-  "version": "0.9.0",
+  "version": "1.0.0",
   "description": "Production-ready Node.js GraphQL server for Hapi",
   "main": "dist/index.js",
   "scripts": {
@@ -26,14 +26,14 @@
   "homepage": "https://github.com/apollostack/graphql-server#readme",
   "dependencies": {
     "boom": "^5.1.0",
-    "graphql-server-core": "^0.9.0",
-    "graphql-server-module-graphiql": "^0.9.0"
+    "graphql-server-core": "^1.0.0",
+    "graphql-server-module-graphiql": "^1.0.0"
   },
   "devDependencies": {
     "@types/boom": "4.3.2",
     "@types/graphql": "^0.9.1",
     "@types/hapi": "^16.1.4",
-    "graphql-server-integration-testsuite": "^0.9.0",
+    "graphql-server-integration-testsuite": "^1.0.0",
     "hapi": "^16.4.3"
   },
   "peerDependencies": {

diff --git a/packages/graphql-server-integration-testsuite/package.json b/packages/graphql-server-integration-testsuite/package.json
@@ -1,7 +1,7 @@
 {
   "name": "graphql-server-integration-testsuite",
   "private": true,
-  "version": "0.9.0",
+  "version": "1.0.0",
   "description": "Apollo Server Integrations testsuite",
   "main": "dist/index.js",
   "scripts": {
@@ -20,9 +20,9 @@
   },
   "homepage": "https://github.com/apollostack/graphql-server#readme",
   "dependencies": {
-    "graphql-server-core": "^0.9.0",
-    "graphql-server-module-graphiql": "^0.9.0",
-    "graphql-server-module-operation-store": "^0.9.0",
+    "graphql-server-core": "^1.0.0",
+    "graphql-server-module-graphiql": "^1.0.0",
+    "graphql-server-module-operation-store": "^1.0.0",
     "supertest": "^3.0.0",
     "supertest-as-promised": "^4.0.0"
   },

diff --git a/packages/graphql-server-koa/README.md b/packages/graphql-server-koa/README.md
@@ -1,3 +1,42 @@
 # graphql-server-koa
 
-This is the Koa integration for the Apollo community GraphQL Server. [Read the docs.](http://dev.apollodata.com/tools/apollo-server/index.html)
+[![npm version](https://badge.fury.io/js/graphql-server-core.svg)](https://badge.fury.io/js/graphql-server-core)
+[![Build Status](https://travis-ci.org/apollographql/graphql-server.svg?branch=master)](https://travis-ci.org/apollographql/graphql-server)
+[![Coverage Status](https://coveralls.io/repos/github/apollographql/graphql-server/badge.svg?branch=master)](https://coveralls.io/github/apollographql/graphql-server?branch=master)
+[![Get on Slack](https://img.shields.io/badge/slack-join-orange.svg)](http://www.apollodata.com/#slack)
+
+This is the Koa integration of GraphQL Server. GraphQL Server is a community-maintained open-source GraphQL server that works with all Node.js HTTP server frameworks: Express, Connect, Hapi, Koa and Restify. [Read the docs](http://dev.apollodata.com/tools/apollo-server/index.html).
+
+## Principles
+
+GraphQL Server is built with the following principles in mind:
+
+* **By the community, for the community**: GraphQL Server's development is driven by the needs of developers
+* **Simplicity**: by keeping things simple, GraphQL Server is easier to use, easier to contribute to, and more secure
+* **Performance**: GraphQL Server is well-tested and production-ready - no modifications needed
+
+
+Anyone is welcome to contribute to GraphQL Server, just read [CONTRIBUTING.md](./CONTRIBUTING.md), take a look at the [roadmap](./ROADMAP.md) and make your first PR!
+
+## Usage
+
+```js
+import koa from 'koa'; // koa@2
+import koaRouter from 'koa-router'; // koa-router@next
+import koaBody from 'koa-bodyparser'; // koa-bodyparser@next
+import { graphqlKoa } from 'graphql-server-koa';
+
+const app = new koa();
+const router = new koaRouter();
+const PORT = 3000;
+
+// koaBody is needed just for POST.
+app.use(koaBody());
+
+router.post('/graphql', graphqlKoa({ schema: myGraphQLSchema }));
+router.get('/graphql', graphqlKoa({ schema: myGraphQLSchema }));
+
+app.use(router.routes());
+app.use(router.allowedMethods());
+app.listen(PORT);
+```
diff --git a/packages/graphql-server-koa/package.json b/packages/graphql-server-koa/package.json
@@ -1,6 +1,6 @@
 {
   "name": "graphql-server-koa",
-  "version": "0.9.0",
+  "version": "1.0.0",
   "description": "Production-ready Node.js GraphQL server for Koa",
   "main": "dist/index.js",
   "scripts": {
@@ -25,14 +25,14 @@
   },
   "homepage": "https://github.com/apollostack/graphql-server#readme",
   "dependencies": {
-    "graphql-server-core": "^0.9.0",
-    "graphql-server-module-graphiql": "^0.9.0"
+    "graphql-server-core": "^1.0.0",
+    "graphql-server-module-graphiql": "^1.0.0"
   },
   "devDependencies": {
     "@types/koa": "^2.0.39",
     "@types/koa-bodyparser": "^3.0.23",
     "@types/koa-router": "^7.0.22",
-    "graphql-server-integration-testsuite": "^0.9.0",
+    "graphql-server-integration-testsuite": "^1.0.0",
     "koa": "^2.2.0",
     "koa-bodyparser": "^4.2.0",
     "koa-router": "^7.2.0"

diff --git a/packages/graphql-server-lambda/package.json b/packages/graphql-server-lambda/package.json
@@ -1,6 +1,6 @@
 {
   "name": "graphql-server-lambda",
-  "version": "0.9.0",
+  "version": "1.0.0",
   "description": "Production-ready Node.js GraphQL server for AWS Lambda",
   "main": "dist/index.js",
   "scripts": {
@@ -25,13 +25,13 @@
   },
   "homepage": "https://github.com/apollostack/graphql-server#readme",
   "dependencies": {
-    "graphql-server-core": "^0.9.0",
-    "graphql-server-module-graphiql": "^0.9.0"
+    "graphql-server-core": "^1.0.0",
+    "graphql-server-module-graphiql": "^1.0.0"
   },
   "devDependencies": {
     "@types/aws-lambda": "0.0.10",
     "@types/graphql": "^0.9.1",
-    "graphql-server-integration-testsuite": "^0.9.0"
+    "graphql-server-integration-testsuite": "^1.0.0"
   },
   "peerDependencies": {
     "graphql": "^0.9.0 || ^0.10.1"

diff --git a/packages/graphql-server-micro/package.json b/packages/graphql-server-micro/package.json
@@ -1,6 +1,6 @@
 {
   "name": "graphql-server-micro",
-  "version": "0.9.0",
+  "version": "1.0.0",
   "description": "Production-ready Node.js GraphQL server for Micro",
   "main": "dist/index.js",
   "scripts": {
@@ -25,11 +25,11 @@
   },
   "homepage": "https://github.com/apollostack/graphql-server#readme",
   "dependencies": {
-    "graphql-server-core": "^0.9.0",
-    "graphql-server-module-graphiql": "^0.9.0"
+    "graphql-server-core": "^1.0.0",
+    "graphql-server-module-graphiql": "^1.0.0"
   },
   "devDependencies": {
-    "graphql-server-integration-testsuite": "^0.9.0",
+    "graphql-server-integration-testsuite": "^1.0.0",
     "micro": "^7.3.3",
     "microrouter": "^2.1.1"
   },

diff --git a/packages/graphql-server-module-graphiql/package.json b/packages/graphql-server-module-graphiql/package.json
@@ -1,6 +1,6 @@
 {
   "name": "graphql-server-module-graphiql",
-  "version": "0.9.0",
+  "version": "1.0.0",
   "description": "GraphiQL renderer for Apollo GraphQL Server",
   "main": "dist/index.js",
   "scripts": {

diff --git a/packages/graphql-server-module-operation-store/package.json b/packages/graphql-server-module-operation-store/package.json
@@ -1,6 +1,6 @@
 {
   "name": "graphql-server-module-operation-store",
-  "version": "0.9.0",
+  "version": "1.0.0",
   "description": "Persisted operation store module for Apollo GraphQL Servers",
   "main": "dist/index.js",
   "scripts": {