diff --git a/js/CHANGELOG.md b/js/CHANGELOG.md
index 2124000..8010bd6 100644
--- a/js/CHANGELOG.md
+++ b/js/CHANGELOG.md
@@ -1,3 +1,30 @@
+
+
+2.5.0
+
+* `tryDecompress` is async.
+* `Cache` and `PMTiles` take optional `DecompressFunc` for swapping in a different decompressor.
+* Cache sizes much more conservative to work around memory problems in serverless.
+* Cache size logic is simplified but less robust to variable-sized directories (will revisit later).
+
+2.4.0
+
+* Detect misbehaving ETag servers like Webpack dev server and fail gracefully.
+
+2.3.0
+
+* MapLibre empty tile bytes depends on tile type.
+
+2.2.0
+
+* Fetch client throws exception on non-successful HTTP responses.
+* Maximum depth of directory traversal set to 3 like other clients.
+
+2.1.0
+
+* Improve deprecation console warnings.
+* MapLibre adapter detects min/max zoom.
+
 2.0.0
 
 * Major version bump, changing the JS API.