Repository Public
1// SP Wallet iOS2// File: Core/Persistence/AppCache.swift3// Description: The app's offline snapshots: the last data the server gave, kept for read-only consultation without network.4// Public information only (addresses, balances, history, prices) — never the session token, never anything that5// can sign. Every snapshot carries the time it was saved; screens show that age and never present it as live.6//7// Author: Simon-Pierre Boucher8// Contact: contact@spboucher.ai9import Foundation10import SPWalletCore1112struct Cached<T: Sendable>: Sendable {13 let value: T14 let savedAt: Date15 var age: TimeInterval { Date().timeIntervalSince(savedAt) }16}1718actor AppCache {19 private struct Envelope<T: Codable>: Codable { let savedAt: Date; let value: T }20 private let directory: URL?21 private var memory: [String: Data] = [:]2223 /** - Parameter directory: nil keeps everything in memory (UI tests, previews). */24 init(directory: URL?) {25 self.directory = directory26 if let directory { try? FileManager.default.createDirectory(at: directory, withIntermediateDirectories: true) }27 }2829 static func defaultDirectory() -> URL {30 let base = FileManager.default.urls(for: .applicationSupportDirectory, in: .userDomainMask)[0]31 return base.appendingPathComponent("offline", isDirectory: true)32 }3334 private func url(_ key: String) -> URL? {35 let safe = key.replacingOccurrences(of: "[^A-Za-z0-9._-]", with: "_", options: .regularExpression)36 return directory?.appendingPathComponent(safe + ".json")37 }3839 func save<T: Codable & Sendable>(_ value: T, key: String, at date: Date = Date()) {40 guard let data = try? APICoding.encoder().encode(Envelope(savedAt: date, value: value)) else { return }41 memory[key] = data42 guard let u = url(key) else { return }43 // readable after the first unlock so that the background refresh and the widget timeline can update; public data only44 try? data.write(to: u, options: [.atomic, .completeFileProtectionUntilFirstUserAuthentication])45 var values = URLResourceValues(); values.isExcludedFromBackup = true46 var m = u; try? m.setResourceValues(values)47 }4849 func load<T: Codable & Sendable>(_ type: T.Type = T.self, key: String) -> Cached<T>? {50 let data: Data51 if let d = memory[key] { data = d }52 else if let u = url(key), let d = try? Data(contentsOf: u) { data = d }53 else { return nil }54 guard let e = try? APICoding.decoder().decode(Envelope<T>.self, from: data) else {55 // a snapshot written by another version or damaged: forget it rather than show something wrong56 memory[key] = nil57 if let u = url(key) { try? FileManager.default.removeItem(at: u) }58 return nil59 }60 memory[key] = data61 return Cached(value: e.value, savedAt: e.savedAt)62 }6364 /** Sign-out: nothing of the wallet stays on the device. */65 func removeAll() {66 memory.removeAll()67 guard let directory, let files = try? FileManager.default.contentsOfDirectory(at: directory, includingPropertiesForKeys: nil) else { return }68 for f in files { try? FileManager.default.removeItem(at: f) }69 }7071 var isEmpty: Bool {72 if !memory.isEmpty { return false }73 guard let directory else { return true }74 return ((try? FileManager.default.contentsOfDirectory(atPath: directory.path)) ?? []).isEmpty75 }76}77