taoensso / sente

Realtime web comms library for Clojure/Script
https://www.taoensso.com/sente
Eclipse Public License 1.0
1.74k stars 196 forks source link

Sente v1.21 roadmap (future release) #456

Open ptaoussanis opened 2 weeks ago

ptaoussanis commented 2 weeks ago
awb99 commented 3 days ago

please update the demo/docs so that heartbeat useage is clearer. I would say that the connection handling part of sente is the least documented, with releases in the last 2 years a lot of things has improved (stale connections seem to no longer occur), so it is important that everything related to state change is better documented.

(defmethod -event-msg-handler :chsk/ws-pong [{:as _msg :keys [event id ?data _ring-req ?reply-fn _send-fn]}] (infof ":chsk/ws-pong: %s" event) (when ?reply-fn (?reply-fn {:unmatched-event-as-echoed-from-server event})))


- note that the demo uses a old version of sente, so most likely needs to be changed.
awb99 commented 3 days ago

Why not move to telemere both clj and cljs? This would be a nice usecase at least.

ptaoussanis commented 3 days ago

@awb99 Thanks for the suggestions. Sente's documentation and examples could definitely do with a lot of updating and improvement - have just been triaging efforts and these didn't seem like a priority.

Happy to reconsider though if there's interest.

is this necessary:

Just to answer this one so long - this has never been necessary, it's just there to illustrate that you can use these events if you like. That should be made clear, I hadn't considered that someone might interpret it as a requirement.

BTW PRs welcome if you or anyone else had small improvements like this to suggest!