GraphQL Mesh (#242)

Closes #239 

Add [GraphQL Mesh](https://www.the-guild.dev/graphql/mesh) implementation leveraging the [Apollo Federation Transform](https://www.the-guild.dev/graphql/mesh/docs/transforms/federation) for a fully compatible federation subgraph.

We start with a [completely regular GraphQL Product schema](https://github.com/enisdenjo/apollo-federation-subgraph-compatibility/blob/graphql-mesh-transform/implementations/graphql-mesh/products.graphql) and use [Mesh transformations](https://github.com/enisdenjo/apollo-federation-subgraph-compatibility/blob/graphql-mesh-transform/implementations/graphql-mesh/.meshrc.yml) to get the [required Apollo Federated schema](https://github.com/apollographql/apollo-federation-subgraph-compatibility#products-schema-to-be-implemented-by-library-maintainers).

Author: enisdenjo

.github/workflows/test-subgraph-graphql-mesh.yaml

@@ -0,0 +1,14 @@
+name: GraphQL Mesh Test
+
+on:
+  pull_request:
+    branches:
+      - main
+    paths:
+      - "implementations/graphql-mesh/**"
+
+jobs:
+  compatibility:
+    uses: ./.github/workflows/test-subgraph.yaml
+    with:
+      library: "graphql-mesh"

.gitignore

@@ -85,4 +85,7 @@ router
 .bundle
 
 # Python - ignore virtual env
-venv
+venv
+
+# GraphQL Mesh
+.mesh

README.md

@@ -160,6 +160,7 @@ The following open-source GraphQL server libraries and hosted subgraphs provide
 <tbody>
 <tr><td><a href="https://aws.amazon.com/appsync/">AWS AppSync</a></td><td><table><tr><th>_service</th><td>🟢</td></tr><tr><th>@key (single)</th><td>🟢</td></tr><tr><th>@key (multi)</th><td>🟢</td></tr><tr><th>@key (composite)</th><td>🟢</td></tr><tr><th>repeatable @key</th><td>🟢</td></tr><tr><th>@requires</th><td>🟢</td></tr><tr><th>@provides</th><td>🟢</td></tr><tr><th>federated tracing</th><td>🔲</td></tr></table></td><td><table><tr><th>@link</th><td>🟢</td></tr><tr><th>@shareable</th><td>🟢</td></tr><tr><th>@tag</th><td>🟢</td></tr><tr><th>@override</th><td>🟢</td></tr><tr><th>@inaccessible</th><td>🟢</td></tr></table></td></tr>
 <tr><td><a href="https://stepzen.com/apollo-stepzen">StepZen</a></td><td><table><tr><th>_service</th><td>🟢</td></tr><tr><th>@key (single)</th><td>🟢</td></tr><tr><th>@key (multi)</th><td>🟢</td></tr><tr><th>@key (composite)</th><td>🔲</td></tr><tr><th>repeatable @key</th><td>🔲</td></tr><tr><th>@requires</th><td>🟢</td></tr><tr><th>@provides</th><td>🟢</td></tr><tr><th>federated tracing</th><td>🔲</td></tr></table></td><td><table><tr><th>@link</th><td>🟢</td></tr><tr><th>@shareable</th><td>🟢</td></tr><tr><th>@tag</th><td>🟢</td></tr><tr><th>@override</th><td>🟢</td></tr><tr><th>@inaccessible</th><td>🟢</td></tr></table></td></tr>
+<tr><td><a href="https://www.the-guild.dev/graphql/mesh">GraphQL Mesh</a></td><td><table><tr><th>_service</th><td>🟢</td></tr><tr><th>@key (single)</th><td>🟢</td></tr><tr><th>@key (multi)</th><td>🟢</td></tr><tr><th>@key (composite)</th><td>🟢</td></tr><tr><th>repeatable @key</th><td>🟢</td></tr><tr><th>@requires</th><td>🟢</td></tr><tr><th>@provides</th><td>🟢</td></tr><tr><th>federated tracing</th><td>🟢</td></tr></table></td><td><table><tr><th>@link</th><td>🟢</td></tr><tr><th>@shareable</th><td>🟢</td></tr><tr><th>@tag</th><td>🟢</td></tr><tr><th>@override</th><td>🟢</td></tr><tr><th>@inaccessible</th><td>🟢</td></tr></table></td></tr>
 </tbody>
 </table>
 

implementations/graphql-mesh/.meshrc.yml

@@ -0,0 +1,71 @@
+serve:
+  port: 4001
+  browser: false
+  endpoint: /
+
+sources:
+  - name: GraphQL API
+    handler:
+      graphql:
+        schema: ./src/schema.ts
+    transforms:
+      - federation:
+          types:
+            - name: Product
+              config:
+                key:
+                  - fields: "id"
+                  - fields: "sku package"
+                  - fields: "sku variation { id }"
+                resolveReference: ./src/resolve-product.ts
+                fields:
+                  - name: createdBy
+                    config:
+                      provides:
+                        fields: "totalProductsCreated"
+                  - name: notes
+                    config:
+                      tag:
+                        name: "internal"
+            - name: DeprecatedProduct
+              config:
+                key:
+                  - fields: "sku package"
+                resolveReference: ./src/resolve-deprecated-product.ts
+            - name: ProductResearch
+              config:
+                key:
+                  - fields: "study { caseNumber }"
+                resolveReference: ./src/resolve-product-research.ts
+            - name: ProductDimension
+              config:
+                shareable: true
+                fields:
+                  - name: unit
+                    config:
+                      inaccessible: true
+            - name: User
+              config:
+                key:
+                  - fields: email
+                fields:
+                  - name: averageProductsCreatedPerYear
+                    config:
+                      requires:
+                        fields: "totalProductsCreated yearsOfEmployment"
+                  - name: email
+                    config:
+                      external: true
+                  - name: name
+                    config:
+                      override:
+                        from: "users"
+                  - name: totalProductsCreated
+                    config:
+                      external: true
+                  - name: yearsOfEmployment
+                    config:
+                      external: true
+
+plugins:
+  - "@graphql-yoga/plugin-apollo-inline-trace": {}

implementations/graphql-mesh/Dockerfile

@@ -0,0 +1,14 @@
+FROM node:17-alpine
+
+WORKDIR /web
+
+COPY package.json package-lock.json ./
+RUN npm install
+
+COPY src ./src
+COPY products.graphql tsconfig.json codegen.yaml ./
+RUN npm run build
+
+COPY .meshrc.yml ./
+EXPOSE 4001
+CMD npm run start

implementations/graphql-mesh/codegen.yaml

@@ -0,0 +1,7 @@
+schema: products.graphql
+
+generates:
+  ./src/resolvers-types.ts:
+    plugins:
+      - typescript
+      - typescript-resolvers

implementations/graphql-mesh/docker-compose.yaml

@@ -0,0 +1,6 @@
+services:
+  products:
+    # must be relative to the root of the project
+    build: implementations/graphql-mesh
+    ports:
+      - 4001:4001

implementations/graphql-mesh/metadata.yaml

@@ -0,0 +1,3 @@
+fullName: GraphQL Mesh
+language: Other Solutions
+documentation: https://www.the-guild.dev/graphql/mesh