dependencies: [
    .package(url: "https://github.com/SeeYouSwift/SugarStorage", from: "1.0.0")
],
targets: [
    .target(
        name: "YourTarget",
        dependencies: ["SugarStorage"]
    ),
    // For test targets — add the mock library:
    .testTarget(
        name: "YourTargetTests",
        dependencies: [
            "YourTarget",
            .product(name: "SugarStorageMocks", package: "SugarStorage")
        ]
    )
]

import SugarStorage

struct UserSettings: Codable {
    var darkMode: Bool
    var fontSize: Int
}

let storage = SugarStorage(directoryName: "MyApp")

// Save
try storage.save(UserSettings(darkMode: true, fontSize: 16), forKey: "settings/user")

// Load
let settings = try storage.load(forKey: "settings/user", as: UserSettings.self)

let data = Data([0x89, 0x50, 0x4E, 0x47]) // PNG header bytes
try storage.saveData(data, forKey: "cache/header.bin")

let loaded = try storage.loadData(forKey: "cache/header.bin")

if storage.exists(forKey: "settings/user") {
    try storage.delete(forKey: "settings/user")
}

final class SettingsRepository {
    private let storage: SugarStorageProtocol

    init(storage: SugarStorageProtocol = SugarStorage(directoryName: "MyApp")) {
        self.storage = storage
    }

    func saveSettings(_ settings: UserSettings) throws {
        try storage.save(settings, forKey: "settings/user")
    }
}

import SugarStorageMocks

let mock = MockStorageService()
mock.shouldThrowOnSave = false

let repo = SettingsRepository(storage: mock)
try repo.saveSettings(UserSettings(darkMode: false, fontSize: 14))

XCTAssertEqual(mock.saveCallCount, 1)

func save<T: Encodable & Sendable>(_ value: T, forKey key: String) throws
func load<T: Decodable & Sendable>(forKey key: String, as type: T.Type) throws -> T
func saveData(_ data: Data, forKey key: String) throws
func loadData(forKey key: String) throws -> Data
func delete(forKey key: String) throws
func exists(forKey key: String) -> Bool