Moved the Amiibo API implementation to its own package (#2)

This PR contains the work done to migrate the *almost* completed**Amiibo API** implementation done in another project to its own stand-alone package.

Reviewed-on: rock-n-code/amiibo-api#2
Co-authored-by: Javier Cicchelli <javier@rock-n-code.com>
Co-committed-by: Javier Cicchelli <javier@rock-n-code.com>

Sources/Internal/Extensions/Client+Properties.swift

@@ -0,0 +1,29 @@
+//===----------------------------------------------------------------------===
+//
+// This source file is part of the AmiiboAPI open source project
+//
+// Copyright (c) 2024 Röck+Cöde VoF. and the AmiiboAPI project authors
+// Licensed under the EUPL 1.2 or later.
+//
+// See LICENSE for license information
+// See CONTRIBUTORS for the list of AmiiboAPI project authors
+//
+//===----------------------------------------------------------------------===
+
+import OpenAPIURLSession
+
+extension Client {
+    
+    // MARK: Constants
+    
+    static var live: Client {
+        get throws {
+            .init(
+                serverURL: try Servers.server1(),
+                configuration: .init(dateTranscoder: ISODateTranscoder()),
+                transport: URLSessionTransport()
+            )
+        }
+    }
+    
+}

Sources/Internal/Extensions/DateFormatter+Properties.swift

@@ -0,0 +1,26 @@
+//===----------------------------------------------------------------------===
+//
+// This source file is part of the AmiiboAPI open source project
+//
+// Copyright (c) 2024 Röck+Cöde VoF. and the AmiiboAPI project authors
+// Licensed under the EUPL 1.2 or later.
+//
+// See LICENSE for license information
+// See CONTRIBUTORS for the list of AmiiboAPI project authors
+//
+//===----------------------------------------------------------------------===
+
+import Foundation
+
+extension DateFormatter {
+    
+    static var isoDateTime: DateFormatter {
+        let formatter = DateFormatter()
+        
+        formatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ss.SSSSSS"
+        formatter.timeZone = .init(secondsFromGMT: 0)
+        
+        return formatter
+    }
+    
+}

Sources/Internal/Protocols/APIClient.swift

@@ -0,0 +1,26 @@
+//===----------------------------------------------------------------------===
+//
+// This source file is part of the AmiiboAPI open source project
+//
+// Copyright (c) 2024 Röck+Cöde VoF. and the AmiiboAPI project authors
+// Licensed under the EUPL 1.2 or later.
+//
+// See LICENSE for license information
+// See CONTRIBUTORS for the list of AmiiboAPI project authors
+//
+//===----------------------------------------------------------------------===
+
+import Foundation
+
+public protocol APIClient {
+    
+    // MARK: Functions
+    
+    func getAmiibos(by filter: AmiiboFilter) async throws -> [Amiibo]
+    func getAmiiboSeries(by filter: AmiiboSeriesFilter) async throws -> [AmiiboSeries]
+    func getAmiiboTypes(by filter: AmiiboTypeFilter) async throws -> [AmiiboType]
+    func getGameCharacters(by filter: GameCharacterFilter) async throws -> [GameCharacter]
+    func getGameSeries(by filter: GameSeriesFilter) async throws -> [GameSeries]
+    func getLastUpdated() async throws -> Date
+    
+}

Sources/Internal/Protocols/KeyNameFilter.swift

@@ -0,0 +1,26 @@
+//===----------------------------------------------------------------------===
+//
+// This source file is part of the AmiiboAPI open source project
+//
+// Copyright (c) 2024 Röck+Cöde VoF. and the AmiiboAPI project authors
+// Licensed under the EUPL 1.2 or later.
+//
+// See LICENSE for license information
+// See CONTRIBUTORS for the list of AmiiboAPI project authors
+//
+//===----------------------------------------------------------------------===
+
+protocol KeyNameFilter {
+    
+    // MARK: Properties
+    
+    var key: String? { get }
+    var name: String? { get }
+    
+    // MARK: Initialisers
+    
+    init()
+    init(key: String)
+    init(name: String)
+    
+}

Sources/Internal/Protocols/KeyNameModel.swift

@@ -0,0 +1,24 @@
+//===----------------------------------------------------------------------===
+//
+// This source file is part of the AmiiboAPI open source project
+//
+// Copyright (c) 2024 Röck+Cöde VoF. and the AmiiboAPI project authors
+// Licensed under the EUPL 1.2 or later.
+//
+// See LICENSE for license information
+// See CONTRIBUTORS for the list of AmiiboAPI project authors
+//
+//===----------------------------------------------------------------------===
+
+protocol KeyNameModel: Sendable {
+    
+    // MARK: Properties
+    
+    var key: String { get }
+    var name: String { get }
+    
+    // MARK: Initialisers
+    
+    init(_ payload: Components.Schemas.Tuple)
+    
+}

Sources/Internal/Transcoders/ISODateTranscoder.swift

@@ -0,0 +1,31 @@
+//===----------------------------------------------------------------------===
+//
+// This source file is part of the AmiiboAPI open source project
+//
+// Copyright (c) 2024 Röck+Cöde VoF. and the AmiiboAPI project authors
+// Licensed under the EUPL 1.2 or later.
+//
+// See LICENSE for license information
+// See CONTRIBUTORS for the list of AmiiboAPI project authors
+//
+//===----------------------------------------------------------------------===
+
+import Foundation
+import OpenAPIRuntime
+
+struct ISODateTranscoder: DateTranscoder {
+
+    // MARK: Properties
+    private let dateFormatter: DateFormatter = .isoDateTime
+    
+    // MARK: Functions
+    
+    func encode(_ date: Date) throws -> String {
+        dateFormatter.string(from: date)
+    }
+    
+    func decode(_ string: String) throws -> Date {
+        dateFormatter.date(from: string) ?? .init()
+    }
+    
+}