import Foundation import ParcelCore import ParcelEngine import ParcelPlatform import ParcelUI @MainActor struct AppWorkspaceMemory { let store: WorkspaceStateStore let engine: @MainActor () -> ParcelEngine? let didReset: @MainActor () -> Void func settingsModel() -> WorkspaceMemorySettingsModel { WorkspaceMemorySettingsModel( fileURL: store.fileURL, inspect: { try await inspect() }, reset: { try await reset() }) } func inspect() async throws -> String { do { let memory: WorkspaceMemory if let engine = engine() { memory = try await engine.inspectWorkspaceMemory() } else { let store = store memory = try await Task.detached { try store.load() }.value } let encoder = JSONEncoder() encoder.outputFormatting = [.prettyPrinted, .sortedKeys, .withoutEscapingSlashes] return String(decoding: try encoder.encode(memory), as: UTF8.self) } catch { throw AppWorkspaceMemoryFailure(cause: error) } } @discardableResult func reset() async throws -> URL? { let recoveryURL: URL? do { if let engine = engine() { recoveryURL = try await engine.resetWorkspaceMemory() } else { let store = store recoveryURL = try await Task.detached { try store.reset() }.value } } catch { throw AppWorkspaceMemoryFailure(cause: error) } didReset() return recoveryURL } } struct AppWorkspaceMemoryFailure: LocalizedError, WorkspaceMemoryRecoveryFailure { let cause: any Error var errorDescription: String? { Self.message(for: cause) } var recoveryURL: URL? { if let error = cause as? WorkspaceStateStoreRecoveryError { return error.recoveryURL } return (cause as? any WorkspaceMemoryRecoveryFailure)?.recoveryURL } static func message(for error: any Error) -> String { if let error = error as? AppWorkspaceMemoryFailure { return message(for: error.cause) } if let error = error as? WorkspaceStateStoreRecoveryError { return String( format: AppText.string( "The unreadable layout file was preserved at %@, but recovery could not finish: %@"), error.recoveryURL.path, message(for: error.underlyingError)) } if let error = error as? WorkspaceStateStoreError { switch error { case .unsupportedVersion(let version): return String( format: AppText.string( "Stored layout version %lld is unsupported. This Parcel writes version %lld. The file has not been changed." ), Int64(version), Int64(WorkspaceStateStore.currentVersion)) case .concurrentModification: return AppText.string( "The layout file changed outside Parcel. Inspect it before forgetting or saving again.") case .invalidFileURL: return AppText.string("The layout store must be a regular file at a valid local path.") case .defaultStoreUnavailableInTests: return AppText.string("Tests cannot access your layout store. Use an isolated test file.") } } if error is DecodingError { return AppText.notice( "The layout file is unreadable. Inspect it in Layout settings before forgetting remembered layouts.") } if let error = error as? WorkspaceMemoryError { switch error { case .duplicateWorkspace, .duplicateWindowToken, .invalidWorkspace, .invalidWindow: return AppText.notice( "Remembered layouts contain inconsistent windows or workspaces. Review Layout settings before forgetting them." ) case .invalidTitleSalt, .invalidTimestamp, .invalidPruningPolicy, .windowTokensExhausted: return AppText.notice( "Remembered layout data could not be verified. Review Layout settings; your existing file has not been changed." ) } } if let error = error as? CocoaError { switch error.code { case .fileReadNoPermission, .fileWriteNoPermission: return AppText.notice( "Parcel cannot access the layout file. Check the file’s permissions and try again.") case .fileWriteOutOfSpace: return AppText.notice( "The layout file could not be saved because storage is full. Free some space and try again.") default: break } } return AppText.notice( "The layout file could not be read or saved. Review Layout settings and check the app log for details.") } }