feat: initial implementation

Author: andredestro

.github/workflows/github_actions.yml

@@ -27,12 +27,14 @@ jobs:
         SLACK_WEBHOOK: ${{ secrets.SLACK_WEBHOOK }}
     - name: Code Coverage
       run: bundle exec fastlane coverage
-    - name: Lint
-      run: bundle exec fastlane lint
-    - name: Setup sonarqube
-      uses: warchant/setup-sonar-scanner@v8
-    - name: Send to Sonarcloud
-      run: bundle exec fastlane sonarqube
-      env: 
-        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        SONAR_TOKEN: ${{ secrets.SONARCLOUD_KEY }}
+    # Commenting Lint steps for now, until we fix the workflow process
+    # - name: Lint
+    #   run: bundle exec fastlane lint
+    # Commenting Sonarqube steps for now, until we are able to configure Sonarqube in Ionic repos
+    # - name: Setup sonarqube
+    #   uses: warchant/setup-sonar-scanner@v8
+    # - name: Send to Sonarcloud
+    #   run: bundle exec fastlane sonarqube
+    #   env: 
+    #     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    #     SONAR_TOKEN: ${{ secrets.SONARCLOUD_KEY }}

.gitignore

@@ -88,3 +88,6 @@ fastlane/test_output
 # https://github.com/johnno1962/injectionforxcode
 
 iOSInjectionProject/
+
+# macOS system files
+.DS_Store

docs/CHANGELOG.md renamed to CHANGELOG.md

