Files
FrenoCorp/Lendair/Services/BeginnerModeService.swift
Michael Freno 57a460761a FRE-4665: Implement Phase 3 AI training plans and premium features
- Models: TrainingPlan, Race, FamilyPlan, BeginnerMode, CommunityEvent
- Services: 5 service layers with protocol-based architecture
- ViewModels: 5 view models with @MainActor ObservableObject pattern
- Views: 10 SwiftUI views for all Phase 3 features
- Updated README with full Phase 3 documentation

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-05-03 15:21:01 -04:00

119 lines
4.2 KiB
Swift

import Foundation
// MARK: - Service Protocol
protocol BeginnerModeServiceProtocol: Sendable {
func getConfig() async throws -> BeginnerConfig
func updateConfig(request: UpdateBeginnerConfigRequest) async throws -> BeginnerConfig
func getMilestoneProgress() async throws -> (milestones: [Milestone], level: BeginnerLevel)
}
// MARK: - Default Service
class BeginnerModeService: BeginnerModeServiceProtocol {
private let baseURL: URL
private let session: URLSession
private let authToken: String?
init(
baseURL: URL = URL(string: "http://localhost:3000")!,
session: URLSession = .shared,
authToken: String? = nil
) {
self.baseURL = baseURL
self.session = session
self.authToken = authToken
}
func getConfig() async throws -> BeginnerConfig {
let url = baseURL.appendingPathComponent("/api/beginner-mode/config")
let request = try buildRequest(url: url)
let (data, response) = try await session.data(for: request)
try validateResponse(response)
let decoded = try JSONDecoder().decode(BeginnerConfigResponse.self, from: data)
return decoded.config
}
func updateConfig(request: UpdateBeginnerConfigRequest) async throws -> BeginnerConfig {
let url = baseURL.appendingPathComponent("/api/beginner-mode/config")
var request = try buildRequest(url: url, method: .patch)
request.httpBody = try JSONEncoder().encode(request)
let (data, response) = try await session.data(for: request)
try validateResponse(response)
let decoded = try JSONDecoder().decode(UpdateBeginnerConfigResponse.self, from: data)
return decoded.config
}
func getMilestoneProgress() async throws -> (milestones: [Milestone], level: BeginnerLevel) {
let url = baseURL.appendingPathComponent("/api/beginner-mode/milestones")
let request = try buildRequest(url: url)
let (data, response) = try await session.data(for: request)
try validateResponse(response)
let decoded = try JSONDecoder().decode(MilestoneProgressResponse.self, from: data)
return (decoded.milestones, decoded.currentLevel)
}
// MARK: - Helpers
private func buildRequest(url: URL, method: HTTPMethod = .get, body: Data? = nil) throws -> URLRequest {
var request = URLRequest(url: url)
request.httpMethod = method.rawValue
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
if let token = authToken {
request.setValue("Bearer \(token)", forHTTPHeaderField: "Authorization")
}
if let body = body {
request.httpBody = body
}
return request
}
private func validateResponse(_ response: URLResponse) throws {
guard let httpResponse = response as? HTTPURLResponse else {
throw BeginnerModeError.invalidResponse
}
guard (200...299).contains(httpResponse.statusCode) else {
switch httpResponse.statusCode {
case 401: throw BeginnerModeError.unauthorized
case 403: throw BeginnerModeError.forbidden
case 404: throw BeginnerModeError.notFound
case 429: throw BeginnerModeError.rateLimited
case 500...599: throw BeginnerModeError.serverError(httpResponse.statusCode)
default: throw BeginnerModeError.httpError(httpResponse.statusCode)
}
}
}
}
// MARK: - Error Types
enum BeginnerModeError: LocalizedError {
case invalidResponse
case unauthorized
case forbidden
case notFound
case rateLimited
case serverError(Int)
case httpError(Int)
var errorDescription: String {
switch self {
case .invalidResponse: return "Invalid server response"
case .unauthorized: return "Unauthorized — please log in again"
case .forbidden: return "Forbidden — check permissions"
case .notFound: return "Beginner mode config not found"
case .rateLimited: return "Too many requests — try again shortly"
case .serverError(let code): return "Server error (\(code))"
case .httpError(let code): return "HTTP error (\(code))"
}
}
}