• Update core extension to 0.4.6 (changelog)
• Add getCrudTransactions(), returning an async sequence of transactions.
• Compatibility with Swift 6.2 and XCode 26.
• Update minimum MacOS target to v12
• Update minimum iOS target to v15
• [Attachment Helpers] Added automatic verification or records' local_uri values on AttachmentQueue initialization.
  initialization can be awaited with AttachmentQueue.waitForInit(). AttachmentQueue.startSync() also performs this verification.
  waitForInit() is only recommended if startSync is not called directly after creating the queue.

• Update core extension to 0.4.5 (changelog)
• Additional Swift 6 Strict Concurrency Checking declarations added for remaining protocols in #75
• Fix issue in legacy sync client where local writes made offline could have their upload delayed until a keepalive event was received. This could also cause downloaded updates to be delayed even further until all uploads were completed in powersync-ja/powersync-kotlin#255

• Fix null values in CRUD entries being reported as strings in #69

• Added support for Swift 6 strict concurrency checking in #70

  • Accepted query parameter types have been updated from [Any] to [Sendable]. This should cover all supported query parameter types.
  • Query and lock methods' return Result generic types now should extend Sendable.
  • Deprecated default open class PowerSyncBackendConnector. Devs should preferably implement the PowerSyncBackendConnectorProtocol

• Potential Breaking Change: Attachment helpers have been updated to better support Swift 6 strict concurrency checking. Actor isolation is improved, but developers who customize or extend AttachmentQueue will need to update their implementations. The default instantiation of AttachmentQueue remains unchanged.
  AttachmentQueueProtocol now defines the basic requirements for an attachment queue, with most base functionality provided via an extension. Custom implementations should extend AttachmentQueueProtocol.

• Added PowerSyncDynamic product to package. Importing this product should restore XCode preview functionality in #71

• [Internal] Instantiate Kotlin Kermit logger directly in #67

• [Internal] Improved connection context error handling in #69

• Add network logging support in #63
• Update core extension in #65

Full Changelog: 1.3.1...1.4.0

• Update SQLite to 3.50.3.
• Support receiving binary sync lines over HTTP when the Rust client is enabled.
• Remove the experimental websocket transport mode.

• Use version 0.4.2 of the PowerSync core extension, which improves the reliability
  of the new Rust client implementation.
• Add support for raw tables, which
  are custom tables managed by the user instead of JSON-based views managed by the SDK.
• Fix attachments never downloading again when the sandbox path of the app (e.g. on the simulator)
  changes.

• Use version 0.4.1 of the PowerSync core extension, which fixes an issue with the new Rust client implementation.
• Fix crud uploads when web sockets are used as a connection method.

• Improved CrudBatch and CrudTransaction complete function extensions. Developers no longer need to specify nil as an argument for writeCheckpoint when calling CrudBatch.complete. The base complete functions still accept an optional writeCheckpoint argument if developers use custom write checkpoints.

guard let finalBatch = try await powersync.getCrudBatch(limit: 100) else {
  return nil
}
- try await batch.complete(writeCheckpoint: nil)
+ try await batch.complete()

• Fix reported progress around compactions / defrags on the sync service.
• Use version 0.4.0 of the PowerSync core extension, which improves sync performance.
• Add a new sync client implementation written in Rust instead of Kotlin. While this client is still
  experimental, we intend to make it the default in the future. The main benefit of this client is
  faster sync performance, but upcoming features will also require this client. We encourage
  interested users to try it out by opting in to experimental APIs and passing options when
  connecting:

  @_spi(PowerSyncExperimental) import PowerSync
  
  try await db.connect(connector: connector, options: ConnectOptions(
      newClientImplementation: true,
  ))

  Switching between the clients can be done at any time without compatibility issues. If you run
  into issues with the new client, please reach out to us!
• In addition to HTTP streams, the Swift SDK also supports fetching sync instructions from the
  PowerSync service in a binary format. This requires the new sync client, and can then be enabled
  on the sync options:

  @_spi(PowerSyncExperimental) import PowerSync
  
  try await db.connect(connector: connector, options: ConnectOptions(
      newClientImplementation: true,
      connectionMethod: .webSocket,
  ))

• Add sync progress information through SyncStatusData.downloadProgress.
• Add trackPreviousValues option on Table which sets CrudEntry.previousValues to previous values on updates.
• Add trackMetadata option on Table which adds a _metadata column that can be used for updates.
  The configured metadata is available through CrudEntry.metadata.
