// ===----------------------------------------------------------------------===
// 
// This source file is part of the Amiibo Service open source project
// 
// Copyright (c) 2026 Röck+Cöde VoF. and the Amiibo Service project authors
// Licensed under Apache license v2.0
// 
// See LICENSE for license information
// See CONTRIBUTORS for the list of Amiibo Service project authors
//
// SPDX-License-Identifier: Apache-2.0
// 
// ===----------------------------------------------------------------------===

import Foundation
import OpenAPIRuntime

/// A type that allows the decoding and encoding of ISO timestamp dates, defined by the `yyyy-MM-dd'T'HH:mm:ss.SSSSSS` custom date format.
struct ISOTimestampTranscoder {
    
    // MARK: Properties
    
    /// A formatter to use to decode and encode ISO timestamps dates.
    private let dateFormatter: DateFormatter = .isoTimestamp
    
}

 // MARK: - DateTranscoder

extension ISOTimestampTranscoder: DateTranscoder {
    
    // MARK: Functions
    
    /// Encodes a date into an ISO timestamp string.
    /// - Parameter date: A date to encode.
    /// - Returns: A string representation of the date in `yyyy-MM-dd'T'HH:mm:ss.SSSSSS` format.
    func encode(_ date: Date) throws -> String {
        dateFormatter.string(from: date)
    }
    
    /// Decodes an ISO timestamp string into a date.
    /// - Parameter string: A string to decode.
    /// - Returns: A date parsed from the string.
    /// - Throws: A `DecodingError` if the string cannot be parsed into a valid date.
    func decode(_ string: String) throws -> Date {
        guard let date = dateFormatter.date(from: string) else {
            throw DecodingError.dataCorrupted(.init(
                codingPath: [],
                debugDescription: "Expected an ISO timestamp with format 'yyyy-MM-dd'T'HH:mm:ss.SSSSSS', but found '\(string)' instead."
            ))
        }
        
        return date
    }
    
}