enricobuehler
4cae1b8bb8
Foundation milestone for Live Activities & Widgets (design/apple-live- activities-and-widgets.md). No user-visible change beyond the URL scheme. - New dependency-free PunktfunkShared SwiftPM target (+ library product) so a future widget extension can link it WITHOUT PunktfunkKit (Rust staticlib + presentation layer). Moves StoredHost (model + JSON codec), DefaultsKeys, and punktfunkDefaultMgmtPort there; adds AppGroup.suiteName and the punktfunk:// DeepLink builder/parser. PunktfunkKit @_exported-imports it (no call-site churn for consumers; intra-Kit files import it explicitly since imports are file-scoped). - HostStore reads/writes the shared App-Group suite (group.io.unom.punktfunk) with a one-time migration from UserDefaults.standard (old value left in place for staged rollout); reloads the "PunktfunkHosts" widget timeline on change. - App Group entitlement on iOS/tvOS + macOS. - CFBundleURLTypes scheme `punktfunk`; ContentView.onOpenURL routes connect/<uuid>[?launch=<GameEntry.id>] into the existing connect() path (unknown host / already-streaming guards; never tears down a live session). - Round-trip tests: StoredHost JSON codec (+ legacy missing-optional decode), DeepLink grammar. `swift build` + `swift test` green (142 tests, 0 failures). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
58 lines
2.5 KiB
Swift
58 lines
2.5 KiB
Swift
// The `punktfunk://` deep-link grammar — the single builder/parser shared by the widget (which
|
|
// emits links via `widgetURL`/`Link`) and the app (`ContentView.onOpenURL`, which routes them into
|
|
// the existing connect path). Keeping both sides on one type means the wire format can't drift.
|
|
//
|
|
// Grammar (v1):
|
|
// punktfunk://connect/<host-uuid> — connect to a stored host
|
|
// punktfunk://connect/<host-uuid>?launch=<GameEntry.id> — connect and ask the host to launch it
|
|
//
|
|
// `launch` carries a `GameEntry.id` (e.g. "steam:570"); it is percent-encoded on build and decoded
|
|
// on parse, so ids with reserved characters survive the round trip.
|
|
|
|
import Foundation
|
|
|
|
public enum DeepLink: Equatable {
|
|
/// Connect to a saved host; `launchID` is a `GameEntry.id` to launch on arrival, if any.
|
|
case connect(host: UUID, launchID: String?)
|
|
|
|
public static let scheme = "punktfunk"
|
|
|
|
/// Build the canonical URL for a route. Non-optional: every route is representable.
|
|
public var url: URL {
|
|
switch self {
|
|
case let .connect(host, launchID):
|
|
var comps = URLComponents()
|
|
comps.scheme = Self.scheme
|
|
comps.host = "connect"
|
|
comps.path = "/\(host.uuidString)"
|
|
if let launchID, !launchID.isEmpty {
|
|
comps.queryItems = [URLQueryItem(name: "launch", value: launchID)]
|
|
}
|
|
// URLComponents percent-encodes the query value; force-unwrap is safe for a URL we
|
|
// fully control (scheme/host/path are all valid).
|
|
return comps.url!
|
|
}
|
|
}
|
|
|
|
/// Parse an incoming URL, or nil if it isn't a recognized `punktfunk://` route. Tolerant of
|
|
/// case in the scheme and of a trailing slash on the path.
|
|
public init?(_ url: URL) {
|
|
guard url.scheme?.lowercased() == Self.scheme else { return nil }
|
|
guard let comps = URLComponents(url: url, resolvingAgainstBaseURL: false) else { return nil }
|
|
|
|
switch comps.host?.lowercased() {
|
|
case "connect":
|
|
// Path is "/<uuid>"; strip the leading slash and any trailing one.
|
|
let raw = comps.path
|
|
.trimmingCharacters(in: CharacterSet(charactersIn: "/"))
|
|
guard let host = UUID(uuidString: raw) else { return nil }
|
|
let launch = comps.queryItems?
|
|
.first(where: { $0.name == "launch" })?.value
|
|
.flatMap { $0.isEmpty ? nil : $0 }
|
|
self = .connect(host: host, launchID: launch)
|
|
default:
|
|
return nil
|
|
}
|
|
}
|
|
}
|