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>
This commit is contained in:
2026-05-03 15:21:01 -04:00
parent db23f533af
commit 57a460761a
26 changed files with 4457 additions and 62 deletions

View File

@@ -0,0 +1,118 @@
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))"
}
}
}

View File

@@ -0,0 +1,153 @@
import Foundation
// MARK: - Service Protocol
protocol CommunityEventServiceProtocol: Sendable {
func listEvents(filter: EventFilter) async throws -> [CommunityEvent]
func getEvent(id: String) async throws -> (event: CommunityEvent, participants: [EventParticipant])
func createEvent(request: CreateEventRequest) async throws -> CommunityEvent
func updateEvent(id: String, request: UpdateEventRequest) async throws -> CommunityEvent
func RSVP(eventId: String, status: RSVPStatus) async throws
}
// MARK: - Default Service
class CommunityEventService: CommunityEventServiceProtocol {
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 listEvents(filter: EventFilter = EventFilter()) async throws -> [CommunityEvent] {
var components = URLComponents(url: baseURL.appendingPathComponent("/api/events"), resolvingAgainstBaseURL: true)!
var queryItems: [URLQueryItem] = [
URLQueryItem(name: "limit", value: String(filter.limit)),
URLQueryItem(name: "offset", value: String(filter.offset))
]
if let type = filter.eventType { queryItems.append(URLQueryItem(name: "type", value: type.rawValue)) }
if let startDate = filter.startDate { queryItems.append(URLQueryItem(name: "startDate", value: ISO8601DateFormatter().string(from: startDate))) }
if let endDate = filter.endDate { queryItems.append(URLQueryItem(name: "endDate", value: ISO8601DateFormatter().string(from: endDate))) }
if let location = filter.location { queryItems.append(URLQueryItem(name: "location", value: location)) }
if let radius = filter.radiusKm { queryItems.append(URLQueryItem(name: "radius", value: String(radius))) }
if let rsvp = filter.rsvpStatus { queryItems.append(URLQueryItem(name: "rsvp", value: rsvp.rawValue)) }
components.queryItems = queryItems
let request = try buildRequest(url: components.url!)
let (data, response) = try await session.data(for: request)
try validateResponse(response)
let decoded = try JSONDecoder().decode(EventListResponse.self, from: data)
return decoded.events
}
func getEvent(id: String) async throws -> (event: CommunityEvent, participants: [EventParticipant]) {
let url = baseURL.appendingPathComponent("/api/events/\(id)")
let request = try buildRequest(url: url)
let (data, response) = try await session.data(for: request)
try validateResponse(response)
let decoded = try JSONDecoder().decode(EventDetailResponse.self, from: data)
return (decoded.event, decoded.participants)
}
func createEvent(request: CreateEventRequest) async throws -> CommunityEvent {
let url = baseURL.appendingPathComponent("/api/events")
var request = try buildRequest(url: url, method: .post)
request.httpBody = try JSONEncoder().encode(request)
let (data, response) = try await session.data(for: request)
try validateResponse(response)
let decoded = try JSONDecoder().decode(CreateEventResponse.self, from: data)
return decoded.event
}
func updateEvent(id: String, request: UpdateEventRequest) async throws -> CommunityEvent {
let url = baseURL.appendingPathComponent("/api/events/\(id)")
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(UpdateEventResponse.self, from: data)
return decoded.event
}
func RSVP(eventId: String, status: RSVPStatus) async throws {
let url = baseURL.appendingPathComponent("/api/events/\(eventId)/rsvp")
var request = try buildRequest(url: url, method: .post)
request.httpBody = try JSONEncoder().encode(["status": status.rawValue])
let (_, response) = try await session.data(for: request)
try validateResponse(response)
}
// 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 CommunityEventError.invalidResponse
}
guard (200...299).contains(httpResponse.statusCode) else {
switch httpResponse.statusCode {
case 401: throw CommunityEventError.unauthorized
case 403: throw CommunityEventError.forbidden
case 404: throw CommunityEventError.notFound
case 429: throw CommunityEventError.rateLimited
case 500...599: throw CommunityEventError.serverError(httpResponse.statusCode)
default: throw CommunityEventError.httpError(httpResponse.statusCode)
}
}
}
}
// MARK: - Error Types
enum CommunityEventError: 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 "Event 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))"
}
}
}

View File

