zitare-native/Sources/App/DeepLinkRouter.swift
Till c89d48c6f6 ζ-2 native: SwiftData-Snapshot-Cache + DailyQuoteWidget
- SnapshotModels.swift: CachedQuote (slug-unique, themes/regions
  als CSV), SnapshotMeta (singleton mit lastSyncedAt + totalCount),
  SnapshotContainer.make() mit App-Group-Store-URL (Fallback auf
  App-Container für Dev ohne Apple-Dev-Portal-Setup)
- SnapshotSync (actor) mit injectable Loader für Tests: refresh /
  refreshIfStale / tryRefresh (fail-soft). Re-konsolidiert beim Pull
  (Update + Insert + Delete entzogene Slugs). 24h-Staleness-Default.
- DailyQuoteWidget: Hash-of-Day-Picker aus SwiftData, drei Sizes,
  Mitternacht-Refresh-Policy, Placeholder bei leerem Store. Widget-
  Target zieht SnapshotModels.swift mit (project.yml).
- ZitareNativeApp triggert SnapshotSync.tryRefresh() bei Launch +
  WidgetCenter.reloadAllTimelines() danach.
- AppConfig.snapshotURL = webBaseURL/index-min.json (Web-Endpoint
  noch nicht live, fail-soft).
- DeepLinkRouter Substring-Guard fix (`/t` statt `/t/` im
  Prefix-Array, sonst greift hasPrefix("/t//") nicht).
- 22 Tests grün (6 AppConfig + 11 DeepLinkRouter + 3 SnapshotSync +
  1 UI + 1 Widget-Compile-Smoke), swiftlint 0 violations in 22 Files

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 13:16:05 +02:00

38 lines
1.6 KiB
Swift

import Foundation
/// Routet sowohl Custom-Scheme- (`zitare://`) als auch Universal-Link-URLs
/// (`zitare.com/...`) auf eine konkrete `WebTarget` + Ziel-Tab.
///
/// Pure-Logic, kein State easy testbar.
enum DeepLinkRouter {
/// Mapt eine externe URL auf eine WebShell-URL.
/// `zitare://quote/x` `https://zitare.com/q/x`,
/// `zitare://author/x` `https://zitare.com/a/x`,
/// `zitare://collection/x` `https://zitare.com/c/x`.
/// `https://*` bleibt unverändert.
static func resolveToWebURL(_ url: URL, base: URL) -> URL {
if url.scheme == "zitare" {
let host = url.host ?? ""
let path = url.path
switch host {
case "quote": return base.appendingPathComponent("q\(path)")
case "author": return base.appendingPathComponent("a\(path)")
case "collection": return base.appendingPathComponent("c\(path)")
default: return base
}
}
return url
}
/// `true` wenn der Pfad in den Erkunden-Tab gehört. Sonst Lesen-Tab.
static func isExplorePath(_ path: String) -> Bool {
let prefixes = ["/explore", "/region", "/thema", "/rolle", "/epoche", "/sprache", "/search", "/t"]
return prefixes.contains { path == $0 || path.hasPrefix($0 + "/") }
}
/// One-Shot-Resolution: URL + Base (resolvedURL, isExploreTab).
static func route(_ url: URL, base: URL) -> (url: URL, isExplore: Bool) {
let resolved = resolveToWebURL(url, base: base)
return (resolved, isExplorePath(resolved.path))
}
}