feat: license UX improvements (#390)

* feat: license UX improvements — expiry warning, activation management, validation retry

* fix: address PR review — extract pricing URL constant, add access control, log errors

Author: datlechin

TablePro/Core/Services/Licensing/LicenseAPIClient.swift

@@ -52,6 +52,13 @@ final class LicenseAPIClient {
         return try await post(url: url, body: request)
     }
 
+    /// List all activations for a license key
+    func listActivations(licenseKey: String, machineId: String) async throws -> ListActivationsResponse {
+        let url = baseURL.appendingPathComponent("activations")
+        let body = LicenseValidationRequest(licenseKey: licenseKey, machineId: machineId)
+        return try await post(url: url, body: body)
+    }
+
     /// Deactivate a license key from this machine
     func deactivate(request: LicenseDeactivationRequest) async throws {
         let url = baseURL.appendingPathComponent("deactivate")

TablePro/Core/Services/Licensing/LicenseManager+Pro.swift

@@ -22,6 +22,8 @@ extension LicenseManager {
         switch status {
         case .expired:
             return .expired
+        case .validationFailed:
+            return .validationFailed
         default:
             return .unlicensed
         }

TablePro/Core/Services/Licensing/LicenseManager.swift

@@ -191,8 +191,17 @@ final class LicenseManager {
 
     // MARK: - Re-validation
 
+    var isExpiringSoon: Bool {
+        guard let days = license?.daysUntilExpiry else { return false }
+        return days >= 0 && days <= 7
+    }
+
+    var daysUntilExpiry: Int? {
+        license?.daysUntilExpiry
+    }
+
     /// Periodic re-validation: refresh license from server, fall back to offline grace period
-    private func revalidate() async {
+    func revalidate() async {
         guard let license else { return }
 
         isValidating = true

TablePro/Models/Settings/License.swift

@@ -131,6 +131,37 @@ struct LicenseAPIErrorResponse: Codable {
     let message: String
 }
 
+/// Information about a single license activation (machine)
+internal struct LicenseActivationInfo: Codable, Identifiable {
+    var id: String { machineId }
+    let machineId: String
+    let machineName: String
+    let appVersion: String
+    let osVersion: String
+    let lastValidatedAt: String?
+    let createdAt: String
+
+    private enum CodingKeys: String, CodingKey {
+        case machineId = "machine_id"
+        case machineName = "machine_name"
+        case appVersion = "app_version"
+        case osVersion = "os_version"
+        case lastValidatedAt = "last_validated_at"
+        case createdAt = "created_at"
+    }
+}
+
+/// Response from the list activations endpoint
+internal struct ListActivationsResponse: Codable {
+    let activations: [LicenseActivationInfo]
+    let maxActivations: Int
+
+    private enum CodingKeys: String, CodingKey {
+        case activations
+        case maxActivations = "max_activations"
+    }
+}
+
 // MARK: - Cached License
 
 /// Local cached license with metadata for offline use
@@ -151,6 +182,12 @@ struct License: Codable, Equatable {
         return expiresAt < Date()
     }
 
+    /// Days until the license expires (nil for lifetime licenses)
+    var daysUntilExpiry: Int? {
+        guard let expiresAt else { return nil }
+        return Calendar.current.dateComponents([.day], from: Date(), to: expiresAt).day
+    }
+
     /// Days since last successful server validation
     var daysSinceLastValidation: Int {
         Calendar.current.dateComponents([.day], from: lastValidatedAt, to: Date()).day ?? 0

TablePro/Models/Settings/ProFeature.swift

@@ -38,4 +38,5 @@ internal enum ProFeatureAccess {
     case available
     case unlicensed
     case expired
+    case validationFailed
 }