oc-graphql-client

NOTICE!

• The current released version (3.*) does not use the Apollo client due to memory consumption issues.
• The client does not expose a querybuilder, instead just use a raw string as the examples does.

A OpenComponents plugin that expose the a graphql client for interacting with a GraphQL based server.

Requirements:

• OC Registry
• GraphQL Server
• Node >= v6

Install

yarn add oc-graphql-client

Registry setup

More info about integrating OC plugins: here

...
var registry = new oc.registry(configuration);

registry.register({
  name: 'graphqlClient',
  register: require('oc-graphql-client'),
  options: {
    serverUrl: 'http://graphql-server.hosts.com'
  }
}, function(err){
  if(err){
    console.log('plugin initialisation failed:', err);
  } else {
    console.log('graphql client now available');
  }
});

...

registry.start(callback);

Register API

|parameter|type|mandatory|description| |---------|----|---------|-----------| |serverUrl|string|yes|The Url for the GraphQL server|

Usage

Example for a components' server.js:

module.exports.data = function(context, callback){
  const query = `
  query restaurantInfo($id: Int!) {
      restaurant(id: $id) {
        name
    }
  }`;

  const headers = {
    'accept-language': 'en-US, en'
  };

  context.plugins.graphql.query({ query, variables: { id: 4 } }, headers, timeout)
    .then(res => { ... })
    .catch(err => { ... })

API

|parameter|type|mandatory|description| |---------|----|---------|-----------| |options|object|yes|A composite of the query & variables to pass to GraphQL server| |headers|object|no|The headers to pass down to unerlying services| |timeout|int|no|The timeout in ms. It defaults to OS default |

Contributing

PR's are welcome!

License

MIT