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/Public/Models/Amiibo.swift

@@ -0,0 +1,59 @@
+//===----------------------------------------------------------------------===
+//
+// 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 struct Amiibo: Sendable {
+    
+    // MARK: Properties
+    
+    public let gameCharacter: String
+    public let gameSeries: String
+    public let head: String
+    public let image: String
+    public let name: String
+    public let platform: Platform?
+    public let release: Release
+    public let series: String
+    public let tail: String
+    public let type: String
+    
+    // MARK: Initialisers
+
+    init(_ payload: Components.Schemas.Amiibo) {
+        self.gameCharacter = payload.character
+        self.gameSeries = payload.gameSeries
+        self.head = payload.head
+        self.image = payload.image
+        self.name = payload.name
+        self.platform = .init(
+            payload.gamesSwitch,
+            payload.games3DS,
+            payload.gamesWiiU
+        )
+        self.release = .init(payload.release)
+        self.series = payload.amiiboSeries
+        self.tail = payload.tail
+        self.type = payload._type
+    }
+    
+    // MARK: Computed
+    
+    public var identifier: String {
+        head + tail
+    }
+    
+    public var imageURL: URL? {
+        .init(string: image)
+    }
+
+}

Sources/Public/Models/Amiibo/Amiibo+Game.swift

@@ -0,0 +1,37 @@
+//===----------------------------------------------------------------------===
+//
+// 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
+//
+//===----------------------------------------------------------------------===
+
+extension Amiibo {
+    public struct Game: Sendable {
+        
+        // MARK: Properties
+        
+        public let identifiers: [String]
+        public let name: String
+        public let usages: [Usage]?
+        
+        // MARK: Initialisers
+        
+        init(_ payload: Components.Schemas.AmiiboGame) {
+            self.identifiers = payload.gameID
+            self.name = payload.gameName
+            self.usages = {
+                guard let usages = payload.amiiboUsage else {
+                    return nil
+                }
+                
+                return usages.map { .init($0) }
+            }()
+        }
+        
+    }
+}

Sources/Public/Models/Amiibo/Amiibo+Platform.swift

@@ -0,0 +1,51 @@
+//===----------------------------------------------------------------------===
+//
+// 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
+//
+//===----------------------------------------------------------------------===
+
+extension Amiibo {
+    public struct Platform: Sendable {
+        
+        // MARK: Properties
+        
+        public let `switch`: [Game]
+        public let threeDS: [Game]
+        public let wiiU: [Game]
+        
+        // MARK: Initialisers
+        
+        init?(
+            _ `switch`: [Components.Schemas.AmiiboGame]?,
+            _ threeDS: [Components.Schemas.AmiiboGame]?,
+            _ wiiU: [Components.Schemas.AmiiboGame]?
+        ) {
+            guard (`switch` != nil && `switch`?.isEmpty == false)
+                    || (threeDS != nil && threeDS?.isEmpty == false)
+                    || (wiiU != nil && wiiU?.isEmpty == false)
+            else {
+                return nil
+            }
+            
+            self.switch = {
+                guard let `switch` else { return [] }
+                return `switch`.map { .init($0) }
+            }()
+            self.threeDS = {
+                guard let threeDS else { return [] }
+                return threeDS.map { .init($0) }
+            }()
+            self.wiiU = {
+                guard let wiiU else { return [] }
+                return wiiU.map { .init($0) }
+            }()
+        }
+
+    }
+}

Sources/Public/Models/Amiibo/Amiibo+Release.swift

@@ -0,0 +1,35 @@
+//===----------------------------------------------------------------------===
+//
+// 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 Amiibo {
+    public struct Release: Sendable {
+        
+        // MARK: Properties
+        
+        public let america: Date?
+        public let australia: Date?
+        public let europe: Date?
+        public let japan: Date?
+        
+        // MARK: Initialisers
+        
+        init(_ payload: Components.Schemas.AmiiboRelease) {
+            self.america = payload.na
+            self.australia = payload.au
+            self.europe = payload.eu
+            self.japan = payload.jp
+        }
+        
+    }
+}

Sources/Public/Models/Amiibo/Amiibo+Usage.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
+//
+//===----------------------------------------------------------------------===
+
+extension Amiibo {
+    public struct Usage: Sendable {
+        
+        // MARK: Properties
+        
+        public let explanation: String
+        public let isWriteable: Bool
+        
+        // MARK: Initialisers
+        
+        init(_ payload: Components.Schemas.AmiiboUsage) {
+            self.explanation = payload.Usage
+            self.isWriteable = payload.write
+        }
+        
+    }
+}

Sources/Public/Models/AmiiboSeries.swift

@@ -0,0 +1,27 @@
+//===----------------------------------------------------------------------===
+//
+// 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
+//
+//===----------------------------------------------------------------------===
+
+public struct AmiiboSeries: KeyNameModel {
+    
+    // MARK: Properties
+    
+    public let key: String
+    public let name: String
+    
+    // MARK: Initialisers
+    
+    init(_ payload: Components.Schemas.Tuple) {
+        self.key = payload.key
+        self.name = payload.name
+    }
+    
+}

Sources/Public/Models/AmiiboType.swift

@@ -0,0 +1,27 @@
+//===----------------------------------------------------------------------===
+//
+// 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
+//
+//===----------------------------------------------------------------------===
+
+public struct AmiiboType: KeyNameModel {
+    
+    // MARK: Properties
+    
+    public let key: String
+    public let name: String
+    
+    // MARK: Initialisers
+    
+    init(_ payload: Components.Schemas.Tuple) {
+        self.key = payload.key
+        self.name = payload.name
+    }
+    
+}

Sources/Public/Models/GameCharacter.swift

@@ -0,0 +1,27 @@
+//===----------------------------------------------------------------------===
+//
+// 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
+//
+//===----------------------------------------------------------------------===
+
+public struct GameCharacter: KeyNameModel {
+    
+    // MARK: Properties
+    
+    public let key: String
+    public let name: String
+    
+    // MARK: Initialisers
+    
+    init(_ payload: Components.Schemas.Tuple) {
+        self.key = payload.key
+        self.name = payload.name
+    }
+    
+}

Sources/Public/Models/GameSeries.swift

@@ -0,0 +1,27 @@
+//===----------------------------------------------------------------------===
+//
+// 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
+//
+//===----------------------------------------------------------------------===
+
+public struct GameSeries: KeyNameModel {
+    
+    // MARK: Properties
+    
+    public let key: String
+    public let name: String
+    
+    // MARK: Initialisers
+    
+    init(_ payload: Components.Schemas.Tuple) {
+        self.key = payload.key
+        self.name = payload.name
+    }
+    
+}