feat: Supporting file lock types.

- Removed unnecessary wrapper implementation and use new file locking method from NextcloudKit directly.
- Improved logging in Item+LockFile.swift based on recently introduced logging system.
- Introduced new key to FileProviderLogDetailKey for NKLock objects.
- Introduced SchemaVersion enum for cleaner references to Realm schema versions.
- Introduced lockToken property to data models representing an item.

Signed-off-by: Iva Horn <iva.horn@icloud.com>

Author: i2h3

Sources/NextcloudFileProviderKit/Database/FilesDatabaseManager.swift

@@ -5,9 +5,6 @@ import FileProvider
 import Foundation
 import RealmSwift
 
-internal let stable1_0SchemaVersion: UInt64 = 100
-internal let stable2_0SchemaVersion: UInt64 = 200 // Major change: deleted LocalFileMetadata type
-
 ///
 /// Realm database abstraction and management.
 ///
@@ -43,7 +40,7 @@ public final class FilesDatabaseManager: Sendable {
         )
     }
 
-    private static let schemaVersion = stable2_0SchemaVersion
+    private static let schemaVersion = SchemaVersion.addedLockTokenPropertyToRealmItemMetadata
     let logger: FileProviderLogger
     let account: Account
 
@@ -115,9 +112,9 @@ public final class FilesDatabaseManager: Sendable {
 
         let configuration = customConfiguration ?? Realm.Configuration(
             fileURL: databaseLocation,
-            schemaVersion: Self.schemaVersion,
+            schemaVersion: Self.schemaVersion.rawValue,
             migrationBlock: { migration, oldSchemaVersion in
-                if oldSchemaVersion == stable1_0SchemaVersion {
+                if oldSchemaVersion == SchemaVersion.initial.rawValue {
                     var localFileMetadataOcIds = Set<String>()
 
                     migration.enumerateObjects(ofType: "LocalFileMetadata") { oldObject, _ in
@@ -171,7 +168,7 @@ public final class FilesDatabaseManager: Sendable {
 
         logger.info("Migrating shared legacy database to new database for \(account.ncKitAccount)")
 
-        let legacyConfiguration = Realm.Configuration(fileURL: sharedDatabaseURL, schemaVersion: stable2_0SchemaVersion, objectTypes: [RealmItemMetadata.self, RemoteFileChunk.self])
+        let legacyConfiguration = Realm.Configuration(fileURL: sharedDatabaseURL, schemaVersion: SchemaVersion.deletedLocalFileMetadata.rawValue, objectTypes: [RealmItemMetadata.self, RemoteFileChunk.self])
 
         do {
             let legacyRealm = try Realm(configuration: legacyConfiguration)

Sources/NextcloudFileProviderKit/Database/SchemaVersion.swift

@@ -0,0 +1,11 @@
+//  SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+//  SPDX-License-Identifier: GPL-2.0-or-later
+
+///
+/// Different schema versions shipped with this project.
+///
+enum SchemaVersion: UInt64 {
+    case initial = 100
+    case deletedLocalFileMetadata = 200
+    case addedLockTokenPropertyToRealmItemMetadata = 201
+}

Sources/NextcloudFileProviderKit/Extensions/NKFile+Extensions.swift

@@ -63,13 +63,14 @@ extension NKFile {
             note: note,
             ownerId: ownerId,
             ownerDisplayName: ownerDisplayName,
-            lock: lock,
-            lockOwner: lockOwner,
-            lockOwnerEditor: lockOwnerEditor,
-            lockOwnerType: lockOwnerType,
-            lockOwnerDisplayName: lockOwnerDisplayName,
-            lockTime: lockTime,
-            lockTimeOut: lockTimeOut,
+            lock: lock != nil ? true : false,
+            lockOwner: lock?.owner,
+            lockOwnerEditor: lock?.ownerEditor,
+            lockOwnerType: lock?.ownerType.rawValue,
+            lockOwnerDisplayName: lock?.ownerDisplayName,
+            lockTime: lock?.time,
+            lockTimeOut: lock?.timeOut,
+            lockToken: lock?.token,
             path: path,
             permissions: permissions,
             quotaUsedBytes: quotaUsedBytes,

Sources/NextcloudFileProviderKit/Interface/NextcloudKit+RemoteInterface.swift

@@ -304,20 +304,8 @@ extension NextcloudKit: RemoteInterface {
         }
     }
 
-    public func setLockStateForFile(
-        remotePath: String,
-        lock: Bool,
-        account: Account,
-        options: NKRequestOptions,
-        taskHandler: @escaping (_ task: URLSessionTask) -> Void
-    ) async -> (account: String, response: HTTPURLResponse?, error: NKError) {
-        return await withCheckedContinuation { continuation in
-            lockUnlockFile(
-                serverUrlFileName: remotePath, shouldLock: lock, account: account.ncKitAccount
-            ) { account, response, error in
-                continuation.resume(returning: (account, response?.response, error))
-            }
-        }
+    public func lockUnlockFile(serverUrlFileName: String, type: NKLockType?, shouldLock: Bool, account: Account, options: NKRequestOptions, taskHandler: @escaping (URLSessionTask) -> Void) async throws -> NKLock? {
+        return try await lockUnlockFile(serverUrlFileName: serverUrlFileName, type: type, shouldLock: shouldLock, account: account.ncKitAccount, options: options, taskHandler: taskHandler)
     }
 
     public func trashedItems(

Sources/NextcloudFileProviderKit/Interface/RemoteInterface.swift

@@ -125,13 +125,7 @@ public protocol RemoteInterface {
         taskHandler: @escaping (_ task: URLSessionTask) -> Void
     ) async -> (account: String, response: HTTPURLResponse?, error: NKError)
 
-    func setLockStateForFile(
-        remotePath: String,
-        lock: Bool,
-        account: Account,
-        options: NKRequestOptions,
-        taskHandler: @escaping (_ task: URLSessionTask) -> Void
-    ) async -> (account: String, response: HTTPURLResponse?, error: NKError)
+    func lockUnlockFile(serverUrlFileName: String, type: NKLockType?, shouldLock: Bool, account: Account, options: NKRequestOptions, taskHandler: @escaping (_ task: URLSessionTask) -> Void) async throws -> NKLock?
 
     func trashedItems(
         account: Account,