GraphQL Websocket Client

An extensible client for connecting with GraphQL over Websockets following the graphql-ws conventions.

Installation

The package can be installed by adding graphql_ws_client to your list of dependencies in mix.exs.

def deps do
  [
    {:graphql_ws_client, "~> 1.0"},
  ]
end

If you are using the default configuration, GraphQLWSClient.Drivers.Gun is used as driver and you will need the gun and jason packages as well.

def deps do
  [
    # ...
    {:gun, "~> 2.0"},
    {:jason, "~> 1.4"},
  ]
end

Take a look in the driver documentation to find out how to customize driver options.

Alternatively, you can write your own driver based on the GraphQLWSClient.Driver behaviour.

Usage

{:ok, socket} = GraphQLWSClient.start_link(url: "ws://localhost:4000/socket")

{:ok, subscription_id} = GraphQLWSClient.subscribe(
  socket,
  "subscription PostCreated { ... }"
)

{:ok, _} = GraphQLWSClient.query(socket, "mutation CreatePost { ... }")

receive do
  %GraphQLWSClient.Event{} = event ->
    IO.inspect(event)
end

GraphQLClient.close(socket)

Custom Client

If you want to run the client as part of a supervision tree in your application, you can also use GraphQLWSClient to create your own client.

defmodule MyClient do
  use GraphQLWSClient, otp_app: :my_app
end

Then, you can configure your client using a config file:

import Config

config :my_app, MyClient,
  url: "ws://localhost:4000/socket"

Docs

Documentation can be found at https://hexdocs.pm/graphql_ws_client or generated locally using mix docs.