WIP

.editorconfig

@@ -0,0 +1,3 @@
+[*]
+indent_style = space
+indent_size = 2

.gitignore

@@ -215,3 +215,5 @@ $RECYCLE.BIN/
 
 ### Cloudflare ###
 worker
+
+src/generated

README.md

@@ -1,56 +1,60 @@
 # workers-graphql-server
 
-An [Apollo GraphQL](https://www.apollographql.com/) server, built with [Cloudflare Workers](https://workers.cloudflare.com). [Try a demo by looking at a deployed GraphQL playground](https://graphql-on-workers.signalnerve.com/___graphql).
+An [Apollo GraphQL](https://www.apollographql.com/) server, built with [Cloudflare Workers](https://workers.cloudflare.com).
 
-Why this rules: Cloudflare Workers is a serverless application platform for deploying your projects across Cloudflare's massive distributed network. Deploying your GraphQL application to the edge is a huge opportunity to build consistent low-latency API servers, with the added benefits of "serverless" (I know, the project has `server` in it): usage-based pricing, no cold starts, and instant, easy-to-use deployment software, using [Wrangler](https://github.com/cloudflare/wrangler).
-
-By the way - as a full-stack developer who _loves_ GraphQL, and the developer advocate for Cloudflare Workers, I would love to see what you build with this! Let me know [on Twitter](https://twitter.com/signalnerve)!
-
-[![Deploy to Cloudflare Workers](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/cloudflare/workers-graphql-server)
+Whether you host your APIs on-prem, in the cloud, or you're deploying [databases](https://developers.cloudflare.com/d1) to Cloudflare directly, you can deploy a globally distributed GraphQL server with Cloudflare Workers.
 
 ## Usage
 
-You can begin building your own Workers GraphQL server by [installing Wrangler](https://workers.cloudflare.com/docs/quickstart/), the Workers command-line tool, and generating a new project:
+Begin by cloning this repo and installing the dependencies:
 
 ```sh
-wrangler generate my-graphql-server https://github.com/cloudflare/workers-graphql-server
+$ git clone https://github.com/cloudflare/workers-graphql-server
+$ npm install
 ```
 
-You'll need to configure your project's `wrangler.toml` file to prepare your project for deployment. See the ["Configuration"](https://developers.cloudflare.com/workers/cli-wrangler/configuration/) docs for a guide on how to do this. Note that you'll need to [find your Cloudflare API keys](https://developers.cloudflare.com/workers/cli-wrangler/authentication/) to set up your config file.
+You can begin running the project locally by running `npm run dev`.
+
+You'll need to configure your project's `wrangler.toml` file to prepare your project for deployment. See the ["Configuration"](https://developers.cloudflare.com/workers/cli-wrangler/configuration/) docs for a guide on how to do this.
 
 The source for this project includes an example external REST data source, and defined types for the [PokeAPI](https://pokeapi.co/), as an example of how to integrate external APIs. Once you have the worker available, try this query as a sanity check:
 
 ```graphql
-query samplePokeAPIquery {
-  pokemon: pokemon(id:1) {
-    id,
-    name,
-    height,
-    weight,
-    sprites{
-      front_shiny,
+query {
+  pokemon: pokemon(id: 1) {
+    id
+    name
+    height
+    weight
+    sprites {
+      front_shiny
       back_shiny
     }
   }
 }
 ```
 
-To start using the project, configure your `graphQLOptions` object in `src/index.js`:
+## Configuration
+
+You can optionally configure your `graphQLOptions` object in `src/index.js`:
 
 ```js
 const graphQLOptions = {
-  baseEndpoint: '/', // String
-  playgroundEndpoint: '/___graphql', // ?String
-  forwardUnmatchedRequestsToOrigin: false, // Boolean
-  debug: false, // Boolean
-  cors: true, // Boolean or Object to further configure
-  kvCache: false, // Boolean
+  baseEndpoint: '/',
+  enableSandbox: true,
+  forwardUnmatchedRequestsToOrigin: false,
+  cors: true,
+  kvCache: false,
 }
 ```
 
-### Endpoints
+### Base endpoint
+
+Make requests to your GraphQL server by sending `POST` requests to the `baseEndpoint` (e.g. `graphql-on-workers.signalnerve.com/`).
 
-Make requests to your GraphQL server at the `baseEndpoint` (e.g. `graphql-on-workers.signalnerve.com/`) and, if configured, try GraphQL queries at the `playgroundEndpoint` (e.g. `graphql-on-workers.signalnerve.com/___graphql`).
+### Sandbox
+
+By default, the Apollo Sandbox is enabled. This allows you to test your GraphQL in a web GUI without needing to write any client code.
 
 ### Origin forwarding
 
@@ -93,6 +97,12 @@ id = "$myId"
 
 With a configured KV namespace set up, you can opt-in to KV caching by changing the `kvCache` config value in `graphQLOptions` (in `index.js`) to `true`.
 
+## Credits
+
+This project is heavily based on the [@as-integrations/cloudflare-workers](https://github.com/apollo-server-integrations/apollo-server-integration-cloudflare-workers) package, which is a great tool for building GraphQL servers with Cloudflare Workers.
+
+It is built with [Hono](https://github.com/honojs/hono), a simple and powerful web framework for Cloudflare Workers.
+
 ## License
 
 This project is licensed with the [MIT License](https://github.com/cloudflare/workers-graphql-server/blob/master/LICENSE).

codegen.ts

@@ -0,0 +1,16 @@
+import type { CodegenConfig } from '@graphql-codegen/cli'
+
+const config: CodegenConfig = {
+  overwrite: true,
+  schema: 'src/schema.graphql',
+  generates: {
+    'src/generated/graphql.ts': {
+      plugins: ['typescript', 'typescript-resolvers'],
+    },
+    './graphql.schema.json': {
+      plugins: ['introspection'],
+    },
+  },
+}
+
+export default config