sraza-onshape / graphql-mesh-tutorial

GraphQL Mesh Services examples

Originally found here - thanks to the team behind GraphQL Tools!

Setup

Build all APIs

First, if you are new to using yarn, then you'll need to install its workspace-tools plugin - this is a one-time action:

$ yarn plugin import workspace-tools

Then, cd into each package and run the following:

$ mkdir dist
$ npm run build
$ yarn install

Then, cd back to this root directory and run:

$ yarn workspaces foreach run build

For more info on this command, see the yarn docs here.

 

Examples

Start the single source (Books Gateway) Mesh Gateway

yarn run start-single-source

More information on https://graphql-mesh.com/docs/getting-started/your-first-mesh-gateway.

 

Start the single source (Books API without definition) Mesh Gateway

yarn run single-source-no-source-definition

More information on https://graphql-mesh.com/docs/getting-started/sources-with-no-definition

 

Start the multiple sources Mesh Gateway

yarn run start-multiple-sources

More information on https://graphql-mesh.com/docs/getting-started/combine-many-sources.

 

Start the multiple sources Mesh Gateway (with programmatic resolvers)

yarn run start-multiple-sources-prog-resolvers

More information on https://graphql-mesh.com/docs/guides/extending-unified-schema#extending-the-unified-schema.

 

---

 

Services

Books API (OpenAPI)

• GET /books
• GET /books/:id
• GET /books/categories

Authors API (gRPC)

• GetAuthor
• ListAuthors

Stores (GraphQL)

• stores Query
• bookSells(storeId: ID!) Query