@@ -0,0 +1,125 @@
import Foundation
// MARK: - Service Protocol
protocol FamilyPlanServiceProtocol: Sendable {
func getFamilyPlan() async throws -> FamilyPlan
func inviteMember(request: InviteMemberRequest) async throws
func removeMember(id: String) async throws
func getLeaderboard(metric: LeaderboardMetric) async throws -> [FamilyLeaderboardEntry]
}
// MARK: - Default Service
class FamilyPlanService: FamilyPlanServiceProtocol {
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 getFamilyPlan() async throws -> FamilyPlan {
let url = baseURL.appendingPathComponent("/api/family-plan")
let request = try buildRequest(url: url)
let (data, response) = try await session.data(for: request)
try validateResponse(response)
let decoded = try JSONDecoder().decode(FamilyPlanDetailResponse.self, from: data)
return decoded.plan
}
func inviteMember(request: InviteMemberRequest) async throws {
let url = baseURL.appendingPathComponent("/api/family-plan/invite")
var request = try buildRequest(url: url, method: .post)
request.httpBody = try JSONEncoder().encode(request)
let (_, response) = try await session.data(for: request)
try validateResponse(response)
}
func removeMember(id: String) async throws {
let url = baseURL.appendingPathComponent("/api/family-plan/members/\(id)")
let request = try buildRequest(url: url, method: .delete)
let (_, response) = try await session.data(for: request)
try validateResponse(response)
}
func getLeaderboard(metric: LeaderboardMetric) async throws -> [FamilyLeaderboardEntry] {
var components = URLComponents(url: baseURL.appendingPathComponent("/api/family-plan/leaderboard"), resolvingAgainstBaseURL: true)!
components.queryItems = [URLQueryItem(name: "metric", value: metric.rawValue)]
let request = try buildRequest(url: components.url!)
let (data, response) = try await session.data(for: request)
try validateResponse(response)
let decoded = try JSONDecoder().decode(FamilyLeaderboardResponse.self, from: data)
return decoded.entries
}
// 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 FamilyPlanError.invalidResponse
}
guard (200...299).contains(httpResponse.statusCode) else {
switch httpResponse.statusCode {
case 401: throw FamilyPlanError.unauthorized
case 403: throw FamilyPlanError.forbidden
case 404: throw FamilyPlanError.notFound
case 429: throw FamilyPlanError.rateLimited
case 500...599: throw FamilyPlanError.serverError(httpResponse.statusCode)
default: throw FamilyPlanError.httpError(httpResponse.statusCode)
}
}
}
}
// MARK: - Error Types
enum FamilyPlanError: 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 "Family plan 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))"
}
}
}

View File

@@ -0,0 +1,135 @@
import Foundation
// MARK: - Service Protocol
protocol RaceServiceProtocol: Sendable {
func listRaces(filter: RaceFilter) async throws -> [Race]
func getRace(id: String) async throws -> Race
func saveRace(id: String, isSaved: Bool) async throws
func registerForRace(id: String) async throws
}
// MARK: - Default Service
class RaceService: RaceServiceProtocol {
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 listRaces(filter: RaceFilter = RaceFilter()) async throws -> [Race] {
var components = URLComponents(url: baseURL.appendingPathComponent("/api/races"), resolvingAgainstBaseURL: true)!
var queryItems: [URLQueryItem] = [
URLQueryItem(name: "limit", value: String(filter.limit)),
URLQueryItem(name: "offset", value: String(filter.offset))
]
if let distance = filter.distanceKm { queryItems.append(URLQueryItem(name: "distance", value: String(distance))) }
if let type = filter.raceType { queryItems.append(URLQueryItem(name: "type", value: type.rawValue)) }
if let terrain = filter.terrainType { queryItems.append(URLQueryItem(name: "terrain", value: terrain.rawValue)) }
if let startDate = filter.startDate { queryItems.append(URLQueryItem(name: "startDate", value: ISO8601DateFormatter().string(from: startDate))) }
if let endDate = filter.endDate { queryItems.append(URLQueryItem(name: "endDate", value: ISO8601DateFormatter().string(from: endDate))) }
if let location = filter.location { queryItems.append(URLQueryItem(name: "location", value: location)) }
if let radius = filter.radiusKm { queryItems.append(URLQueryItem(name: "radius", value: String(radius))) }
components.queryItems = queryItems
let request = try buildRequest(url: components.url!)
let (data, response) = try await session.data(for: request)
try validateResponse(response)
let decoded = try JSONDecoder().decode(RaceListResponse.self, from: data)
return decoded.races
}
func getRace(id: String) async throws -> Race {
let url = baseURL.appendingPathComponent("/api/races/\(id)")
let request = try buildRequest(url: url)
let (data, response) = try await session.data(for: request)
try validateResponse(response)
let decoded = try JSONDecoder().decode(RaceDetailResponse.self, from: data)
return decoded.race
}
func saveRace(id: String, isSaved: Bool) async throws {
let method: HTTPMethod = isSaved ? .post : .delete
let url = baseURL.appendingPathComponent("/api/races/\(id)/save")
let request = try buildRequest(url: url, method: method)
let (_, response) = try await session.data(for: request)
try validateResponse(response)
}
func registerForRace(id: String) async throws {
let url = baseURL.appendingPathComponent("/api/races/\(id)/register")
let request = try buildRequest(url: url, method: .post)
let (_, response) = try await session.data(for: request)
try validateResponse(response)
}
// 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 RaceError.invalidResponse
}
guard (200...299).contains(httpResponse.statusCode) else {
switch httpResponse.statusCode {
case 401: throw RaceError.unauthorized
case 403: throw RaceError.forbidden
case 404: throw RaceError.notFound
case 429: throw RaceError.rateLimited
case 500...599: throw RaceError.serverError(httpResponse.statusCode)
default: throw RaceError.httpError(httpResponse.statusCode)
}
}
}
}
// MARK: - Error Types
enum RaceError: 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 "Race 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))"
}
}
}

