// Generated by scripts/gen-api.py from spec/openapi.json — do not edit.

import Foundation

// MARK: - Types

/// Values this build does not know decode as `.unrecognized`.
public enum SupportThreadService: RawRepresentable, Codable, Sendable, Hashable {
    case domains
    case consultancy
    case spatial
    case general
    /// A value the server sent that this version of the package does not list.
    case unrecognized(String)

    /// Every value the spec listed when this file was generated.
    public static let known: [SupportThreadService] = [.domains, .consultancy, .spatial, .general]

    public init(rawValue: String) {
        switch rawValue {
        case "domains": self = .domains
        case "consultancy": self = .consultancy
        case "spatial": self = .spatial
        case "general": self = .general
        default: self = .unrecognized(rawValue)
        }
    }

    public var rawValue: String {
        switch self {
        case .domains: return "domains"
        case .consultancy: return "consultancy"
        case .spatial: return "spatial"
        case .general: return "general"
        case .unrecognized(let raw): return raw
        }
    }

    public init(from decoder: any Decoder) throws {
        self.init(rawValue: try decoder.singleValueContainer().decode(String.self))
    }

    public func encode(to encoder: any Encoder) throws {
        var container = encoder.singleValueContainer()
        try container.encode(rawValue)
    }
}

/// Shared by 4 operations.
public struct SupportThread: Codable, Sendable, Hashable, Identifiable {
    public var id: String
    public var email: String
    public var title: String?
    public var service: SupportThreadService?
    public var lastName: String?
    public var messageCount: Int
    public var unreadCount: Int
    public var lastPreview: String?
    public var createdAt: String
    public var updatedAt: String
    public var lastActivityAt: String

    public init(id: String, email: String, title: String? = nil, service: SupportThreadService? = nil, lastName: String? = nil, messageCount: Int, unreadCount: Int, lastPreview: String? = nil, createdAt: String, updatedAt: String, lastActivityAt: String) {
        self.id = id
        self.email = email
        self.title = title
        self.service = service
        self.lastName = lastName
        self.messageCount = messageCount
        self.unreadCount = unreadCount
        self.lastPreview = lastPreview
        self.createdAt = createdAt
        self.updatedAt = updatedAt
        self.lastActivityAt = lastActivityAt
    }

    enum CodingKeys: String, CodingKey {
        case id
        case email
        case title
        case service
        case lastName = "last_name"
        case messageCount = "message_count"
        case unreadCount = "unread_count"
        case lastPreview = "last_preview"
        case createdAt = "created_at"
        case updatedAt = "updated_at"
        case lastActivityAt = "last_activity_at"
    }

    /// Explicit so required-but-nullable fields encode as `null` rather than vanishing.
    public func encode(to encoder: any Encoder) throws {
        var container = encoder.container(keyedBy: CodingKeys.self)
        try container.encode(id, forKey: .id)
        try container.encode(email, forKey: .email)
        try container.encode(title, forKey: .title)
        try container.encode(service, forKey: .service)
        try container.encode(lastName, forKey: .lastName)
        try container.encode(messageCount, forKey: .messageCount)
        try container.encode(unreadCount, forKey: .unreadCount)
        try container.encode(lastPreview, forKey: .lastPreview)
        try container.encode(createdAt, forKey: .createdAt)
        try container.encode(updatedAt, forKey: .updatedAt)
        try container.encode(lastActivityAt, forKey: .lastActivityAt)
    }
}

/// Used by GET /contact/threads.
public struct ListThreadsResponse: Codable, Sendable, Hashable {
    public var threads: [SupportThread]
    public var nextCursor: String?
    public var unreadCount: Int

    public init(threads: [SupportThread], nextCursor: String? = nil, unreadCount: Int) {
        self.threads = threads
        self.nextCursor = nextCursor
        self.unreadCount = unreadCount
    }

    enum CodingKeys: String, CodingKey {
        case threads
        case nextCursor = "next_cursor"
        case unreadCount = "unread_count"
    }

    /// Explicit so required-but-nullable fields encode as `null` rather than vanishing.
    public func encode(to encoder: any Encoder) throws {
        var container = encoder.container(keyedBy: CodingKeys.self)
        try container.encode(threads, forKey: .threads)
        try container.encode(nextCursor, forKey: .nextCursor)
        try container.encode(unreadCount, forKey: .unreadCount)
    }
}

/// Used by POST /contact/threads.
public struct CreateThreadBody: Codable, Sendable, Hashable {
    public var title: String
    public var service: SupportThreadService
    public var message: String

    public init(title: String, service: SupportThreadService, message: String) {
        self.title = title
        self.service = service
        self.message = message
    }

    enum CodingKeys: String, CodingKey {
        case title
        case service
        case message
    }
}

/// Used by POST /contact/threads.
public struct CreateThreadResponse: Codable, Sendable, Hashable {
    public var thread: SupportThread

    public init(thread: SupportThread) {
        self.thread = thread
    }

    enum CodingKeys: String, CodingKey {
        case thread
    }
}

/// Shared by 2 operations.
public struct ThreadReply: Codable, Sendable, Hashable, Identifiable {
    public var id: String
    public var displayName: String
    public var body: String
    public var createdAt: String

    public init(id: String, displayName: String, body: String, createdAt: String) {
        self.id = id
        self.displayName = displayName
        self.body = body
        self.createdAt = createdAt
    }

