bluerain-apollo-plugin

A fully-featured, production ready caching GraphQL client for every server or UI framework. https://blueeast.gitbook.io/bluerain-plugin-apollo

• Github Repo

| 🌏 Web | 🖥 Electron | 📱 React Native | | :---: | :--------: | :------------: | | ✔️ | ✔️ | ✔️ |

Screenshots

NA

Components

This plugin registers following components in the Component registry, so they can be reused later by other apps and plugins;

• Apollo Consumer

  https://www.apollographql.com/docs/react/api/react-apollo.html#apollo-consumer

• GraphqlQuery

  https://www.apollographql.com/docs/react/essentials/queries.html#basic

• GraphqlMutation

  https://www.apollographql.com/docs/react/essentials/mutations.html

• GraphqlSubscription

  https://www.apollographql.com/docs/apollo-server/v2/features/subscriptions.html

  Hooks

  This plugin provides complete flexibility to modify the apollo client. This is done by providing various filter hooks at different stages of store initialization.

  bluerain.system.app

  This hook gives the ability to modify the main System App component that gets wrapped in Redux's Provider.

  Parameters:

  | Name | Type | Description | | --------- | --------------- | ------------------------------ | | SystemApp | React.Component | The main system app component. |

  Returns:

  | Name | Type | Description | | --------- | --------------- | ------------------------------ | | SystemApp | React.Component | The main system app component. |

  Example:

  This example wraps the System App with a Apollo provider by using a replaceReduxProvider higher order component (HOC).

  import BR from '@blueeast/bluerain-os';
  import withApolloProvider from './withApolloProvider';
    
  'bluerain.system.app': App => {
  			return withApolloProvider(App, client);
  		}

  plugin.apollo.config

  This hook gives the ability to modify the plugin configurations.

  Parameters:

  | Name | Type | Description | | ------ | ------ | --------------------- | | config | Object | Plugin configurations |

  Returns:

  | Name | Type | Description | | ------ | ------ | --------------------- | | config | Object | Plugin configurations |

  Example:

  This example activates subscriptions in apollo client.

  import BR from '@blueeast/bluerain-os';
    
  BR.Filters.add(
      'plugin.apollo.config',
      function ActivateApolloSubscriptions(configs) {
          return Object.assign({}, configs, {
              subscriptions: true
          })
      }
  );

  plugin.apollo.links

  This hook gives the ability to provide uri for websocket server

  Parameters:

  | Name | Type | Description | | ------ | ------ | --------------------- | | link | Array | uri for websocket server |

  Returns:

  | Name | Type | Description | | ------ | ------ | --------------------- | | link | Array |uri for websocket server |

  Example:

  
  'plugin.apollo.links': (links) => {
   		return links;
   	}

  plugin.apollo.cache:

  This Hook clears cache of the of Apollo store

  plugin.system.initialized:

  This Hook Create apollo client when all plugins and apps are initialized

API

• ApolloPluginConfigs

  This is the default configuration set that is used at boot time.

  Properties

  • httpLinkOptions HttpLinks URI link of websocket server
  • clientOptions ApolloClientOptions Apollo client params

  ApolloPlugin

  Extends Plugin

  Main Apollo Plugin class.

  Plugin Properties

  • pluginName string "ApolloPlugin"
  • slug string "apollo"

  getClient

  Returns Apollo client