KindleAPI

dependencies: [
    .package(url: "https://github.com/natikgadzhi/swift-kindle.git", branch: "main")
]

import KindleAPI

// Initialize the client with authentication session
let client = KindleAPI(secrets: authSession)

// Fetch your library (returns [KindleJSONBook])
let books = try await client.getBooks()

// Get book details and metadata
let (details, metadata) = try await client.getBookMetadata(asin: "B001234567")

// Get annotations for a book
let annotations = try await client.getAnnotations(
    for: details.asin,
    refEmId: metadata.refEmId,
    yjFormatVersion: details.yjFormatVersion
)

// Alternative: fetch books from HTML notebook (returns [KindleHTMLBook])
// This returns a _different_ list of books — not just the books
// you _currently own_ in Kindle, but all the books that you have any annotations for.
let htmlBooks = try await client.getHTMLBooks()