luminate/Tests/LuminateServicesTests/JellyfinClientErrorMappingTests.swift

102 lines
3.5 KiB
Swift

//
// JellyfinClientErrorMappingTests.swift
//
// Copyright 2026 Brendan Szymanski <hello@bscubed.dev>
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see <https://www.gnu.org/licenses/>.
//
// SPDX-License-Identifier: GPL-3.0-or-later
//
import Foundation
import LuminateAPI
import LuminateCore
import OpenAPIRuntime
import Testing
@testable import LuminateServices
/// Covers the translation from generated HTTP outcomes to ``JellyfinClientError``.
///
/// Every operation hand-writes its status switch, so this pins the shape those switches share.
@Suite struct JellyfinClientErrorMappingTests {
/// Builds a client wired to a double.
///
/// - Parameter api: The stubbed API.
/// - Returns: A client that routes every call to `api`.
private func makeClient(_ api: MockJellyfinAPI) -> JellyfinClient {
JellyfinClient(
configuration: JellyfinClientConfiguration(serverURL: URL(string: "http://localhost")!),
api: api
)
}
@Test("An unconfigured client rejects operations before network access")
func unconfiguredClientThrows() async {
let client = JellyfinClient(
configuration: JellyfinClientConfiguration(serverURL: nil)
)
#expect(await client.serverURL == nil)
await #expect(throws: JellyfinClientError.notConfigured) {
_ = try await client.items()
}
}
@Test("A 401 maps to unauthorized")
func unauthorizedMaps() async {
var api = MockJellyfinAPI()
api.getItemsOutput = .unauthorized(.init())
let client = makeClient(api)
await #expect(throws: JellyfinClientError.unauthorized) {
_ = try await client.items()
}
}
@Test("A 403 maps to forbidden")
func forbiddenMaps() async {
var api = MockJellyfinAPI()
api.getItemsOutput = .forbidden(.init())
let client = makeClient(api)
await #expect(throws: JellyfinClientError.forbidden) {
_ = try await client.items()
}
}
@Test("An undocumented status is reported with its operation and code")
func undocumentedMaps() async {
var api = MockJellyfinAPI()
api.getItemsOutput = .undocumented(statusCode: 418, .init())
let client = makeClient(api)
await #expect(throws: JellyfinClientError.unexpectedStatus(operation: "GetItems", statusCode: 418)) {
_ = try await client.items()
}
}
@Test("A starting server surfaces its Retry-After hint")
func serviceUnavailableCarriesRetryAfter() async {
var api = MockJellyfinAPI()
api.getPublicSystemInfoOutput = .serviceUnavailable(
.init(headers: .init(retryAfter: 5), body: .html(HTTPBody("starting")))
)
let client = makeClient(api)
await #expect(throws: JellyfinClientError.serviceUnavailable(retryAfterSeconds: 5)) {
_ = try await client.publicServerInfo()
}
}
}