Merge pull request graphql#1020 from maticzav/tools/maticzav

tools: add graphql-shield, swift-graphql and graphql-middleware

Author: orta

src/content/code/language-support/javascript/tools/graphql-middleware.md

@@ -0,0 +1,65 @@
+---
+name: GraphQLMiddleware
+description: Split up your GraphQL resolvers in middleware functions.
+url: https://github.com/maticzav/graphql-middleware
+github: maticzav/graphql-middleware
+npm: "graphql-middleware"
+---
+
+GraphQL Middleware is a schema wrapper which allows you to manage additional functionality across multiple resolvers efficiently.
+
+## Features
+
+💡 Easy to use: An intuitive, yet familiar API that you will pick up in a second.
+💪 Powerful: Allows complete control over your resolvers (Before, After).
+🌈 Compatible: Works with any GraphQL Schema.
+
+## Example
+
+```ts
+const { ApolloServer } = require('apollo-server')
+const { makeExecutableSchema } = require('@graphql-tools/schema')
+
+const typeDefs = `
+type Query {
+  hello(name: String): String
+  bye(name: String): String
+}
+`
+const resolvers = {
+  Query: {
+    hello: (root, args, context, info) => {
+      console.log(`3. resolver: hello`)
+      return `Hello ${args.name ? args.name : 'world'}!`
+    },
+    bye: (root, args, context, info) => {
+      console.log(`3. resolver: bye`)
+      return `Bye ${args.name ? args.name : 'world'}!`
+    },
+  },
+}
+
+const logInput = async (resolve, root, args, context, info) => {
+  console.log(`1. logInput: ${JSON.stringify(args)}`)
+  const result = await resolve(root, args, context, info)
+  console.log(`5. logInput`)
+  return result
+}
+
+const logResult = async (resolve, root, args, context, info) => {
+  console.log(`2. logResult`)
+  const result = await resolve(root, args, context, info)
+  console.log(`4. logResult: ${JSON.stringify(result)}`)
+  return result
+}
+
+const schema = makeExecutableSchema({ typeDefs, resolvers })
+
+const schemaWithMiddleware = applyMiddleware(schema, logInput, logResult)
+
+const server = new ApolloServer({
+  schema: schemaWithMiddleware,
+})
+
+await server.listen({ port: 8008 })
+```

src/content/code/language-support/javascript/tools/graphql-shield.md

@@ -0,0 +1,60 @@
+---
+name: GraphQLShield
+description: A GraphQL tool to ease the creation of permission layer.
+url: https://github.com/maticzav/graphql-shield
+github: maticzav/graphql-shield
+npm: "graphql-shield"
+---
+
+GraphQL Shield helps you create a permission layer for your application. Using an intuitive rule-API, you'll gain the power of the shield engine on every request and reduce the load time of every request with smart caching. This way you can make sure your application will remain quick, and no internal data will be exposed.
+
+```ts
+import { rule, shield, and, or, not } from 'graphql-shield'
+
+// Rules
+
+const isAuthenticated = rule({ cache: 'contextual' })(
+  async (parent, args, ctx, info) => {
+    return ctx.user !== null
+  },
+)
+
+const isAdmin = rule({ cache: 'contextual' })(
+  async (parent, args, ctx, info) => {
+    return ctx.user.role === 'admin'
+  },
+)
+
+const isEditor = rule({ cache: 'contextual' })(
+  async (parent, args, ctx, info) => {
+    return ctx.user.role === 'editor'
+  },
+)
+
+// Permissions
+
+const permissions = shield({
+  Query: {
+    frontPage: not(isAuthenticated),
+    fruits: and(isAuthenticated, or(isAdmin, isEditor)),
+    customers: and(isAuthenticated, isAdmin),
+  },
+  Mutation: {
+    addFruitToBasket: isAuthenticated,
+  },
+  Fruit: isAuthenticated,
+  Customer: isAdmin,
+})
+
+// Server
+
+const server = new GraphQLServer({
+  typeDefs,
+  resolvers,
+  middlewares: [permissions],
+  context: (req) => ({
+    ...req,
+    user: getUser(req),
+  }),
+})
+```

src/content/code/language-support/swift-objective-c-ios/client/swift-graphql.md

@@ -0,0 +1,49 @@
+---
+name: SwiftGraphQL
+description: A GraphQL client that lets you forget about GraphQL.
+url: https://github.com/maticzav/swift-graphql
+github: maticzav/swift-graphql
+---
+
+
+SwiftGraphQL is a Swift code generator and a lightweight GraphQL client. It lets you create queries using Swift, and guarantees that every query you create is valid.
+
+The library is centered around three core principles:
+
+🚀 If your project compiles, your queries work.
+🦉 Use Swift in favour of GraphQL wherever possible.
+🌳 Your application model should be independent of your schema.
+
+Here's a short preview of the SwiftGraphQL code
+
+```swift
+import SwiftGraphQL
+
+// Define a Swift model.
+struct Human: Identifiable {
+    let id: String
+    let name: String
+    let homePlanet: String?
+}
+
+// Create a selection.
+let human = Selection.Human {
+    Human(
+        id: try $0.id(),
+        name: try $0.name(),
+        homePlanet: try $0.homePlanet()
+    )
+}
+
+// Construct a query.
+let query = Selection.Query {
+    try $0.humans(human.list)
+}
+
+// Perform the query.
+send(query, to: "http://swift-graphql.heroku.com") { result in
+    if let data = try? result.get() {
+        print(data) // [Human]
+    }
+}
+```