Add default argument for writeCheckpoint

Author: stevensJourney

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 1.1.1 (unreleased)
+
+* Added default `nil` value for `writeCheckpoint` parameter when calling `CrudBatch.complete()`. Developers no longer need to specify `nil` as an argument
+``` diff
+guard let finalBatch = try await powersync.getCrudBatch(limit: 100) else {
+  return nil
+}
+- try await batch.complete(writeCheckpoint: nil)
++ try await batch.complete()
+```
+
 ## 1.1.0
 
 * Add sync progress information through `SyncStatusData.downloadProgress`.

Sources/PowerSync/Protocol/db/CrudBatch.swift

@@ -13,3 +13,14 @@ public protocol CrudBatch {
     /// `writeCheckpoint` is optional.
     func complete(writeCheckpoint: String?) async throws
 }
+
+public extension CrudBatch {
+    /// Call to remove the changes from the local queue, once successfully uploaded.
+    ///
+    /// `writeCheckpoint` is optional.
+    func complete(writeCheckpoint: String? = nil) async throws {
+        try await self.complete(
+            writeCheckpoint: writeCheckpoint
+        )
+    }
+}

Tests/PowerSyncTests/CrudTests.swift

@@ -178,5 +178,25 @@ final class CrudTests: XCTestCase {
         }
 
         XCTAssertNil(afterCompleteBatch)
+        
+        try await database.writeTransaction { tx in
+            for i in 0 ..< 100 {
+                try tx.execute(
+                    sql: "INSERT INTO users (id, name, email, favorite_number) VALUES (uuid(), 'a', '[email protected]', ?)",
+                    parameters: [i]
+                )
+            }
+        }
+        
+        guard let finalBatch = try await database.getCrudBatch(limit: 100) else {
+            return XCTFail("Failed to get crud batch")
+        }
+        XCTAssert(finalBatch.crud.count == 100)
+        XCTAssert(finalBatch.hasMore == false)
+        // Calling complete without a writeCheckpoint param should be possible
+        try await finalBatch.complete()
+        
+        let finalValidationBatch = try await database.getCrudBatch(limit: 100)
+        XCTAssertNil(finalValidationBatch)
     }
 }