Automatically generate JS methods for flat graphql mutations.
npm install graphql-auto-mutationWrite less, do more. :rocket:
Automatically generates functions for mutations specified in a GraphQL schema.
``sh`
npm install --save graphql-auto-mutation
`javascript
import createMutations from 'graphql-auto-mutation'
const api = createMutations(YOUR_ENDPOINT_URL)
api.myCoolMutation({arg1: '1', arg2: 2})
`
Please consider the following schema, hosted on graphcool:
`graphql
type Tweet {
id: ID!
text: String!
author: User! @relation(name: "Tweets")
}
type User {
id: ID!
name: String!
tweets: [Tweet!]! @relation(name: "Tweets")
}
`
The graphcool BaaS can automatically create mutations for this schema for us. You can easily try it for yourself, using their awesome graphql-up tool.
Since the mutations are all exposed in the schema, we can just let graphql-auto-mutation utilize the endpoint to generate corresponding function calls. graphql-auto-mutation will generate a function for each mutation specified in the schema. The function will have the same name as the mutation. Parameters are passed inside an object. When called, the function returns a promise which resolves to the ID of the mutated node.
`javascript
import createMutations from 'graphql-auto-mutation'
const url = 'https://api.graph.cool/simple/v1/carnationleg-cloud-268'
// Fetches schema and generates functions for all mutations
const twitter = await createMutations(url)
// Call your mutations!
const userId = await twitter.createUser({name: 'Hugo'})
const tweetId = await twitter.createTweet({authorId: userId, text: 'Test Tweet'})
await twitter.updateTweet({id: tweetId, text: 'New Text for Tweet'})
`
Of course, you can also use this tool with your own API!
The following alternative create calls are available:
`javascript
import createMutations from 'graphql-auto-mutation'
createMutations(url, authorizationHeaderToken)
createMutations.withHeaders(url, headers)
createMutations.withResolver(url, customResolver)
createMutations.withSchema(url, schema, authorizationHeaderToken)
createMutations.withSchemaAndHeaders(url, schema, headers)
createMutations.withResolverAndSchema(customResolver, headers)
`
The authorization token is your access token, which will be stored in the authorization header. This library will prepend Bearer before setting the header. If you wish to use a different format, set a custom header using the .withHeaders method.
A custom resolver is essentialy a function which receives the GraphQL query as first parameter and all query variables as second parameter. This way, you can use the GraphQL client of your choice. Also unit testing gets very easy.
At the moment, graphql-auto-mutation` only supports mutations with scalar input types. Nested mutations are not supported.
GraphQL is awesome when it comes to querying data. However, when nodes are updated or created, calling mutations requires multiple lines of code. Especially for cool BaaS like graphcool, mutations can be very generic. Developers end up writing similar mutations over and over again. Using this tool, executing a mutation becomes as simple as writing a function call.