@@ -4,8 +4,8 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-### 2024-02-01
-- Fix: Update `github_actions.yml` file steps versions (https://outsystemsrd.atlassian.net/browse/RMET-2568).
+## [Unreleased]
 
-### 2022-04-12
-- Create repository.
+### 2025-04-14
+
+- Implement native library with methods `downloadFile` and `uploadFile`.

Gemfile

@@ -1,4 +1,4 @@
 source "https://rubygems.org"
 
 gem "fastlane"
-gem "slather"
+gem "slather"

IONFileTransferLib.podspec

@@ -0,0 +1,17 @@
+Pod::Spec.new do |spec|
+  spec.name                   = 'IONFileTransferLib'
+  spec.version                = '1.0.0'
+
+  spec.summary                = 'A native iOS library for download and upload files.'
+  spec.description            = 'A Swift library for iOS that provides simple way to download and upload files. Download and upload files with a secure, clean and modern API.'
+
+  spec.homepage               = 'https://github.com/ionic-team/ion-ios-filetransfer'
+  spec.license                = { :type => 'MIT', :file => 'LICENSE' }
+  spec.author                 = { 'OutSystems Mobile Ecosystem' => '[email protected]' }
+  
+  spec.source                 = { :http => "https://github.com/ionic-team/ion-ios-filetransfer/releases/download/#{spec.version}/IONFileTransferLib.zip", :type => "zip" }
+  spec.vendored_frameworks    = 'IONFileTransferLib.xcframework'
+
+  spec.ios.deployment_target  = '14.0'
+  spec.swift_versions         = ['5.0', '5.1', '5.2', '5.3', '5.4', '5.5', '5.6', '5.7', '5.8', '5.9']
+end

IONFileTransferLib.xcodeproj/project.pbxproj

@@ -15,9 +15,9 @@
             <BuildableReference
                BuildableIdentifier = "primary"
                BlueprintIdentifier = "7507FC1127FC2AAE003809F6"
-               BuildableName = "IONFileTrasnsferLib.framework"
-               BlueprintName = "IONFileTrasnsferLib"
-               ReferencedContainer = "container:IONFileTrasnsferLib.xcodeproj">
+               BuildableName = "IONFileTransferLib.framework"
+               BlueprintName = "IONFileTransferLib"
+               ReferencedContainer = "container:IONFileTransferLib.xcodeproj">
             </BuildableReference>
          </BuildActionEntry>
       </BuildActionEntries>
@@ -34,9 +34,9 @@
             <BuildableReference
                BuildableIdentifier = "primary"
                BlueprintIdentifier = "7507FC1927FC2AAE003809F6"
-               BuildableName = "IONFileTrasnsferLibTests.xctest"
-               BlueprintName = "IONFileTrasnsferLibTests"
-               ReferencedContainer = "container:IONFileTrasnsferLib.xcodeproj">
+               BuildableName = "IONFileTransferLibTests.xctest"
+               BlueprintName = "IONFileTransferLibTests"
+               ReferencedContainer = "container:IONFileTransferLib.xcodeproj">
             </BuildableReference>
          </TestableReference>
       </Testables>
@@ -62,9 +62,9 @@
          <BuildableReference
             BuildableIdentifier = "primary"
             BlueprintIdentifier = "7507FC1127FC2AAE003809F6"
-            BuildableName = "IONFileTrasnsferLib.framework"
-            BlueprintName = "IONFileTrasnsferLib"
-            ReferencedContainer = "container:IONFileTrasnsferLib.xcodeproj">
+            BuildableName = "IONFileTransferLib.framework"
+            BlueprintName = "IONFileTransferLib"
+            ReferencedContainer = "container:IONFileTransferLib.xcodeproj">
          </BuildableReference>
       </MacroExpansion>
    </ProfileAction>

IONFileTrasnsferLib.xcodeproj/project.xcworkspace/contents.xcworkspacedata renamed to IONFileTransferLib.xcodeproj/project.xcworkspace/contents.xcworkspacedata

@@ -0,0 +1,78 @@
+import Foundation
+
+/// A base delegate class for common upload and download task behaviors in a `URLSession`.
+///
+/// `IONFLTRBaseDelegate` provides shared logic for handling task completion and HTTP redirection.
+/// It is intended to be subclassed by specific delegates like `IONFLTRDownloadDelegate` and `IONFLTRUploadDelegate`.
+///
+/// This class communicates progress, success, and failure through a provided `IONFLTRPublisher`.
+///
+/// - Note: This class does not conform to any URLSession delegate protocols directly. Subclasses should conform to the appropriate protocols as needed.
+class IONFLTRBaseDelegate: NSObject {
+
+    /// The publisher used to send progress, success, and failure updates.
+    let publisher: IONFLTRPublisher
+
+    /// A flag indicating whether HTTP redirects should be disabled.
+    let disableRedirects: Bool
+
+    /// Initializes a new instance of the `IONFLTRBaseDelegate` class.
+    ///
+    /// - Parameters:
+    ///   - publisher: The publisher used to communicate task updates.
+    ///   - disableRedirects: A flag indicating whether HTTP redirects should be disabled. Defaults to `false`.
+    init(publisher: IONFLTRPublisher, disableRedirects: Bool = false) {
+        self.publisher = publisher
+        self.disableRedirects = disableRedirects
+    }
+
+    /// Handles the completion of a URL session task.
+    ///
+    /// This method checks for errors and evaluates the HTTP response. If the response code indicates a failure (non-2xx),
+    /// it emits a failure event through the publisher with a structured `IONFLTRException`.
+    ///
+    /// - Parameters:
+    ///   - task: The `URLSessionTask` that completed.
+    ///   - error: The error that occurred, if any.
+    func handleCompletion(task: URLSessionTask, error: Error?) {
+        if let error = error {
+            publisher.sendFailure(error)
+            return
+        }
+
+        guard let response = task.response as? HTTPURLResponse,
+              !(200...299).contains(response.statusCode) else {
+            return
+        }
+
+        let headers = response.allHeaderFields.reduce(into: [String: String]()) { result, element in
+            if let key = element.key as? String, let value = element.value as? String {
+                result[key] = value
+            }
+        }
+
+        publisher.sendFailure(
+            IONFLTRException.httpError(
+                responseCode: response.statusCode,
+                responseBody: nil,
+                headers: headers
+            )
+        )
+    }
+
+    /// Handles HTTP redirection behavior.
+    ///
+    /// This method determines whether or not to allow an HTTP redirect based on the `disableRedirects` flag.
+    ///
+    /// - Parameters:
+    ///   - response: The `HTTPURLResponse` that triggered the redirection.
+    ///   - request: The new `URLRequest` to which the task is being redirected.
+    ///   - completionHandler: A closure that receives the request to continue with or `nil` to block the redirect.
+    func handleRedirect(
+        response: HTTPURLResponse,
+        request: URLRequest,
+        completionHandler: @escaping (URLRequest?) -> Void
+    ) {
+        completionHandler(disableRedirects ? nil : request)
+    }
+}