import Foundation
import HapiProtocol

/// Machines and spawning (`docs/api/client-contract/rest.md`).
extension APIClient {
    /// `GET /api/machines` — online machines in the caller's namespace.
    public func listMachines() async throws -> [Machine] {
        let response: MachinesResponse = try await request(.get, "/api/machines")
        return response.machines
    }

    /// `PATCH /api/machines/:id` — rename (≤ 64 chars; empty string clears
    /// the custom name back to the hostname).
    public func renameMachine(id: String, displayName: String) async throws {
        struct RenameMachineRequest: Encodable {
            let displayName: String
        }
        try await requestVoid(
            .patch,
            "/api/machines/\(encodePathComponent(id))",
            body: RenameMachineRequest(displayName: displayName)
        )
    }

    /// `POST /api/machines/:id/spawn`. The response is discriminated on
    /// `type`, not HTTP status — a failed spawn is still HTTP 200 with
    /// `.error`.
    public func spawnSession(machineId: String, _ spawn: SpawnRequest) async throws -> SpawnResponse {
        try await request(
            .post,
            "/api/machines/\(encodePathComponent(machineId))/spawn",
            body: spawn
        )
    }

    /// `POST /api/machines/:id/list-directory` (RPC envelope — check
    /// `success`).
    public func listMachineDirectory(
        machineId: String,
        path: String,
        includeHidden: Bool = false
    ) async throws -> MachineListDirectoryResponse {
        struct ListDirectoryRequest: Encodable {
            let path: String
            let includeHidden: Bool
        }
        return try await request(
            .post,
            "/api/machines/\(encodePathComponent(machineId))/list-directory",
            body: ListDirectoryRequest(path: path, includeHidden: includeHidden)
        )
    }

    /// `POST /api/machines/:id/paths/exists` (≤ 1000 paths).
    public func machinePathsExist(machineId: String, paths: [String]) async throws -> [String: Bool] {
        struct PathsExistsRequest: Encodable {
            let paths: [String]
        }
        let response: MachinePathsExistsResponse = try await request(
            .post,
            "/api/machines/\(encodePathComponent(machineId))/paths/exists",
            body: PathsExistsRequest(paths: paths)
        )
        return response.exists
    }
}