Port to OTP 28/29 and hackney 4.2.2

.github/workflows/test.yml

@@ -14,7 +14,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        otp: ['27.3', '28.0']
+        otp: ['27.3', '28.0', '29.0']
         rebar3: ['3.25.0']
 
     steps:
@@ -55,7 +55,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        otp: ['27.3', '28.0']
+        otp: ['27.3', '28.0', '29.0']
         rebar3: ['3.25.0']
 
     steps:
@@ -102,6 +102,12 @@ jobs:
         release: "14.2"
         usesh: true
         prepare: |
+          # The pkg repo is built for a newer FreeBSD minor than the VM image,
+          # so allow the OS-version mismatch and upgrade installed packages
+          # first to keep ABIs (e.g. git/pcre2) consistent.
+          export IGNORE_OSVERSION=yes
+          pkg update -f
+          pkg upgrade -y
           pkg install -y erlang-runtime28 rebar3 cmake git gmake go llvm18
         run: |
           # Ensure Erlang 28 is in PATH

CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.1.0] - 2026-06-09
+
+### Changed
+
+- Updated to hackney 4.2.2. Response bodies are now read eagerly: a normal
+  request returns `{ok, Status, Headers, Body}` with the body as a binary.
+- Reworked pull-based response streaming (multipart `open_doc`,
+  `fetch_attachment`/`stream_attachment` with `stream`, `stream_doc`) onto
+  hackney's async mode. The public streaming API is unchanged.
+- Replaced deprecated standalone `catch` expressions with `try ... catch`
+  for OTP 29.
+
+### Compatibility
+
+- Supports OTP 27, 28 and 29.
+- CI now also runs on OTP 29.
+
+### Dependencies
+
+- hackney: 4.2.2 (from 2.0.1)
+- meck (test): 1.2.0 (from 0.9.2)
+
+### Removed
+
+- `hackney:skip_body/1` usage (removed in hackney 4.x); bodies are read directly.
+
 ## [2.0.0] - 2026-01-21
 
 ### Breaking Changes

rebar.config

@@ -17,7 +17,7 @@
 ]}.
 
 {deps, [
-    {hackney, "2.0.1"},
+    {hackney, "4.2.2"},
     %% oauth is optional - only needed if using OAuth authentication
     {oauth, "2.1.0"}
 ]}.
@@ -58,6 +58,6 @@
 {profiles, [{test, [
                     {cover_enabled, true},
                     {eunit_opts, [verbose]},
-                    {deps, [{oauth, "2.1.0"}, {meck, "0.9.2"}]}
+                    {deps, [{oauth, "2.1.0"}, {meck, "1.2.0"}]}
                    ]}
            ]}.

src/couchbeam.app.src

@@ -6,7 +6,7 @@
 
 {application, couchbeam,
  [{description, "Erlang CouchDB client"},
-  {vsn, "2.0.0"},
+  {vsn, "2.1.0"},
   {modules, []},
   {registered, [
     couchbeam_sup