Client integration

Brand/NCBrand.swift

@@ -25,7 +25,7 @@ final class NCBrandOptions: @unchecked Sendable {
 
     var brand: String = "Nextcloud"
     var brandUserAgent: String = ""
-    var textCopyrightNextcloudiOS: String = "Nextcloud Matheria for iOS %@ © 2025"
+    var textCopyrightNextcloudiOS: String = "Nextcloud Matheria for iOS %@ © 2026"
     var textCopyrightNextcloudServer: String = "Nextcloud Server %@"
     var loginBaseUrl: String = "https://cloud.nextcloud.com"
     var pushNotificationServerProxy: String = ""

File Provider Extension/FileProviderExtension+Actions.swift

@@ -207,7 +207,7 @@ extension FileProviderExtension {
             }
 
             if (favorite == true && !metadata.favorite) || (!favorite && metadata.favorite) {
-                let fileNamePath = NCUtilityFileSystem().getFileNamePath(metadata.fileName, serverUrl: metadata.serverUrl, urlBase: metadata.urlBase, userId: metadata.userId)
+                let fileNamePath = NCUtilityFileSystem().getRelativeFilePath(metadata.fileName, serverUrl: metadata.serverUrl, urlBase: metadata.urlBase, userId: metadata.userId)
                 let resultsFavorite = await  NextcloudKit.shared.setFavoriteAsync(fileName: fileNamePath, favorite: favorite, account: metadata.account)
 
                 if resultsFavorite.error == .success {

Share/NCShareExtension+DataSource.swift

@@ -76,14 +76,12 @@ extension NCShareExtension: UICollectionViewDataSource {
     }
 
     func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
-        let cell = (collectionView.dequeueReusableCell(withReuseIdentifier: "listCell", for: indexPath) as? NCListCell)!
+        var cell = (collectionView.dequeueReusableCell(withReuseIdentifier: "listCell", for: indexPath) as? NCListCell)!
         guard let metadata = self.dataSource.getMetadata(indexPath: indexPath) else {
             return cell
         }
 
-        cell.fileOcId = metadata.ocId
-        cell.fileOcIdTransfer = metadata.ocIdTransfer
-        cell.fileUser = metadata.ownerId
+        cell.metadata = metadata
         cell.labelTitle.text = metadata.fileNameView
         cell.labelTitle.textColor = NCBrandColor.shared.textColor
         cell.imageSelect.image = nil

iOSClient/Activity/NCActivity.swift

@@ -84,9 +84,7 @@ class NCActivity: UIViewController, NCSharePagingContent {
                     self.loadComments()
                 } else {
                     Task {@MainActor in
-                        await showErrorBanner(controller: self.tabBarController,
-                                              errorDescription: error.errorDescription,
-                                              errorCode: error.errorCode)
+                        await showErrorBanner(controller: self.tabBarController, errorDescription: error.errorDescription)
                     }
                 }
             }
@@ -225,9 +223,9 @@ extension NCActivity: UITableViewDataSource {
         let results = NCManageDatabase.shared.getImageAvatarLoaded(fileName: fileName)
 
         if results.image == nil {
-            cell.fileAvatarImageView?.image = utility.loadUserImage(for: comment.actorId, displayName: comment.actorDisplayName, urlBase: NCSession.shared.getSession(account: account).urlBase)
+            cell.avatarImageView?.image = utility.loadUserImage(for: comment.actorId, displayName: comment.actorDisplayName, urlBase: NCSession.shared.getSession(account: account).urlBase)
         } else {
-            cell.fileAvatarImageView?.image = results.image
+            cell.avatarImageView?.image = results.image
         }
 
         if let tblAvatar = results.tblAvatar,
@@ -313,9 +311,9 @@ extension NCActivity: UITableViewDataSource {
             let results = NCManageDatabase.shared.getImageAvatarLoaded(fileName: fileName)
 
             if results.image == nil {
-                cell.fileAvatarImageView?.image = utility.loadUserImage(for: activity.user, displayName: nil, urlBase: session.urlBase)
+                cell.avatarImageView?.image = utility.loadUserImage(for: activity.user, displayName: nil, urlBase: session.urlBase)
             } else {
-                cell.fileAvatarImageView?.image = results.image
+                cell.avatarImageView?.image = results.image
             }
 
             if !(results.tblAvatar?.loaded ?? false),
@@ -441,9 +439,7 @@ extension NCActivity {
                 self.database.addComments(comments, account: metadata.account, objectId: metadata.fileId)
             } else if error.errorCode != NCGlobal.shared.errorResourceNotFound {
                 Task {@MainActor in
-                    await showErrorBanner(controller: self.tabBarController,
-                                          errorDescription: error.errorDescription,
-                                          errorCode: error.errorCode)
+                    await showErrorBanner(controller: self.tabBarController, errorDescription: error.errorDescription)
                 }
             }
 
@@ -583,9 +579,7 @@ extension NCActivity: NCShareCommentsCellDelegate {
                                 self.loadComments()
                             } else {
                                 Task {@MainActor in
-                                    await showErrorBanner(controller: self.tabBarController,
-                                                          errorDescription: error.errorDescription,
-                                                          errorCode: error.errorCode)
+                                    await showErrorBanner(controller: self.tabBarController, errorDescription: error.errorDescription)
                                 }
                             }
                         }
@@ -617,9 +611,7 @@ extension NCActivity: NCShareCommentsCellDelegate {
                             self.loadComments()
                         } else {
                             Task {@MainActor in
-                                await showErrorBanner(controller: self.tabBarController,
-                                                      errorDescription: error.errorDescription,
-                                                      errorCode: error.errorCode)
+                                await showErrorBanner(controller: self.tabBarController, errorDescription: error.errorDescription)
                             }
                         }
                     }

iOSClient/Activity/NCActivityTableViewCell.swift

@@ -37,7 +37,7 @@ class NCActivityTableViewCell: UITableViewCell, NCCellProtocol {
         get { return index }
         set { index = newValue }
     }
-    var fileAvatarImageView: UIImageView? {
+    var avatarImageView: UIImageView? {
         return avatar
     }
     var fileUser: String? {
@@ -86,9 +86,7 @@ extension NCActivityTableViewCell: UICollectionViewDelegate {
                     } else {
                         let error = NKError(errorCode: NCGlobal.shared.errorInternalError, errorDescription: "_trash_file_not_found_")
                         Task {@MainActor in
-                            await showErrorBanner(controller: viewController.controller,
-                                                  errorDescription: error.errorDescription,
-                                                  errorCode: error.errorCode)
+                            await showErrorBanner(controller: viewController.controller, errorDescription: error.errorDescription)
                         }
                     }
                 }

iOSClient/AppDelegate.swift

@@ -14,7 +14,6 @@ import EasyTipView
 import SwiftUI
 import RealmSwift
 
-@UIApplicationMain
 class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate {
     var backgroundSessionCompletionHandler: (() -> Void)?
     var isUiTestingEnabled: Bool {
@@ -408,7 +407,7 @@ class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterD
                 Task {
                     await NCNetworking.shared.transferDispatcher.notifyAllDelegatesAsync { delegate in
                         try? await Task.sleep(nanoseconds: 500_000_000)
-                        delegate.transferReloadData(serverUrl: nil, requestData: true, status: nil)
+                        delegate.transferReloadDataSource(serverUrl: nil, requestData: true, status: nil)
                     }
                 }
             } else if let navigationController = UIStoryboard(name: "NCNotification", bundle: nil).instantiateInitialViewController() as? UINavigationController,

iOSClient/Client Integration/ClientIntegrationUIViewer.swift

@@ -0,0 +1,83 @@
+// SPDX-FileCopyrightText: Nextcloud GmbH
+// SPDX-FileCopyrightText: 2025 Milen Pivchev
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+import SwiftUI
+
+struct ClientIntegrationUIViewer: View {
+    @Environment(\.openURL) private var openURL
+
+    struct Row: Identifiable {
+        let id = UUID()
+        let element: String
+        let title: String?
+        let urlString: String
+    }
+
+    // Configurable inputs
+    let rows: [Row]
+    let baseURL: String
+
+    var body: some View {
+        ScrollView {
+            LazyVStack(alignment: .leading, spacing: 12) {
+                ForEach(rows) { row in
+                    VStack(alignment: .leading, spacing: 8) {
+                        HStack {
+                            Text(row.element)
+                                .font(.subheadline)
+                                .fontWeight(.semibold)
+                                .foregroundStyle(.secondary)
+                            Spacer()
+                        }
+
+                        if let title = row.title {
+                            Text(title).font(.headline)
+                        }
+
+                        let finalUrl = baseURL + row.urlString
+
+                        Text(finalUrl)
+                            .font(.footnote)
+                            .foregroundStyle(.secondary)
+                            .textSelection(.enabled)
+
+                        HStack(spacing: 12) {
+                            Button {
+                                openURL(URL(string: finalUrl)!)
+                            } label: {
+                                Label("Open", systemImage: "safari")
+                            }
+
+                            Button {
+                                UIPasteboard.general.string = row.urlString
+                            } label: {
+                                Label("Copy", systemImage: "doc.on.doc")
+                            }
+                        }
+                        .buttonStyle(.borderedProminent)
+                    }
+                    .padding()
+                    .background(.thinMaterial, in: RoundedRectangle(cornerRadius: 12))
+                }
+            }
+            .padding()
+        }
+    }
+
+    //    private func resolvedURL(for row: Row) -> URL? {
+    //        // If the string is already an absolute URL with a scheme, use it.
+    //        if let absolute = URL(string: row.urlString), absolute.scheme != nil {
+    //            return absolute
+    //        }
+    //        // Otherwise, resolve relative to the provided base URL if available.
+    //        if let baseURL {
+    //            return URL(string: row.urlString, relativeTo: baseURL)?.absoluteURL
+    //        }
+    //        return nil
+    //    }
+}
+
+#Preview {
+    ClientIntegrationUIViewer(rows: [.init(element: "URL", title: "Test", urlString: "/test")], baseURL: "test.com")
+}

iOSClient/Data/NCManageDatabase+Metadata.swift

@@ -125,6 +125,13 @@ class tableMetadata: Object {
     @objc dynamic var autoUploadServerUrlBase: String?
     @objc dynamic var typeIdentifier: String = ""
 
+    // =========================
+    // UI / transient properties
+    // =========================
+
+    /// Used only for UI state (not persisted, not observed by Realm)
+    var isOffline: Bool = false
+
     override static func primaryKey() -> String {
         return "ocId"
     }

iOSClient/DeepLink/NCDeepLinkHandler.swift

@@ -116,7 +116,7 @@ class NCDeepLinkHandler {
         DispatchQueue.main.asyncAfter(deadline: .now() + 4) {
             let serverUrl = controller.currentServerUrl()
             let session = NCSession.shared.getSession(controller: controller)
-            let fileFolderPath = NCUtilityFileSystem().getFileNamePath("", serverUrl: serverUrl, session: session)
+            let fileFolderPath = NCUtilityFileSystem().getRelativeFilePath("", serverUrl: serverUrl, session: session)
             let fileFolderName = (serverUrl as NSString).lastPathComponent
             let capabilities = NCNetworking.shared.capabilities[controller.account] ?? NKCapabilities.Capabilities()
 

iOSClient/Files/NCFiles.swift

@@ -321,16 +321,12 @@ class NCFiles: NCCollectionViewCommon {
                 NCContentPresenter().showInfo(description: "Metadata not found")
                 let error = await NCNetworkingE2EE().uploadMetadata(serverUrl: serverUrl, account: account)
                 if error != .success {
-                    await showErrorBanner(controller: self.controller,
-                                          errorDescription: error.errorDescription,
-                                          errorCode: error.errorCode)
+                    await showErrorBanner(controller: self.controller, errorDescription: error.errorDescription)
                 }
             } else {
                 // show error
                 Task {@MainActor in
-                    await showErrorBanner(controller: self.controller,
-                                          errorDescription: error.errorDescription,
-                                          errorCode: error.errorCode)
+                    await showErrorBanner(controller: self.controller, errorDescription: error.errorDescription)
                 }
             }
 
@@ -350,9 +346,7 @@ class NCFiles: NCCollectionViewCommon {
                 let error = await NCNetworkingE2EE().uploadMetadata(serverUrl: serverUrl, updateVersionV1V2: true, account: account)
                 if error != .success {
                     Task {@MainActor in
-                        await showErrorBanner(controller: self.controller,
-                                              errorDescription: error.errorDescription,
-                                              errorCode: error.errorCode)
+                        await showErrorBanner(controller: self.controller, errorDescription: error.errorDescription)
                     }
                 }
                 NCActivityIndicator.shared.stop()
@@ -361,9 +355,7 @@ class NCFiles: NCCollectionViewCommon {
             // Client Diagnostic
             await self.database.addDiagnosticAsync(account: account, issue: NCGlobal.shared.diagnosticIssueE2eeErrors)
             Task {@MainActor in
-                await showErrorBanner(controller: self.controller,
-                                      errorDescription: error.errorDescription,
-                                      errorCode: error.errorCode)
+                await showErrorBanner(controller: self.controller, errorDescription: error.errorDescription)
             }
         }
 

iOSClient/GUI/Lucid Banner/ErrorBannerView.swift

@@ -6,13 +6,13 @@ import SwiftUI
 import LucidBanner
 
 @MainActor
-func showErrorBanner(controller: UITabBarController?, errorDescription: String, errorCode: Int, sleepBefore: Double = 1) async {
+func showErrorBanner(controller: UITabBarController?, errorDescription: String, footnote: String? = nil, sleepBefore: Double = 1) async {
     let scene = SceneManager.shared.getWindow(controller: controller)?.windowScene
-    await showErrorBanner(scene: scene, errorDescription: errorDescription, errorCode: errorCode, sleepBefore: sleepBefore)
+    await showErrorBanner(scene: scene, errorDescription: errorDescription, footnote: footnote, sleepBefore: sleepBefore)
 }
 
 @MainActor
-func showErrorBanner(scene: UIWindowScene?, errorDescription: String, errorCode: Int, sleepBefore: Double = 1) async {
+func showErrorBanner(scene: UIWindowScene?, errorDescription: String, footnote: String? = nil, sleepBefore: Double = 1) async {
     try? await Task.sleep(nanoseconds: UInt64(sleepBefore * 1e9))
     var scene = scene
     if scene == nil {
@@ -22,7 +22,7 @@ func showErrorBanner(scene: UIWindowScene?, errorDescription: String, errorCode:
     LucidBanner.shared.show(
         scene: scene,
         subtitle: errorDescription,
-        footnote: "(Code: \(errorCode))",
+        footnote: footnote,
         vPosition: .top,
         autoDismissAfter: NCGlobal.shared.dismissAfterSecond,
         swipeToDismiss: true,

iOSClient/GUI/Lucid Banner/HudBannerView.swift

@@ -208,7 +208,6 @@ struct HudBannerView: View {
     @ViewBuilder
     func containerView<Content: View>(@ViewBuilder _ content: () -> Content) -> some View {
         let cornerRadius: CGFloat = 22
-        let opacity = 0.65
         let backgroundColor = Color(.systemBackground).opacity(0.65)
 
         if #available(iOS 26, *) {