re-graph

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

This release fixes:

• Query and mutate API functions #38, thanks @qiuyin
• Retrying queries over websocket when the websocket is not ready #39

This release fixes:

• Initialisation via the re-frame event now behaves as 0.1.5 when no instance name is specified #34

This release adds support for:

• Multiple named instances as per #30, see updated README
• HTTP errors are now expressed in the same manner as Websocket errors #28, thanks @pbostrom

This release adds support for:

• Providing the payload to be sent in the connection_init message, sent whenever a websocket connection is made. See #19 and #20 for details, thanks to @gabrielnau
• Now works on React native. See #25, thanks to @madstap
• Working with query builders like venia which include "query" at the start of the string, see #18

This release adds support for:

• Providing arbitrary parameters to the underlying cljs-http request used with the HTTP transport. This allows, among other things, authorisation. See #13 for details, thanks to @chrisbetz
• Ability to destroy the re-graph state, including stopping all subscriptions and closing the websocket first. See #12 for details.

This release improves:

• Subscriptions are deduplicated by id, helping to reduce workload on servers which do not support deduplication #16
• Unsuccessful reconnection attempts no longer add messages to the websocket queue #17
• Should work better with advanced compilation #15

This release adds support for:

• Vanilla Clojurescript usage via normal functions with function callbacks, so re-frame is not required to use re-graph anymore.

This release adds support for:

• Mutations - use the ::mutate event. Thanks to @r0man

This release changes:

• Callback events now receive the entire payload map, consisting of :data and :error keys and possibly more. This is a breaking change and any existing callback events will need to destructure the payload map to obtain the :data value which was passed in previously. See the README or tests for examples. This change was added in order to provide better support for error handling, as it now gives you access to the :error key, if present, to use in this workflow. Thanks again to @r0man