apollo-server-azure-function first implementation.

CHANGELOG.md

@@ -6,6 +6,7 @@
 - Update `graphql-playground-html` to 1.7.8
 - Allow an optional function to resolve the `rootValue`, passing the `DocumentNode` AST to determine the value. [PR #1555](https://github.com/apollographql/apollo-server/pull/1555)
 - Follow-up on the work in [PR #1516](https://github.com/apollographql/apollo-server/pull/1516) to also fix missing insertion cursor/caret when a custom GraphQL configuration is specified which doesn't specify its own `cursorShape` property. [PR #1607](https://github.com/apollographql/apollo-server/pull/1607)
+- Azure functions support [Issue #1752](https://github.com/apollographql/apollo-server/issue/1752) [PR #1753](https://github.com/apollographql/apollo-server/pull/1753)
 - Allow JSON parsing in `RESTDataSource` of Content Type `application/hal+json`. [PR ##185](https://github.com/apollographql/apollo-server/pull/1853)
 - Add support for a `requestAgent` configuration parameter within the `engine` configuration. This can be utilized when a proxy is necessary to transmit tracing and metrics data to Apollo Engine. It accepts either an [`http.Agent`](https://nodejs.org/docs/latest-v8.x/api/http.html#http_class_http_agent) or [`https.Agent`](https://nodejs.org/docs/latest-v8.x/api/https.html#https_class_https_agent) and behaves the same as the `agent` parameter to Node.js' [`http.request`](https://nodejs.org/docs/latest-v8.x/api/http.html#http_http_request_options_callback). [PR #1879](https://github.com/apollographql/apollo-server/pull/1879)
 

README.md

@@ -87,8 +87,11 @@ Often times, Apollo Server needs to be run with a particular integration. To sta
 - `koa`
 - `hapi`
 - `lambda`
+- `azure-function`
+- `cloud-function`
 - `cloudflare`
 
+
 If a framework is not on this list and it should be supported, please open a PR.
 
 ### Express

package.json

@@ -40,6 +40,7 @@
  "apollo-engine-reporting": "file:packages/apollo-engine-reporting",
  "apollo-engine-reporting-protobuf": "file:packages/apollo-engine-reporting-protobuf",
  "apollo-server": "file:packages/apollo-server",
+ "apollo-server-azure-function": "file:packages/apollo-server-azure-function",
  "apollo-server-cache-memcached": "file:packages/apollo-server-cache-memcached",
  "apollo-server-cache-redis": "file:packages/apollo-server-cache-redis",
  "apollo-server-caching": "file:packages/apollo-server-caching",

packages/apollo-server-azure-function/.npmignore

@@ -0,0 +1,6 @@
+*
+!src/**/*
+!dist/**/*
+dist/**/*.test.*
+!package.json
+!README.md

packages/apollo-server-azure-function/README.md

@@ -0,0 +1,154 @@
+---
+title: Azure Functions
+description: Setting up Apollo Server with Azure Functions
+---
+
+This is the Azure functions integration of GraphQL Server. Apollo Server is a community-maintained open-source GraphQL server that works with many Node.js HTTP server frameworks. [Read the docs](https://www.apollographql.com/docs/apollo-server/v2). [Read the CHANGELOG](https://github.com/apollographql/apollo-server/blob/master/CHANGELOG.md).
+
+```sh
+npm install apollo-server-azure-functions@alpha graphql
+```
+
+## Writing azure function
+
+Azure functions currently support two runtime versions. This package assumes that function is running under **runtime 2.0**.
+
+Azure functions typically consist of at least 2 files - index.js (function handler definition) and function.json (function settings and bindings).
+For more information about azure functions development model in general, refer to [official Azure functions docs](https://docs.microsoft.com/en-us/azure/azure-functions/functions-reference-node).
+
+Example index.js:
+
+```js
+const { gql, ApolloServer } = require("apollo-server-azure-function");
+
+// Construct a schema, using GraphQL schema language
+const typeDefs = gql`
+ type Query {
+ hello: String
+ }
+`;
+
+// A map of functions which return data for the schema.
+const resolvers = {
+ Query: {
+ hello: () => "world"
+ }
+};
+
+const server = new ApolloServer({ typeDefs, resolvers });
+
+module.exports = server.createHandler();
+```
+
+Example function.json:
+```json
+{
+ "disabled": false,
+ "bindings": [
+ {
+ "authLevel": "function",
+ "type": "httpTrigger",
+ "direction": "in",
+ "name": "req",
+ "methods": [
+ "get",
+ "post"
+ ]
+ },
+ {
+ "type": "http",
+ "direction": "out",
+ "name": "$return"
+ }
+ ]
+}
+```
+
+It is important to set output binding name to '$return' for apollo-server-azure-function to work correctly.
+
+## Modifying the Azure Function Response (Enable CORS)
+
+To enable CORS the response HTTP headers need to be modified. To accomplish this use the `cors` option.
+
+```js
+const { ApolloServer, gql } = require('apollo-server-azure-function');
+
+// Construct a schema, using GraphQL schema language
+const typeDefs = gql`
+ type Query {
+ hello: String
+ }
+`;
+
+// Provide resolver functions for your schema fields
+const resolvers = {
+ Query: {
+ hello: () => 'Hello world!',
+ },
+};
+
+const server = new ApolloServer({
+ typeDefs,
+ resolvers,
+});
+
+module.exports = server.createHandler({
+ cors: {
+ origin: '*',
+ credentials: true,
+ },
+});
+```
+
+To enable CORS response for requests with credentials (cookies, http authentication) the allow origin header must equal the request origin and the allow credential header must be set to true.
+
+```js
+const { ApolloServer, gql } = require('apollo-server-azure-function');
+
+// Construct a schema, using GraphQL schema language
+const typeDefs = gql`
+ type Query {
+ hello: String
+ }
+`;
+
+// Provide resolver functions for your schema fields
+const resolvers = {
+ Query: {
+ hello: () => 'Hello world!',
+ },
+};
+
+const server = new ApolloServer({
+ typeDefs,
+ resolvers,
+});
+
+module.exports = server.createHandler({
+ cors: {
+ origin: true,
+ credentials: true,
+ },
+});
+```
+
+### Cors Options
+
+The options correspond to the [express cors configuration](https://github.com/expressjs/cors#configuration-options) with the following fields(all are optional):
+
+* `origin`: boolean | string | string[]
+* `methods`: string | string[]
+* `allowedHeaders`: string | string[]
+* `exposedHeaders`: string | string[]
+* `credentials`: boolean
+* `maxAge`: number
+
+## 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](https://github.com/apollographql/apollo-server/blob/master/CONTRIBUTING.md), take a look at the [roadmap](https://github.com/apollographql/apollo-server/blob/master/ROADMAP.md) and make your first PR!

packages/apollo-server-azure-function/package.json

@@ -0,0 +1,33 @@
+{
+ "name": "apollo-server-azure-function",
+ "version": "2.2.0-alpha.2",
+ "description": "Production-ready Node.js GraphQL server for Azure Functions",
+ "keywords": [ "GraphQL", "Apollo", "Server", "Azure", "Javascript" ],
+ "author": "opensource@apollographql.com",
+ "license": "MIT",
+ "repository": {
+ "type": "git",
+ "url": "https://github.com/apollographql/apollo-server/tree/master/packages/apollo-server-azure-function"
+ },
+ "homepage": "https://github.com/apollographql/apollo-server#readme",
+ "bugs": {
+ "url": "https://github.com/apollographql/apollo-server/issues"
+ },
+ "main": "dist/index.js",
+ "types": "dist/index.d.ts",
+ "engines": {
+ "node": ">=6"
+ },
+ "dependencies": {
+ "@apollographql/graphql-playground-html": "^1.6.4",
+ "apollo-server-core": "file:../apollo-server-core",
+ "apollo-server-env": "file:../apollo-server-env",
+ "graphql-tools": "^4.0.0"
+ },
+ "devDependencies": {
+ "apollo-server-integration-testsuite": "file:../apollo-server-integration-testsuite"
+ },
+ "peerDependencies": {
+ "graphql": "^0.12.0 || ^0.13.0 || ^14.0.0"
+ }
+}