From d59b54f6926d7e6c2c1e13c91df5802adbe4849e Mon Sep 17 00:00:00 2001
From: Simon Binder <simon@journeyapps.com>
Date: Wed, 20 Aug 2025 14:27:35 +0200
Subject: [PATCH] Document why binary data is set

---
 crates/core/src/sync/streaming_sync.rs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/crates/core/src/sync/streaming_sync.rs b/crates/core/src/sync/streaming_sync.rs
index 64cc21c..f6b9b42 100644
--- a/crates/core/src/sync/streaming_sync.rs
+++ b/crates/core/src/sync/streaming_sync.rs
@@ -589,6 +589,9 @@ impl StreamingSyncIteration {
             buckets: requests,
             include_checksum: true,
             raw_data: true,
+            // Clients are not supposed to set this field, but old versions of the PowerSync service
+            // will break if it's not set and the SDK requests sync data as BSON.
+            // For details, see https://github.com/powersync-ja/powersync-service/pull/332
             binary_data: true,
             client_id: client_id(self.db)?,
             parameters: self.options.parameters.take(),