Re Graph Versions Save

This is a major release of re-graph due to the API signatures changing. You are strongly advised to read the UPGRADE guide for rationale and code examples.

This release changes:

• Nearly all API signatures, rationalising multiple positional args into a single map. The legacy API is retained, for the time being, at re-graph.core-deprecated #81

This release improves:

• Documentation of options for authentication #80
• Error messages when re-frame is not initialised properly #86

This release improves:

• updated all dependencies, should now work with clj-http 3.10+
• updated logging to remove js compiler warnings

This release changes:

• updated logging to ensure compatibility with ClojureScript 1.10.844+ #82

This release changes:

• re-frame compatibility to 1.1.2 and up (#76) - this version will not work with older versions of re-frame

This release adds support for:

• Re-initialisation, for the particular use case of authentication tokens changing whilst retaining on-going subscriptions #67 (and #74 - thanks @polymeris)
• Sending queries and mutations via http even when a websocket is connected #65
• The :impl parameter can now be a function that returns the options map, as well as a literal options map (fixes regression of #13, #72)

This release improves:

• Documentation of dependency for JDK11+ #69 (thanks @Atrox)

This release changes:

• Running on JDK 10 or lower will require the original Clojure implementation based on clj-http and gniazdo. See the README for details
• The options supplied in init have been reorganised to separate websocket and http parameters as follows:

Previously:

(re-frame/dispatch
  [::re-graph/init
    {:ws-url "wss://foo.io/graphql-ws"
     :connection-init-payload {}
     :http-url "http://bar.io/graphql"}])

Now:

(re-frame/dispatch
  [::re-graph/init
    {:ws {:url "wss://foo.io/graphql-ws"
          :connection-init-payload {}}
     :http {:url "http://bar.io/graphql"}}])

See the README for all option parameters.

This release adds support for:

• Finer control over the http and websocket connections (:impl option) e.g. sharing a cookie store as per #58

This release improves:

• Fewer dependencies on the JVM

Many thanks to @loomis for implementing the vast majority of this.

This release changes:

• The signature of the mutate function which incorrectly took a single vector but now takes varargs in the same way as query #55 (thanks @loomis)

This release adds support for:

• Synchronous mutate and query (Clojure only) #56 (thanks @loomis)
• Specifying the websocket sub-protocol #53 #62 (thanks @jmarca)
• Aborting operations via HTTP (experimental) #50

This release improves:

• Error handling will no longer overwrite the status or message from the server if they are present #54 (thanks @loomis)
• The examples in the readme #57 #61 (thanks @viebel)

This release fixes:

• Some Clojure interop
• Node runtime compatibility (as per #51, thanks to @loomis)

This release adds support for:

• Clojure! re-graph has been ported to cljc. Thank you @henryw374 for the initial work #47

This release fixes:

• Complaining about destroyed instances - thanks @iku000888 #45

This release adds support for:

• Error messages returned via the websocket transport are now piped to the callback handler in the :errors key #43