[Release] | 4.0.0 (#55)

Author: tl-fabrizio-scarano

CHANGELOG.md

@@ -1,13 +1,33 @@
 # Changelog
 All notable changes to this project will be documented in this file. To know better on how to write and maintain a changelog, refer to [this link](https://keepachangelog.com/en/1.0.0/).
 
+## [4.0.0] - New UI
+
+### Added
+- A new, gorgeous, conversion-driven UI in parity with the 2025 TrueLayer Web Hosted Payments Page, with the following new features available automatically for all devices running iOS 15 and up on GBP and EUR+Ireland single payments:
+  - A single-screen, modern, declarative UI system under the hood, allowing for smooth transitions and overall snappier look-and-feel.
+  - Retries: change bank / payment providers on the fly, or retry failed payments without restarting the SDK.
+  - Cancellation screen streamlining: more insight on why users are abandoning their payments.
+  - Provider pre-selection: automatically select the last used provider, allowing for faster one-click payments and more engaged, better converting users.
+
+Heads-up: the following requests do not support the New UI and will fallback onto the legacy UI, as seen in versions 3.9.1 and below:
+ - Devices running iOS 14.x
+ - Mandates / recurring payments
+ - EUR payments for countries other than Ireland-only
+
+### Changed
+- Several quality-of-life and performance improvements under the hood, allowing for improved reliability, faster performance, and better troubleshooting of the SDK overall.
+
+### Removed
+- The previously deprecated `.redirect` case has now been removed.
+
 ## [3.9.1] - AIS+PIS QoL and Patches
 
 ### Fixed
 - A crash where an attempt to fill the provider selection list with duplicate providers was made, which is now handled gracefully as unexpected behavior.
 - Some cases where the user would get stuck on a Wait screen, especially when prompted by the bank to confirm the TrueLayer transaction in their banking app.
 - Routing logic for certain providers requesting a PIS-only flow.
-- An issue with the Scheme Selection screen when the Continue button would not get disabled while processing, which has previously manifested for a very small percentage of users on slower network connections.
+- An issue with the Scheme Selection screen when the Continue button would not get disabled while processing, which previously manifested for a very small percentage of users on slower network connections.
 
 ## [3.9.0] - AIS+PIS Flow
 

Frameworks/TrueLayerAPI.xcframework/Info.plist

@@ -8,32 +8,32 @@
 			<key>BinaryPath</key>
 			<string>TrueLayerAPI.framework/TrueLayerAPI</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-simulator</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
 			<string>TrueLayerAPI.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
 		</dict>
 		<dict>
 			<key>BinaryPath</key>
 			<string>TrueLayerAPI.framework/TrueLayerAPI</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64</string>
+			<string>ios-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>TrueLayerAPI.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>

Frameworks/TrueLayerAPI.xcframework/ios-arm64/TrueLayerAPI.framework/Info.plist

@@ -85,7 +85,7 @@ import _SwiftConcurrencyShims
     @_spi(TrueLayer) public func getLegalCopy(for providerCountryCode: Swift.String) async throws -> TrueLayerCore.Core.Payments.Models.Shared.ActionableCopy
     @_spi(TrueLayer) public func getProvider(with providerID: Swift.String) async throws -> TrueLayerCore.Core.Payments.Models.Shared.Provider
     @_spi(TrueLayer) public func submitConsent() async throws -> TrueLayerCore.Core.Payments.Models.Mandate.AuthorizationFlow.Status
-    @_spi(TrueLayer) public func cancelMandate() async throws
+    @_spi(TrueLayer) public func cancelMandate(providerID: Swift.String?, reason: Swift.String?, comment: Swift.String?) async throws
     @_spi(TrueLayer) public func submitUserAccountSelection(userAccountID: Swift.String) async throws -> TrueLayerCore.Core.Payments.Models.Mandate.AuthorizationFlow.Status
     @_spi(TrueLayer) public func submitNewUserAccountSelection() async throws -> TrueLayerCore.Core.Payments.Models.Mandate.AuthorizationFlow.Status
     @_spi(TrueLayer) public func deleteUserAccount(userAccountID: Swift.String) async throws -> TrueLayerCore.Core.Payments.Models.Mandate.AuthorizationFlow.Status
@@ -118,19 +118,19 @@ import _SwiftConcurrencyShims
     @_spi(TrueLayer) public func getPISLegalCopy(providerCountryCode: Swift.String) async throws -> TrueLayerCore.Core.Payments.Models.Shared.PISLegals
     @_spi(TrueLayer) public func getUserPriming(providerIdentifier: TrueLayerCore.Core.Payments.Models.Shared.Provider.Identifier) async throws -> TrueLayerCore.Core.Payments.Models.Shared.Provider.UserPriming.Status
     @_spi(TrueLayer) public func getProvider(with providerID: Swift.String) async throws -> TrueLayerCore.Core.Payments.Models.Shared.Provider
+    @_spi(TrueLayer) public func getCancellationFormInformation(providerId: Swift.String?) async throws -> TrueLayerCore.Core.Payments.Models.Shared.CancellationFormInformation
   }
 }
 @_spi(TrueLayer) extension TrueLayerAPI.API.Payments.Requests.Manager {
   @_spi(TrueLayer) public struct SinglePayment : TrueLayerAPI.RequestsManager {
     @_spi(TrueLayer) public init(using configuration: any TrueLayerAPI.RequestsManagerConfigurationProvider)
     @_spi(TrueLayer) public func getPaymentInformation() async throws -> TrueLayerCore.Core.Payments.Models.SinglePayment.Information
-    @_spi(TrueLayer) public func pollPaymentStatus(shouldEndPollingPrematurely: @escaping (TrueLayerCore.Core.Payments.Models.SinglePayment.Status) -> Swift.Bool) async throws -> TrueLayerCore.Core.Payments.Models.SinglePayment.Status
+    @_spi(TrueLayer) public func pollPaymentStatus(pollingInterval: Foundation.TimeInterval, shouldEndPollingPrematurely: @escaping (TrueLayerCore.Core.Payments.Models.SinglePayment.Status) -> Swift.Bool) async throws -> TrueLayerCore.Core.Payments.Models.SinglePayment.Status
     @_spi(TrueLayer) public func startAuthorization() async throws -> TrueLayerCore.Core.Payments.Models.SinglePayment.AuthorizationFlow.Status
     @_spi(TrueLayer) public func submitProviderSelection(_ providerIdentifier: TrueLayerCore.Core.Payments.Models.Shared.Provider.Identifier) async throws -> TrueLayerCore.Core.Payments.Models.SinglePayment.AuthorizationFlow.Status
     @_spi(TrueLayer) public func submitConsent() async throws -> TrueLayerCore.Core.Payments.Models.SinglePayment.AuthorizationFlow.Status
-    #warning("Moved to shared")
     @_spi(TrueLayer) public func getLegalCopy(for providerCountryCode: Swift.String) async throws -> TrueLayerCore.Core.Payments.Models.Shared.ActionableCopy
-    @_spi(TrueLayer) public func cancelPayment() async throws
+    @_spi(TrueLayer) public func cancelPayment(providerID: Swift.String?, reason: Swift.String?, comment: Swift.String?) async throws
     @_spi(TrueLayer) public func getAdditionalInputsHelpText(with providerCountryCode: Swift.String) async throws -> [TrueLayerCore.Core.Payments.Models.SinglePayment.AuthorizationFlow.AdditionalInputs.HelpText]
     @_spi(TrueLayer) public func getAdditionalInputsLocalizations(countryCode: Swift.String) async throws -> [TrueLayerCore.Core.Payments.Models.SinglePayment.AuthorizationFlow.AdditionalInputs.Localization]
     @_spi(TrueLayer) public func submitForm(inputs: [Swift.String : Swift.String], adjacent: TrueLayerCore.Core.Payments.Models.Shared.Adjacent?) async throws -> TrueLayerCore.Core.Payments.Models.SinglePayment.AuthorizationFlow.Status
@@ -139,6 +139,8 @@ import _SwiftConcurrencyShims
     @_spi(TrueLayer) public func deleteUserAccount(userAccountID: Swift.String) async throws -> TrueLayerCore.Core.Payments.Models.SinglePayment.AuthorizationFlow.Status
     @_spi(TrueLayer) public func getSchemeSelectionType(currency: Swift.String, schemes: [Swift.String]) async throws -> TrueLayerCore.Core.Payments.Models.SinglePayment.Scheme.SelectionType
     @_spi(TrueLayer) public func submitScheme(_ schemeIdentifier: TrueLayerCore.Core.Payments.Models.SinglePayment.Scheme.Identifier) async throws -> TrueLayerCore.Core.Payments.Models.SinglePayment.AuthorizationFlow.Status
+    @_spi(TrueLayer) public func getProvidersInfo(paymentID: Swift.String) async throws -> TrueLayerCore.Core.Payments.Models.SinglePayment.ProvidersInfo
+    @_spi(TrueLayer) public func retryPayment() async throws -> TrueLayerCore.Core.Payments.Models.SinglePayment.Status
   }
 }
 @_spi(TrueLayer) extension TrueLayerAPI.API {