View File

@@ -0,0 +1,152 @@
import Foundation
// MARK: - Service Protocol
protocol TrainingPlanServiceProtocol: Sendable {
func listPlans(type: PlanType?, difficulty: Difficulty?) async throws -> [TrainingPlan]
func getPlan(id: String) async throws -> TrainingPlan
func generatePlan(request: GeneratePlanRequest) async throws -> TrainingPlan
func followPlan(id: String) async throws
func unfollowPlan(id: String) async throws
func updateSessionStatus(sessionId: String, status: SessionStatus) async throws
}
// MARK: - Default Service
class TrainingPlanService: TrainingPlanServiceProtocol {
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 listPlans(type: PlanType? = nil, difficulty: Difficulty? = nil) async throws -> [TrainingPlan] {
var components = URLComponents(url: baseURL.appendingPathComponent("/api/training-plans"), resolvingAgainstBaseURL: true)!
var queryItems: [URLQueryItem] = []
if let type = type { queryItems.append(URLQueryItem(name: "type", value: type.rawValue)) }
if let difficulty = difficulty { queryItems.append(URLQueryItem(name: "difficulty", value: difficulty.rawValue)) }
components.queryItems = queryItems
let request = try buildRequest(url: components.url!)
let (data, response) = try await session.data(for: request)
try validateResponse(response)
let decoded = try JSONDecoder().decode(TrainingPlanListResponse.self, from: data)
return decoded.plans
}
func getPlan(id: String) async throws -> TrainingPlan {
let url = baseURL.appendingPathComponent("/api/training-plans/\(id)")
let request = try buildRequest(url: url)
let (data, response) = try await session.data(for: request)
try validateResponse(response)
let decoded = try JSONDecoder().decode(TrainingPlanDetailResponse.self, from: data)
return decoded.plan
}
func generatePlan(request: GeneratePlanRequest) async throws -> TrainingPlan {
let url = baseURL.appendingPathComponent("/api/training-plans/generate")
var request = try buildRequest(url: url, method: .post)
request.httpBody = try JSONEncoder().encode(request)
let (data, response) = try await session.data(for: request)
try validateResponse(response)
let decoded = try JSONDecoder().decode(GeneratePlanResponse.self, from: data)
return decoded.plan
}
func followPlan(id: String) async throws {
let url = baseURL.appendingPathComponent("/api/training-plans/\(id)/follow")
let request = try buildRequest(url: url, method: .post)
let (_, response) = try await session.data(for: request)
try validateResponse(response)
}
func unfollowPlan(id: String) async throws {
let url = baseURL.appendingPathComponent("/api/training-plans/\(id)/follow")
let request = try buildRequest(url: url, method: .delete)
let (_, response) = try await session.data(for: request)
try validateResponse(response)
}
func updateSessionStatus(sessionId: String, status: SessionStatus) async throws {
let url = baseURL.appendingPathComponent("/api/training-plans/sessions/\(sessionId)/status")
var request = try buildRequest(url: url, method: .patch)
let body = try JSONEncoder().encode(["status": status.rawValue])
request.httpBody = body
let (_, response) = try await session.data(for: request)
try validateResponse(response)
}
// 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 TrainingPlanError.invalidResponse
}
guard (200...299).contains(httpResponse.statusCode) else {
switch httpResponse.statusCode {
case 401: throw TrainingPlanError.unauthorized
case 403: throw TrainingPlanError.forbidden
case 404: throw TrainingPlanError.notFound
case 429: throw TrainingPlanError.rateLimited
case 500...599: throw TrainingPlanError.serverError(httpResponse.statusCode)
default: throw TrainingPlanError.httpError(httpResponse.statusCode)
}
}
}
}
// MARK: - Error Types
enum TrainingPlanError: LocalizedError {
case invalidResponse
case unauthorized
case forbidden
case notFound
case rateLimited
case serverError(Int)
case httpError(Int)
case decodingError(Error)
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 "Training plan 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))"
case .decodingError(let error): return "Decoding error: \(error.localizedDescription)"
}
}
}