v1.21.0-RC1 (2025-09-02)

Author: ptaoussanis

CHANGELOG.md

@@ -2,6 +2,70 @@ This project uses [**Break Versioning**](https://www.taoensso.com/break-versioni
 
 ---
 
+# `v1.21.0-RC1` (2025-09-02)
+
+- **Dependency**: [on Clojars](https://clojars.org/com.taoensso/sente/versions/1.21.0-RC1)
+- **Versioning**: [Break Versioning](https://www.taoensso.com/break-versioning)
+
+Sente v1.21 is a **major release** with many improvements! It includes **breaking changes** for some users. Please report any unexpected problems to the [Slack channel](http://taoensso.com/sente/slack) or [GitHub](https://github.com/taoensso/sente/issues) 🙏
+
+\- [Peter Taoussanis](https://www.taoensso.com)
+
+Quick highlights:
+
+- Adds [support](https://github.com/taoensso/sente/issues/470) for **high-speed binary serialization**
+- Adds support for **compression** (WebSockets + Ajax) \[f8a3fad]
+- **Smaller dependency** \[4864926] \[6a7a609]
+- **Improved reliability** under load \[173652d] \[49000db] \[71e7bb0]
+- Pluggable logging via [Trove](https://www.taoensso.com/trove) \[4864926]
+- Many small fixes and improvements
+
+As always thank you to any contributors! 🙏
+
+## Since `v1.21.0-beta2` (2025-07-04)
+
+- \[mod] Increase default `:ws-ping-timeout-ms` (5->10 secs) \[147fbdd]
+- \[new] [#470] Add new binary [MessagePack packer](https://github.com/taoensso/sente/blob/a8de08f26cf739512d249dc88bc98c33a9992bcf/src/taoensso/sente/packers/msgpack.cljc#L8) \[757ebd2]
+- \[new] Add MessagePack packer to [example project](https://github.com/taoensso/sente/tree/master/example-project) \[e88a17f]
+- \[fix] Trace-level Trove logs shouldn't show by default in JS console
+- \[fix] Improve async packer error handling \[3292847]
+- \[doc] Clarify client-side send-fn args \[1feca6f]
+
+## Since `v1.20.0` (2024-12-31)
+
+### Changes
+
+- **➤ \[mod] [BREAKING]** [#472] Switch logging: Timbre -> Trove \[4864926]
+- **➤ \[mod] [BREAKING]** Make packers more flexible \[f8a3fad]
+- **➤ \[mod] [BREAKING]** Increase default `:ws-ping-timeout-ms` (5->10 secs) \[147fbdd]
+- \[mod] [#455] Halve given `ws-kalive-ms` \[49000db]
+- \[mod] Make Java WS client optional \[6a7a609]
+- \[mod] [#462] Don't throw by default on Ajax read timeouts \[fb30404]
+- \[mod] Enable WebSocket ping timeout by default \[71e7bb0]
+- \[mod] Change default WebSocket binary type (blob->arraybuffer) \[02da98e]
+- \[mod] Remove experimental, undocumented `cb-chan-as-fn` \[71db112]
+- \[mod] Remove long-vestigial legacy pack code \[cf2a149]
+
+### Fixes
+
+- \[fix] [#471] Switch to custom lightweight timer implementation \[173652d]
+- \[fix] [#466] Fix support for Jetty 12 community adapter (@aiba) \[d16bb6c]
+- \[fix] \[#464] \[#325] Fix option to use custom WebSocket constructor (@iarenaza) \[07a9bd9]
+
+### New
+
+- \[new] [#470] Add new binary [MessagePack packer](https://github.com/taoensso/sente/blob/a8de08f26cf739512d249dc88bc98c33a9992bcf/src/taoensso/sente/packers/msgpack.cljc#L8) \[757ebd2]
+- \[new] Add MessagePack packer to [example project](https://github.com/taoensso/sente/tree/master/example-project) \[e88a17f]
+- \[new] [#467] Allow `:csrf-token-fn` to return `:sente/skip-CSRF-check` \[8aae3d0]
+- \[new] [#467] Make `cb-error?`, `cb-success?` available to Clj code \[08e8b3e]
+- \[new] [#462] Keep Ring request in Ajax channel \[01a41a3]
+- \[new] Update ref example to add dynamic packer \[cd98db7]
+- \[new] Update ref example logging \[85b3e8a]
+- \[doc] Document limitations on event ordering \[532064d]
+- \[doc] Clarify client-side send-fn args \[1feca6f]
+
+---
+
 # `v1.21.0-beta2` (2025-07-04)
 
 - **Dependency**: [on Clojars](https://clojars.org/com.taoensso/sente/versions/1.21.0-beta2)

README.md

@@ -15,8 +15,8 @@ Loosely inspired by [Socket.IO](https://socket.io/), it uses **core.async**, **W
 
 ## Latest release/s
 
+- `2025-09-02` `v1.21.0-RC1` (dev): [release info](../../releases/tag/v1.21.0-RC1)
 - `2024-12-31` `v1.20.0` (stable): [release info](../../releases/tag/v1.20.0)
-- `2025-07-04` `v1.21.0-beta2` (dev): [release info](../../releases/tag/v1.21.0-beta2)
 
 [![Clj tests][Clj tests SVG]][Clj tests URL]
 [![Cljs tests][Cljs tests SVG]][Cljs tests URL]
@@ -29,7 +29,7 @@ See [here][GitHub releases] for earlier releases.
 - **Bidirectional a/sync comms** over **WebSockets** with **auto Ajax fallback**
 - **It just works**: auto keep-alive, buffering, protocol selection, reconnects
 - **Efficient design** with auto event batching for low-bandwidth use, even over Ajax
-- Send **arbitrary Clojure vals** over [edn](https://github.com/edn-format/edn) or [Transit](https://github.com/cognitect/transit-clj) (JSON, MessagePack, etc.)
+- Send **arbitrary Clojure vals** with **high-speed binary serialization** (v1.21+) or [edn](https://github.com/edn-format/edn)
 - Tiny, easy-to-use [API](../../wiki/1-Getting-started#usage)
 - Support for users simultaneously connected with **multiple clients** and/or devices
 - Realtime info on **which users are connected**, and over which protocols
@@ -38,10 +38,10 @@ See [here][GitHub releases] for earlier releases.
 
 ### Capabilities
 
-Protocol   | client>server  | client>server + ack/reply | server>user push
----------- | -------------- | ------------------------- | ----------------
-WebSockets | ✓ (native)    | ✓ (emulated)              | ✓ (native)
-Ajax       | ✓ (emulated)  | ✓ (native)                | ✓ (emulated)
+| Protocol   | client>server | client>server + ack/reply | server>user push |
+| ---------- | ------------- | ------------------------- | ---------------- |
+| WebSockets | ✓ (native)    | ✓ (emulated)              | ✓ (native)       |
+| Ajax       | ✓ (emulated)  | ✓ (native)                | ✓ (emulated)     |
 
 So you can ignore the underlying protocol and deal directly with Sente's unified API that exposes the best of both WebSockets (bidirectionality + performance) and Ajax (optional ack/reply).
 

example-project/project.clj

@@ -1,4 +1,4 @@
-(defproject com.taoensso.examples/sente "1.21.0-beta2"
+(defproject com.taoensso.examples/sente "1.21.0-RC1"
   :description "Sente, reference web-app example project"
   :url "https://github.com/ptaoussanis/sente"
   :license {:name "Eclipse Public License"
@@ -15,7 +15,7 @@
    [org.clojure/core.async    "1.8.741"]
    [nrepl                       "1.3.1"] ; Optional, for Cider
 
-   [com.taoensso/sente   "1.21.0-beta2"] ; <--- Sente
+   [com.taoensso/sente     "1.21.0-RC1"] ; <--- Sente
    [com.taoensso/telemere       "1.1.0"] ; Optional, for logging
 
    ;; Choose (uncomment) a supported web server --------------

project.clj

@@ -1,4 +1,4 @@
-(defproject com.taoensso/sente "1.21.0-beta2"
+(defproject com.taoensso/sente "1.21.0-RC1"
   :author "Peter Taoussanis <https://www.taoensso.com>"
   :description "Realtime web comms library for Clojure/Script"
   :url "https://github.com/taoensso/sente"