    enum CodingKeys: String, CodingKey {
        case id
        case displayName = "display_name"
        case body
        case createdAt = "created_at"
    }
}

/// Shared by 2 operations.
public struct ThreadMessage: Codable, Sendable, Hashable, Identifiable {
    public var id: String
    public var threadId: String?
    public var name: String
    public var email: String
    public var message: String
    public var userId: String?
    public var createdAt: String
    public var replies: [ThreadReply]

    public init(id: String, threadId: String? = nil, name: String, email: String, message: String, userId: String? = nil, createdAt: String, replies: [ThreadReply]) {
        self.id = id
        self.threadId = threadId
        self.name = name
        self.email = email
        self.message = message
        self.userId = userId
        self.createdAt = createdAt
        self.replies = replies
    }

    enum CodingKeys: String, CodingKey {
        case id
        case threadId = "thread_id"
        case name
        case email
        case message
        case userId = "user_id"
        case createdAt = "created_at"
        case replies
    }

    /// Explicit so required-but-nullable fields encode as `null` rather than vanishing.
    public func encode(to encoder: any Encoder) throws {
        var container = encoder.container(keyedBy: CodingKeys.self)
        try container.encode(id, forKey: .id)
        try container.encode(threadId, forKey: .threadId)
        try container.encode(name, forKey: .name)
        try container.encode(email, forKey: .email)
        try container.encode(message, forKey: .message)
        try container.encode(userId, forKey: .userId)
        try container.encode(createdAt, forKey: .createdAt)
        try container.encode(replies, forKey: .replies)
    }
}

/// Shared by 2 operations.
public struct ThreadResponse: Codable, Sendable, Hashable {
    public var thread: SupportThread
    public var messages: [ThreadMessage]

    public init(thread: SupportThread, messages: [ThreadMessage]) {
        self.thread = thread
        self.messages = messages
    }

    enum CodingKeys: String, CodingKey {
        case thread
        case messages
    }
}

/// Used by POST /contact/threads/{id}/messages.
public struct ReplyBody: Codable, Sendable, Hashable {
    public var message: String

    public init(message: String) {
        self.message = message
    }

    enum CodingKeys: String, CodingKey {
        case message
    }
}

/// Query parameters of `listThreads`; unset fields are omitted.
public struct ListThreadsQuery: Sendable, Hashable {
    public var limit: Int?
    public var cursor: String?

    public init(limit: Int? = nil, cursor: String? = nil) {
        self.limit = limit
        self.cursor = cursor
    }

    /// The items in spec order.
    public var queryItems: [QueryItem] {
        var items: [QueryItem] = []
        if let value = limit { items.append(QueryItem("limit", String(value))) }
        if let value = cursor { items.append(QueryItem("cursor", value)) }
        return items
    }
}

// MARK: - Operations

extension IrdOperation {
    public static let support_listThreads = IrdOperation(method: .get, pathTemplate: "/contact/threads", module: "support", name: "listThreads", security: .keyOrJwt)
    public static let support_createThread = IrdOperation(method: .post, pathTemplate: "/contact/threads", module: "support", name: "createThread", security: .keyOrJwt)
    public static let support_getThread = IrdOperation(method: .get, pathTemplate: "/contact/threads/{id}", module: "support", name: "getThread", security: .keyOrJwt)
    public static let support_reply = IrdOperation(method: .post, pathTemplate: "/contact/threads/{id}/messages", module: "support", name: "reply", security: .keyOrJwt)

    static let supportOperations: [IrdOperation] = [.support_listThreads, .support_createThread, .support_getThread, .support_reply]
}

/// The `support` operations (4).
public struct SupportAPI: Sendable {
    let client: IrdClient

    /// List your support threads
    /// Your support conversations with the ird team, newest first (threads are keyed by account email), plus `unread_count` — how many team replies you haven't read yet.
    /// `GET /contact/threads` — 200
    public func listThreads(query: ListThreadsQuery = ListThreadsQuery()) async throws -> ListThreadsResponse {
        try await client.request(.support_listThreads, query: query.queryItems)
    }

    /// Open a support thread
    /// Starts a conversation with the ird team: a title, the service it concerns (`domains`, `consultancy`, `spatial`, or `general`), and your message.
    /// `POST /contact/threads` — 200
    public func createThread(body: CreateThreadBody) async throws -> CreateThreadResponse {
        try await client.request(.support_createThread, body: body)
    }

    /// Read a support thread
    /// One of your threads with every message and every ird-team reply, chronological. Reading marks the thread's replies as seen (resets its `unread_count`). 0-priced at launch (contract `support.reads`).
    /// `GET /contact/threads/{id}` — 200
    public func getThread(id: String) async throws -> ThreadResponse {
        try await client.request(.support_getThread, params: ["id": id])
    }

    /// Reply on a support thread
    /// Appends your message to one of your threads and returns the refreshed conversation. 0-priced at launch (contract `support.writes`).
    /// `POST /contact/threads/{id}/messages` — 200
    public func reply(id: String, body: ReplyBody) async throws -> ThreadResponse {
        try await client.request(.support_reply, params: ["id": id], body: body)
    }
}

extension IrdClient {
    public var support: SupportAPI { SupportAPI(client: self) }
}