• Add ignoreEmptyUpdates option which skips creating CRUD entries for updates that don't change any values.

• Improved the stability of watched queries. Watched queries were previously susceptible to runtime crashes if an exception was thrown in the update stream. Errors are now gracefully handled.

• Deprecated PowerSyncCredentials userId field. This value is not used by the PowerSync service.

• Added readLock and writeLock APIs. These methods allow obtaining a SQLite connection context without starting a transaction.

• Removed references to the PowerSync Kotlin SDK from all public API protocols. Dedicated Swift protocols are now defined. These protocols align better with Swift primitives. See the BRAKING CHANGES section for more details. Updated protocols include:

  • ConnectionContext - The context provided by readLock and writeLock
  • Transaction - The context provided by readTransaction and writeTransaction
  • CrudBatch - Response from getCrudBatch
  • CrudTransaction Response from getNextCrudTransaction
  • CrudEntry - Crud entries for CrudBatch and CrudTransaction
  • UpdateType - Operation type for CrudEntrys
  • SqlCursor - Cursor used to map SQLite results to typed result sets
  • JsonParam - JSON parameters used to declare client parameters in the connect method
  • JsonValue - Individual JSON field types for JsonParam

• Database and transaction/lock level query execute methods now have @discardableResult annotation.

• Query methods' parameters typing has been updated to [Any?] from [Any]. This makes passing nil or optional values to queries easier.

• AttachmentContext, AttachmentQueue, AttachmentService and SyncingService are are now explicitly declared as open classes, allowing them to be subclassed outside the defining module.

BREAKING CHANGES:

• Completing CRUD transactions or CRUD batches, in the PowerSyncBackendConnector uploadData handler, now has a simpler invocation.

- _ = try await transaction.complete.invoke(p1: nil)
+ try await transaction.complete()

• index based SqlCursor getters now throw if the query result column value is nil. This is now consistent with the behaviour of named column getter operations. New getXxxxxOptional(index: index) methods are available if the query result value could be nil.

let results = try transaction.getAll(
                sql: "SELECT * FROM my_table",
                parameters: [id]
            ) { cursor in
-                 cursor.getString(index: 0)!
+                 cursor.getStringOptional(index: 0)
+                 // OR
+                 // try cursor.getString(index: 0) // if the value should be required
            }

• SqlCursor getters now directly return Swift types. getLong has been replaced with getInt64.

let results = try transaction.getAll(
                sql: "SELECT * FROM my_table",
                parameters: [id]
            ) { cursor in
-                 cursor.getBoolean(index: 0)?.boolValue,
+                 cursor.getBooleanOptional(index: 0),
-                 cursor.getLong(index: 0)?.int64Value,
+                 cursor.getInt64Optional(index: 0)
+                 // OR
+                 // try cursor.getInt64(index: 0) // if the value should be required
            }

• Client parameters now need to be specified with strictly typed JsonValue enums.

try await database.connect(
    connector: PowerSyncBackendConnector(),
    params: [
-        "foo": "bar"
+        "foo": .string("bar")
    ]
)

• SyncStatus values now use Swift primitives for status attributes. lastSyncedAt now is of Date type.

- let lastTime: Date? = db.currentStatus.lastSyncedAt.map {
-     Date(timeIntervalSince1970: TimeInterval($0.epochSeconds))
- }
+ let time: Date? = db.currentStatus.lastSyncedAt

• crudThrottleMs and retryDelayMs in the connect method have been updated to crudThrottle and retryDelay which are now of type TimeInterval. Previously the parameters were specified in milliseconds, the TimeInterval typing now requires values to be specified in seconds.

try await database.connect(
            connector: PowerSyncBackendConnector(),
-           crudThrottleMs: 1000,
-           retryDelayMs: 5000,
+           crudThrottle: 1,
+           retryDelay: 5,
            params: [
                "foo": .string("bar"),
            ]
        )

• throttleMs in the watched query WatchOptions has been updated to throttle which is now of type TimeInterval. Previously the parameters were specified in milliseconds, the TimeInterval typing now requires values to be specified in seconds.

let stream = try database.watch(
            options: WatchOptions(
                sql: "SELECT name FROM users ORDER BY id",
-               throttleMs: 1000,
+               throttle: 1,
                mapper: { cursor in
                    try cursor.getString(index: 0)
                }
            ))