mirror of
https://github.com/FBukovina/Atoll.git
synced 2026-10-27 23:24:32 +00:00
454 lines
21 KiB
Swift
454 lines
21 KiB
Swift
/*
|
|
* Atoll (DynamicIsland)
|
|
* Copyright (C) 2024-2026 Atoll Contributors
|
|
*
|
|
* 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/>.
|
|
*/
|
|
|
|
import Foundation
|
|
import Defaults
|
|
import AtollExtensionKit
|
|
|
|
/// Handles JSON-RPC method calls for a single WebSocket connection.
|
|
/// Mirrors the functionality of `ExtensionXPCService` but uses JSON-RPC transport.
|
|
@MainActor
|
|
final class ExtensionRPCService {
|
|
let bundleIdentifier: String
|
|
private weak var server: ExtensionRPCServer?
|
|
|
|
private let liveActivityManager = ExtensionLiveActivityManager.shared
|
|
private let widgetManager = ExtensionLockScreenWidgetManager.shared
|
|
private let notchManager = ExtensionNotchExperienceManager.shared
|
|
private let authorizationManager = ExtensionAuthorizationManager.shared
|
|
|
|
private let decoder = JSONDecoder()
|
|
private let encoder = JSONEncoder()
|
|
|
|
// Keys whose values represent Swift enums that use {"type":...} in client format.
|
|
// These need to be transformed to Swift Codable format: {"caseName": {params}}.
|
|
private static let enumKeys: Set<String> = [
|
|
"leadingIcon", "trailingContent", "progressIndicator",
|
|
"badgeIcon", "leadingContent", "icon", "tint"
|
|
]
|
|
|
|
// Enum-typed fields that can appear inside arrays (like content elements)
|
|
private static let contentElementTypeFields: Set<String> = [
|
|
"text", "icon", "progress", "graph", "gauge", "spacer", "divider", "webView"
|
|
]
|
|
|
|
init(bundleIdentifier: String, server: ExtensionRPCServer) {
|
|
self.bundleIdentifier = bundleIdentifier
|
|
self.server = server
|
|
}
|
|
|
|
// MARK: - Method Routing
|
|
|
|
func handleRequest(_ request: RPCRequest) -> Data {
|
|
let result: Codable
|
|
|
|
switch request.method {
|
|
case "atoll.getVersion":
|
|
result = handleGetVersion(id: request.id)
|
|
|
|
case "atoll.requestAuthorization":
|
|
result = handleRequestAuthorization(params: request.params, id: request.id)
|
|
|
|
case "atoll.checkAuthorization":
|
|
result = handleCheckAuthorization(params: request.params, id: request.id)
|
|
|
|
case "atoll.presentLiveActivity":
|
|
result = handlePresentLiveActivity(params: request.params, id: request.id)
|
|
|
|
case "atoll.updateLiveActivity":
|
|
result = handleUpdateLiveActivity(params: request.params, id: request.id)
|
|
|
|
case "atoll.dismissLiveActivity":
|
|
result = handleDismissLiveActivity(params: request.params, id: request.id)
|
|
|
|
case "atoll.presentLockScreenWidget":
|
|
result = handlePresentLockScreenWidget(params: request.params, id: request.id)
|
|
|
|
case "atoll.updateLockScreenWidget":
|
|
result = handleUpdateLockScreenWidget(params: request.params, id: request.id)
|
|
|
|
case "atoll.dismissLockScreenWidget":
|
|
result = handleDismissLockScreenWidget(params: request.params, id: request.id)
|
|
|
|
case "atoll.presentNotchExperience":
|
|
result = handlePresentNotchExperience(params: request.params, id: request.id)
|
|
|
|
case "atoll.updateNotchExperience":
|
|
result = handleUpdateNotchExperience(params: request.params, id: request.id)
|
|
|
|
case "atoll.dismissNotchExperience":
|
|
result = handleDismissNotchExperience(params: request.params, id: request.id)
|
|
|
|
default:
|
|
result = RPCErrorResponse(
|
|
error: RPCErrorObject(code: RPCErrorCode.methodNotFound, message: "Method not found: \(request.method)"),
|
|
id: request.id
|
|
)
|
|
}
|
|
|
|
return (try? encoder.encode(result)) ?? Data()
|
|
}
|
|
|
|
// MARK: - Version
|
|
|
|
private func handleGetVersion(id: String) -> RPCSuccessResponse {
|
|
RPCSuccessResponse(
|
|
result: ["version": .string(AtollExtensionKitVersion)],
|
|
id: id
|
|
)
|
|
}
|
|
|
|
// MARK: - Authorization
|
|
|
|
private func handleRequestAuthorization(params: RPCParams?, id: String) -> Codable {
|
|
guard Defaults[.enableThirdPartyExtensions] else {
|
|
return RPCErrorResponse(
|
|
error: RPCErrorObject(code: RPCErrorCode.featureDisabled, message: "Extensions are disabled"),
|
|
id: id
|
|
)
|
|
}
|
|
|
|
let bi = params?["bundleIdentifier"]?.stringValue ?? bundleIdentifier
|
|
let entry = authorizationManager.ensureEntryExists(bundleIdentifier: bi, appName: bi)
|
|
|
|
if entry.isAuthorized {
|
|
return RPCSuccessResponse(result: ["authorized": .bool(true)], id: id)
|
|
}
|
|
|
|
// Auto-authorize for now (user can revoke in settings)
|
|
authorizationManager.authorize(bundleIdentifier: bi, appName: bi)
|
|
logDiagnostics("Authorized RPC client \(bi)")
|
|
|
|
return RPCSuccessResponse(result: ["authorized": .bool(true)], id: id)
|
|
}
|
|
|
|
private func handleCheckAuthorization(params: RPCParams?, id: String) -> Codable {
|
|
let bi = params?["bundleIdentifier"]?.stringValue ?? bundleIdentifier
|
|
|
|
guard Defaults[.enableThirdPartyExtensions] else {
|
|
return RPCSuccessResponse(result: ["authorized": .bool(false)], id: id)
|
|
}
|
|
|
|
let entry = authorizationManager.authorizationEntry(for: bi)
|
|
let authorized = entry?.isAuthorized ?? false
|
|
|
|
return RPCSuccessResponse(result: ["authorized": .bool(authorized)], id: id)
|
|
}
|
|
|
|
// MARK: - Live Activities
|
|
|
|
private func handlePresentLiveActivity(params: RPCParams?, id: String) -> Codable {
|
|
guard let descriptorData = params?.jsonData(for: "descriptor") else {
|
|
return errorResponse(code: RPCErrorCode.invalidParams, message: "Missing descriptor", id: id)
|
|
}
|
|
|
|
do {
|
|
let transformed = Self.transformClientJSON(descriptorData)
|
|
let descriptor = try decoder.decode(AtollLiveActivityDescriptor.self, from: transformed)
|
|
try ExtensionDescriptorValidator.validate(descriptor)
|
|
try liveActivityManager.present(descriptor: descriptor, bundleIdentifier: descriptor.bundleIdentifier)
|
|
logDiagnostics("RPC: Presented live activity \(descriptor.id) for \(descriptor.bundleIdentifier)")
|
|
return RPCSuccessResponse(result: ["success": .bool(true)], id: id)
|
|
} catch let error as ExtensionValidationError {
|
|
return errorResponse(from: error, id: id)
|
|
} catch {
|
|
logDiagnostics("RPC: Decode error for presentLiveActivity: \(error)")
|
|
logDiagnostics("RPC: Raw payload: \(String(data: descriptorData, encoding: .utf8) ?? "<binary>")")
|
|
return errorResponse(code: RPCErrorCode.internalError, message: error.localizedDescription, id: id)
|
|
}
|
|
}
|
|
|
|
private func handleUpdateLiveActivity(params: RPCParams?, id: String) -> Codable {
|
|
guard let descriptorData = params?.jsonData(for: "descriptor") else {
|
|
return errorResponse(code: RPCErrorCode.invalidParams, message: "Missing descriptor", id: id)
|
|
}
|
|
|
|
do {
|
|
let transformed = Self.transformClientJSON(descriptorData)
|
|
let descriptor = try decoder.decode(AtollLiveActivityDescriptor.self, from: transformed)
|
|
try liveActivityManager.update(descriptor: descriptor, bundleIdentifier: descriptor.bundleIdentifier)
|
|
logDiagnostics("RPC: Updated live activity \(descriptor.id) for \(descriptor.bundleIdentifier)")
|
|
return RPCSuccessResponse(result: ["success": .bool(true)], id: id)
|
|
} catch let error as ExtensionValidationError {
|
|
return errorResponse(from: error, id: id)
|
|
} catch {
|
|
logDiagnostics("RPC: Decode error for updateLiveActivity: \(error)")
|
|
return errorResponse(code: RPCErrorCode.internalError, message: error.localizedDescription, id: id)
|
|
}
|
|
}
|
|
|
|
private func handleDismissLiveActivity(params: RPCParams?, id: String) -> Codable {
|
|
guard let activityID = params?["activityID"]?.stringValue else {
|
|
return errorResponse(code: RPCErrorCode.invalidParams, message: "Missing activityID", id: id)
|
|
}
|
|
let bi = params?["bundleIdentifier"]?.stringValue ?? bundleIdentifier
|
|
liveActivityManager.dismiss(activityID: activityID, bundleIdentifier: bi)
|
|
logDiagnostics("RPC: Dismissed live activity \(activityID) for \(bi)")
|
|
return RPCSuccessResponse(result: ["success": .bool(true)], id: id)
|
|
}
|
|
|
|
// MARK: - Lock Screen Widgets
|
|
|
|
private func handlePresentLockScreenWidget(params: RPCParams?, id: String) -> Codable {
|
|
guard let descriptorData = params?.jsonData(for: "descriptor") else {
|
|
return errorResponse(code: RPCErrorCode.invalidParams, message: "Missing descriptor", id: id)
|
|
}
|
|
|
|
do {
|
|
let transformed = Self.transformClientJSON(descriptorData)
|
|
let descriptor = try decoder.decode(AtollLockScreenWidgetDescriptor.self, from: transformed)
|
|
try ExtensionDescriptorValidator.validate(descriptor)
|
|
try widgetManager.present(descriptor: descriptor, bundleIdentifier: descriptor.bundleIdentifier)
|
|
logDiagnostics("RPC: Presented widget \(descriptor.id) for \(descriptor.bundleIdentifier)")
|
|
return RPCSuccessResponse(result: ["success": .bool(true)], id: id)
|
|
} catch let error as ExtensionValidationError {
|
|
return errorResponse(from: error, id: id)
|
|
} catch {
|
|
logDiagnostics("RPC: Decode error for presentWidget: \(error)")
|
|
logDiagnostics("RPC: Raw payload: \(String(data: descriptorData, encoding: .utf8) ?? "<binary>")")
|
|
return errorResponse(code: RPCErrorCode.internalError, message: error.localizedDescription, id: id)
|
|
}
|
|
}
|
|
|
|
private func handleUpdateLockScreenWidget(params: RPCParams?, id: String) -> Codable {
|
|
guard let descriptorData = params?.jsonData(for: "descriptor") else {
|
|
return errorResponse(code: RPCErrorCode.invalidParams, message: "Missing descriptor", id: id)
|
|
}
|
|
|
|
do {
|
|
let transformed = Self.transformClientJSON(descriptorData)
|
|
let descriptor = try decoder.decode(AtollLockScreenWidgetDescriptor.self, from: transformed)
|
|
try widgetManager.update(descriptor: descriptor, bundleIdentifier: descriptor.bundleIdentifier)
|
|
logDiagnostics("RPC: Updated widget \(descriptor.id) for \(descriptor.bundleIdentifier)")
|
|
return RPCSuccessResponse(result: ["success": .bool(true)], id: id)
|
|
} catch let error as ExtensionValidationError {
|
|
return errorResponse(from: error, id: id)
|
|
} catch {
|
|
logDiagnostics("RPC: Decode error for updateWidget: \(error)")
|
|
return errorResponse(code: RPCErrorCode.internalError, message: error.localizedDescription, id: id)
|
|
}
|
|
}
|
|
|
|
private func handleDismissLockScreenWidget(params: RPCParams?, id: String) -> Codable {
|
|
guard let widgetID = params?["widgetID"]?.stringValue else {
|
|
return errorResponse(code: RPCErrorCode.invalidParams, message: "Missing widgetID", id: id)
|
|
}
|
|
let bi = params?["bundleIdentifier"]?.stringValue ?? bundleIdentifier
|
|
widgetManager.dismiss(widgetID: widgetID, bundleIdentifier: bi)
|
|
logDiagnostics("RPC: Dismissed widget \(widgetID) for \(bi)")
|
|
return RPCSuccessResponse(result: ["success": .bool(true)], id: id)
|
|
}
|
|
|
|
// MARK: - Notch Experiences
|
|
|
|
private func handlePresentNotchExperience(params: RPCParams?, id: String) -> Codable {
|
|
guard let descriptorData = params?.jsonData(for: "descriptor") else {
|
|
return errorResponse(code: RPCErrorCode.invalidParams, message: "Missing descriptor", id: id)
|
|
}
|
|
|
|
do {
|
|
let transformed = Self.transformClientJSON(descriptorData)
|
|
let descriptor = try decoder.decode(AtollNotchExperienceDescriptor.self, from: transformed)
|
|
try ExtensionDescriptorValidator.validate(descriptor)
|
|
try notchManager.present(descriptor: descriptor, bundleIdentifier: descriptor.bundleIdentifier)
|
|
logDiagnostics("RPC: Presented notch experience \(descriptor.id) for \(descriptor.bundleIdentifier)")
|
|
return RPCSuccessResponse(result: ["success": .bool(true)], id: id)
|
|
} catch let error as ExtensionValidationError {
|
|
return errorResponse(from: error, id: id)
|
|
} catch {
|
|
logDiagnostics("RPC: Decode error for presentNotchExperience: \(error)")
|
|
logDiagnostics("RPC: Raw payload: \(String(data: descriptorData, encoding: .utf8) ?? "<binary>")")
|
|
return errorResponse(code: RPCErrorCode.internalError, message: error.localizedDescription, id: id)
|
|
}
|
|
}
|
|
|
|
private func handleUpdateNotchExperience(params: RPCParams?, id: String) -> Codable {
|
|
guard let descriptorData = params?.jsonData(for: "descriptor") else {
|
|
return errorResponse(code: RPCErrorCode.invalidParams, message: "Missing descriptor", id: id)
|
|
}
|
|
|
|
do {
|
|
let transformed = Self.transformClientJSON(descriptorData)
|
|
let descriptor = try decoder.decode(AtollNotchExperienceDescriptor.self, from: transformed)
|
|
try notchManager.update(descriptor: descriptor, bundleIdentifier: descriptor.bundleIdentifier)
|
|
logDiagnostics("RPC: Updated notch experience \(descriptor.id) for \(descriptor.bundleIdentifier)")
|
|
return RPCSuccessResponse(result: ["success": .bool(true)], id: id)
|
|
} catch let error as ExtensionValidationError {
|
|
return errorResponse(from: error, id: id)
|
|
} catch {
|
|
logDiagnostics("RPC: Decode error for updateNotchExperience: \(error)")
|
|
return errorResponse(code: RPCErrorCode.internalError, message: error.localizedDescription, id: id)
|
|
}
|
|
}
|
|
|
|
private func handleDismissNotchExperience(params: RPCParams?, id: String) -> Codable {
|
|
guard let experienceID = params?["experienceID"]?.stringValue else {
|
|
return errorResponse(code: RPCErrorCode.invalidParams, message: "Missing experienceID", id: id)
|
|
}
|
|
let bi = params?["bundleIdentifier"]?.stringValue ?? bundleIdentifier
|
|
notchManager.dismiss(experienceID: experienceID, bundleIdentifier: bi)
|
|
logDiagnostics("RPC: Dismissed notch experience \(experienceID) for \(bi)")
|
|
return RPCSuccessResponse(result: ["success": .bool(true)], id: id)
|
|
}
|
|
|
|
// MARK: - Helpers
|
|
|
|
private func errorResponse(code: Int, message: String, id: String) -> RPCErrorResponse {
|
|
RPCErrorResponse(
|
|
error: RPCErrorObject(code: code, message: message),
|
|
id: id
|
|
)
|
|
}
|
|
|
|
private func errorResponse(from error: ExtensionValidationError, id: String) -> RPCErrorResponse {
|
|
let code: Int
|
|
switch error {
|
|
case .featureDisabled: code = RPCErrorCode.featureDisabled
|
|
case .unauthorized: code = RPCErrorCode.unauthorized
|
|
case .invalidDescriptor: code = RPCErrorCode.descriptorInvalid
|
|
case .exceedsCapacity: code = RPCErrorCode.capacityExceeded
|
|
case .unsupportedContent: code = RPCErrorCode.unsupported
|
|
case .rateLimited: code = RPCErrorCode.internalError
|
|
case .duplicateIdentifier: code = RPCErrorCode.descriptorInvalid
|
|
}
|
|
return RPCErrorResponse(
|
|
error: RPCErrorObject(code: code, message: error.localizedDescription ?? "Unknown error"),
|
|
id: id
|
|
)
|
|
}
|
|
|
|
private func logDiagnostics(_ message: String) {
|
|
guard Defaults[.extensionDiagnosticsLoggingEnabled] else { return }
|
|
Logger.log(message, category: .extensions)
|
|
}
|
|
|
|
// MARK: - Client JSON Transformation
|
|
|
|
/// Converts client wire format to Swift Codable format for enum types.
|
|
///
|
|
/// Client sends: `{ "type": "symbol", "name": "timer", "size": 16 }`
|
|
/// Swift expects: `{ "symbol": { "name": "timer", "size": 16 } }`
|
|
///
|
|
/// For enums with unnamed parameters (e.g., `case text(String, font:, color:)`):
|
|
/// Client sends: `{ "type": "text", "text": "LIVE", "font": {...} }`
|
|
/// Swift expects: `{ "text": { "_0": "LIVE", "font": {...} } }`
|
|
static func transformClientJSON(_ data: Data) -> Data {
|
|
guard let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any] else {
|
|
return data
|
|
}
|
|
let transformed = transformObject(json)
|
|
return (try? JSONSerialization.data(withJSONObject: transformed)) ?? data
|
|
}
|
|
|
|
private static func transformObject(_ obj: [String: Any]) -> [String: Any] {
|
|
var result: [String: Any] = [:]
|
|
|
|
for (key, value) in obj {
|
|
if let dict = value as? [String: Any] {
|
|
if enumKeys.contains(key), let typeName = dict["type"] as? String {
|
|
// Transform: { "type": "symbol", ... } → { "symbol": { ... } }
|
|
result[key] = transformEnumValue(dict, typeName: typeName)
|
|
} else {
|
|
result[key] = transformObject(dict)
|
|
}
|
|
} else if let arr = value as? [[String: Any]] {
|
|
// Arrays like "content", "elements", "sections"
|
|
result[key] = arr.map { item in
|
|
if let typeName = item["type"] as? String,
|
|
(key == "content" || key == "elements") {
|
|
return transformEnumValue(item, typeName: typeName)
|
|
}
|
|
return transformObject(item)
|
|
}
|
|
} else {
|
|
result[key] = value
|
|
}
|
|
}
|
|
|
|
return result
|
|
}
|
|
|
|
/// Transforms `{ "type": "caseName", ...params }` → `{ "caseName": { ...params } }`.
|
|
/// Handles special cases where Swift enum cases have unnamed first parameters:
|
|
/// - `text` / `marquee`: `text` field → `_0`
|
|
/// - `icon`: `icon` field → `_0` (AtollIconDescriptor)
|
|
/// - `progress`: `indicator` field → `_0` (AtollProgressIndicator)
|
|
/// - `webView`: `content` field → `_0` (AtollWidgetWebContentDescriptor)
|
|
/// - `animation`: `data` field → `_0` (Data)
|
|
private static func transformEnumValue(_ dict: [String: Any], typeName: String) -> [String: Any] {
|
|
var inner: [String: Any] = [:]
|
|
|
|
for (k, v) in dict where k != "type" {
|
|
if let nestedDict = v as? [String: Any] {
|
|
// Check if this nested dict is an enum-typed field
|
|
if (enumKeys.contains(k) || k == "indicator"),
|
|
let nestedType = nestedDict["type"] as? String {
|
|
inner[k] = transformEnumValue(nestedDict, typeName: nestedType)
|
|
} else {
|
|
inner[k] = transformObject(nestedDict)
|
|
}
|
|
} else if let nestedArr = v as? [[String: Any]] {
|
|
inner[k] = nestedArr.map { item in
|
|
if let t = item["type"] as? String {
|
|
return transformEnumValue(item, typeName: t)
|
|
}
|
|
return transformObject(item)
|
|
}
|
|
} else {
|
|
inner[k] = v
|
|
}
|
|
}
|
|
|
|
// Handle unnamed first parameter for specific enum cases.
|
|
// Swift's auto-synthesized Codable encodes unnamed associated values as `_0`, `_1`, etc.
|
|
switch typeName {
|
|
case "text":
|
|
// AtollTrailingContent.text(String, ...) AND AtollWidgetContentElement.text(String, ...)
|
|
if let textValue = inner.removeValue(forKey: "text") {
|
|
inner["_0"] = textValue
|
|
}
|
|
case "marquee":
|
|
// AtollTrailingContent.marquee(String, ...)
|
|
if let textValue = inner.removeValue(forKey: "text") {
|
|
inner["_0"] = textValue
|
|
}
|
|
case "icon":
|
|
// AtollWidgetContentElement.icon(AtollIconDescriptor, tint:)
|
|
if let iconValue = inner.removeValue(forKey: "icon") {
|
|
inner["_0"] = iconValue
|
|
}
|
|
case "progress":
|
|
// AtollWidgetContentElement.progress(AtollProgressIndicator, value:, color:)
|
|
if let indicatorValue = inner.removeValue(forKey: "indicator") {
|
|
inner["_0"] = indicatorValue
|
|
}
|
|
case "webView":
|
|
// AtollWidgetContentElement.webView(AtollWidgetWebContentDescriptor)
|
|
if let contentValue = inner.removeValue(forKey: "content") {
|
|
inner["_0"] = contentValue
|
|
}
|
|
case "animation":
|
|
// AtollTrailingContent.animation(data:, size:) — data is named but let's be safe
|
|
break
|
|
default:
|
|
break
|
|
}
|
|
|
|
return [typeName: inner]
|
|
}
|
|
}
|