readwise 0.4.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 766eb82d68f06591b6e05211877532619182404c3aa29c24720de5cd1788ad0a
-  data.tar.gz: 70b4affa8b2e46271fb1d690e00328be10e1fcbb5fd6a3d5ae08135947818671
+  metadata.gz: c3d14c72c58cb11dfcb79c0b3b232abb8b997dc230493d5e0765f186999accba
+  data.tar.gz: 037ac6d22c2d195607023e99eebbd71f2885996dd40e16d49f33bc403549ebd9
 SHA512:
-  metadata.gz: f6b8cda492331d61352a83bc01732fee2d30191419b226327334daf4c00338afe6876bfb5b806318506bc42a5706f826225a2c917dcaf17a0172d9c12cc3cd08
-  data.tar.gz: 7b2e849cc2bff772ebe84c7b93cb0b7bdf9c506c9bce80a79754554590a537717c39882f6b04faa8e43105b5eac20598fd89f1a39002746d8212557a4bdaf42d
+  metadata.gz: 6b25268acdd085ba3252f828a0f85051f492de64fd851e96a5a0e38bfcfb6e25070df8bc38d7fa94aa52c1433003d6dc8d57ca501d7261bef010e510b6711c13
+  data.tar.gz: 1d1c7e40a53214750405a866832427aadce2ad3dc432a4d9e4ab0610520400b1f5fb14d46d90712cc0219621eb2bef21c4bff40bb62def052e99409bfd0b0b86

data/.github/FUNDING.yml

@@ -1,3 +1,3 @@
 # These are supported funding model platforms
 
-github: andjosh
+github: joshbeckman

data/CHANGELOG.md

@@ -2,17 +2,29 @@
 
 ## [Unreleased]
 
+## [1.0.0] - 2025-06-29
+- Add Readwise API v3 support for Reader documents ([#13](https://github.com/joshbeckman/readwise-ruby/pull/13))
+- Add `daily_review` client method and Review type ([#14](https://github.com/joshbeckman/readwise-ruby/pull/14))
+- Add comprehensive document API methods (list, get, create, update, delete)
+- Add support for document tags and metadata handling
+- Add tests for document API functionality
+
+## [0.5.0] - 2023-06-15
+- Add methods to create/update highlights ([#8](https://github.com/joshbeckman/readwise-ruby/pull/12))
+- Add methods to add/update/remove highlight tags
+- Add method to get book
+
 ## [0.4.0] - 2023-03-19
 
-- Add `get_highlight` client method ([#10](https://github.com/andjosh/readwise-ruby/pull/10) from [@ajistrying](https://github.com/ajistrying))
+- Add `get_highlight` client method ([#10](https://github.com/joshbeckman/readwise-ruby/pull/10) from [@ajistrying](https://github.com/ajistrying))
 
 ## [0.3.0] - 2023-02-28
 
-- Change `Tag` from hash to struct ([#6](https://github.com/andjosh/readwise-ruby/pull/6) from [@ajistrying](https://github.com/ajistrying))
+- Change `Tag` from hash to struct ([#6](https://github.com/joshbeckman/readwise-ruby/pull/6) from [@ajistrying](https://github.com/ajistrying))
 
 ## [0.2.0] - 2023-02-20
 
-- Add support for `Book.note` ([#4](https://github.com/andjosh/readwise-ruby/pull/4))
+- Add support for `Book.note` ([#4](https://github.com/joshbeckman/readwise-ruby/pull/4))
 
 ## [0.1.0] - 2023-01-16
 

data/CODE_OF_CONDUCT.md

@@ -55,7 +55,7 @@ further defined and clarified by project maintainers.
 ## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at email@andjosh.com. All
+reported by contacting the project team at josh@joshbeckman.org. All
 complaints will be reviewed and investigated and will result in a response that
 is deemed necessary and appropriate to the circumstances. The project team is
 obligated to maintain confidentiality with regard to the reporter of an incident.

data/README.md

@@ -1,6 +1,8 @@
 # Readwise
 
-[Readwise](https://readwise.io/) is an application suite to store, revisit, and learn from your book and article highlights. This is a basic library to call the [Readwise API](https://readwise.io/api_deets) to read and write highlights.
+[![Gem Version](https://badge.fury.io/rb/readwise.svg)](https://badge.fury.io/rb/readwise) [![Ruby](https://github.com/joshbeckman/readwise-ruby/actions/workflows/ruby.yml/badge.svg)](https://github.com/joshbeckman/readwise-ruby/actions/workflows/ruby.yml)
+
+[Readwise](https://readwise.io/) is an application suite to store, revisit, and learn from your book and article highlights. This is a basic library to call the [Readwise API](https://readwise.io/api_deets) to read and write highlights, and manage Reader documents through the [Reader API](https://readwise.io/reader_api).
 
 This library is not at 100% coverage of the API, so if you need a method that is missing, open an issue or contribute changes!
 
@@ -24,6 +26,10 @@ Or install it yourself as:
 
 First, obtain an API access token from https://readwise.io/access_token.
 
+### Highlights API (V2)
+
+The [V2 API](https://readwise.io/api_deets) provides access to your highlights and books:
+
 ```ruby
 client = Readwise::Client.new(token: token)
 
@@ -33,17 +39,118 @@ books = client.export(book_ids: ['123']) # export specific highlights
 
 puts books.first.title # books are Readwise::Book structs
 puts books.first.highlights.map(&:text) # highlights are Readwise::Highlight structs
+
+# create a highlight
+create = Readwise::HighlightCreate.new(text: 'foobar', author: 'Joan')
+highlight = client.create_highlight(highlight: create)
+
+# update a highlight
+update = Readwise::HighlightUpdate.new(text: 'foobaz', color: 'yellow')
+updated = client.update_highlight(highlight: highlight, update: update)
+
+# add a tag to a highlight
+tag = Readwise::Tag.new(name: 'foobar')
+added_tag = client.add_highlight_tag(highlight: highlight, tag: tag)
+
+# update a tag on a highlight
+added_tag.name = 'bing'
+updated_tag = client.update_highlight_tag(highlight: highlight, tag: added_tag)
+
+# remove a tag from a highlight
+client.remove_highlight_tag(highlight: highlight, tag: added_tag)
+
+# get daily review highlights
+daily_review = client.daily_review
+puts daily_review.id
+puts daily_review.url
+puts daily_review.completed?
+puts daily_review.highlights.size
+puts daily_review.highlights.first.text
+```
+
+### Reader API (V3)
+
+The [V3 API](https://readwise.io/reader_api) provides access to Readwise Reader functionality for managing documents (articles, PDFs, etc.):
+
+```ruby
+# Get all documents
+documents = client.get_documents
+
+# Get documents with filters
+documents = client.get_documents(
+  updated_after: '2023-01-01T00:00:00Z',
+  location: 'new',        # 'new', 'later', 'archive', or 'feed'
+  category: 'article'     # 'article', 'email', 'rss', 'highlight', 'note', 'pdf', 'epub', 'tweet', 'video'
+)
+
+# Get a specific document
+document = client.get_document(document_id: '123456')
+
+puts document.title
+puts document.author
+puts document.url
+puts document.reading_progress
+puts document.location
+puts document.category
+
+# Check document properties
+puts document.read?                    # reading progress >= 85%
+puts document.read?(threshold: 0.5)    # custom threshold
+puts document.parent?                  # is this a top-level document?
+puts document.child?                   # is this a highlight/note of another document?
+
+# Check location
+puts document.in_new?
+puts document.in_later?  
+puts document.in_archive?
+
+# Check category
+puts document.article?
+puts document.pdf?
+puts document.epub?
+puts document.tweet?
+puts document.video?
+puts document.book?
+puts document.email?
+puts document.rss?
+puts document.highlight?
+puts document.note?
+
+# Access timestamps
+puts document.created_at_time
+puts document.updated_at_time
+puts document.published_date_time
+
+# Create a new document
+document_create = Readwise::DocumentCreate.new(
+  url: 'https://example.com/article',
+  title: 'My Article',
+  author: 'John Doe',
+  html: '<p>Article content</p>',
+  summary: 'A brief summary',
+  location: 'new',           # 'new', 'later', 'archive', or 'feed'
+  category: 'article',       # 'article', 'email', 'rss', etc.
+  tags: ['technology', 'programming'],
+  notes: 'My personal notes',
+  should_clean_html: true,
+  saved_using: 'api'
+)
+
+document = client.create_document(document: document_create)
+
+# Create multiple documents
+documents = client.create_documents(documents: [document_create1, document_create2])
 ```
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rspec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/andjosh/readwise. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+Bug reports and pull requests are welcome on GitHub at https://github.com/joshbeckman/readwise-ruby. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
 ## License
 
@@ -51,4 +158,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Readwise project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/andjosh/readwise/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the Readwise project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/joshbeckman/readwise-ruby/blob/main/CODE_OF_CONDUCT.md).

data/lib/readwise/book.rb

@@ -10,6 +10,7 @@ module Readwise
     :cover_image_url,
     :highlights,
     :note,
+    :num_highlights,
     :readable_title,
     :readwise_url,
     :source,

data/lib/readwise/client.rb

@@ -3,34 +3,137 @@ require 'net/http'
 require_relative 'book'
 require_relative 'highlight'
 require_relative 'tag'
+require_relative 'document'
+require_relative 'review'
 
 module Readwise
   class Client
     class Error < StandardError; end
 
     BASE_URL = "https://readwise.io/api/v2/"
+    V3_BASE_URL = "https://readwise.io/api/v3/"
 
     def initialize(token: nil)
       raise ArgumentError unless token
+
       @token = token.to_s
     end
 
+    def create_document(document:)
+      raise ArgumentError unless document.is_a?(Readwise::DocumentCreate)
+
+      url = V3_BASE_URL + 'save/'
+
+      res = post_readwise_request(url, payload: document.serialize)
+      get_document(document_id: res['id'])
+    end
+
+    def create_documents(documents: [])
+      return [] unless documents.any?
+
+      documents.map do |document|
+        create_document(document: document)
+      end
+    end
+
+    def get_document(document_id:)
+      url = V3_BASE_URL + "list?id=#{document_id}"
+
+      res = get_readwise_request(url)
+
+      res['results'].map { |item| transform_document(item) }.first
+    end
+
+    def get_documents(updated_after: nil, location: nil, category: nil)
+      resp = documents_page(updated_after: updated_after, location: location, category: category)
+      next_page_cursor = resp[:next_page_cursor]
+      results = resp[:results]
+      while next_page_cursor
+        resp = documents_page(updated_after: updated_after, location: location, category: category, page_cursor: next_page_cursor)
+        results.concat(resp[:results])
+        next_page_cursor = resp[:next_page_cursor]
+      end
+      results.sort_by(&:created_at)
+    end
+
     def create_highlight(highlight:)
-      create_highlights([highlight])
+      create_highlights(highlights: [highlight]).first
     end
 
     def create_highlights(highlights: [])
-      raise NotImplementedError
+      raise ArgumentError unless highlights.all? { |item| item.is_a?(Readwise::HighlightCreate) }
+      return [] unless highlights.any?
+
+      url = BASE_URL + 'highlights/'
+
+      payload = { highlights: highlights.map(&:serialize) }
+      res = post_readwise_request(url, payload: payload)
+
+      modified_ids = res.map { |book| book['modified_highlights'] }.flatten
+      modified_ids.map { |id| get_highlight(highlight_id: id) }
     end
 
     def get_highlight(highlight_id:)
-      url = BASE_URL + 'highlights/' + highlight_id
+      url = BASE_URL + "highlights/#{highlight_id}"
 
       res = get_readwise_request(url)
 
       transform_highlight(res)
     end
 
+    def update_highlight(highlight:, update:)
+      raise ArgumentError unless update.is_a?(Readwise::HighlightUpdate)
+
+      url = BASE_URL + "highlights/#{highlight.highlight_id}"
+
+      res = patch_readwise_request(url, payload: update.serialize)
+
+      transform_highlight(res)
+    end
+
+    def remove_highlight_tag(highlight:, tag:)
+      url = BASE_URL + "highlights/#{highlight.highlight_id}/tags/#{tag.tag_id}"
+
+      delete_readwise_request(url)
+    end
+
+    def add_highlight_tag(highlight:, tag:)
+      raise ArgumentError unless tag.is_a?(Readwise::Tag)
+
+      url = BASE_URL + "highlights/#{highlight.highlight_id}/tags"
+
+      payload = tag.serialize.select { |k, v| k == :name }
+      res = post_readwise_request(url, payload: payload)
+
+      transform_tag(res)
+    end
+
+    def update_highlight_tag(highlight:, tag:)
+      raise ArgumentError unless tag.is_a?(Readwise::Tag)
+
+      url = BASE_URL + "highlights/#{highlight.highlight_id}/tags/#{tag.tag_id}"
+
+      payload = tag.serialize.select { |k, v| k == :name }
+      res = patch_readwise_request(url, payload: payload)
+
+      transform_tag(res)
+    end
+
+    def get_book(book_id:)
+      url = BASE_URL + "books/#{book_id}"
+
+      res = get_readwise_request(url)
+
+      transform_book(res)
+    end
+
+    def daily_review
+      url = BASE_URL + 'review/'
+
+      res = get_readwise_request(url)
+      transform_review(res)
+    end
+
     def export(updated_after: nil, book_ids: [])
       resp = export_page(updated_after: updated_after, book_ids: book_ids)
       next_page_cursor = resp[:next_page_cursor]
@@ -45,25 +148,32 @@ module Readwise
 
     private
 
+    def documents_page(page_cursor: nil, updated_after:, location:, category:)
+      parsed_body = get_documents_page(page_cursor: page_cursor, updated_after: updated_after, location: location, category: category)
+      results = parsed_body.dig('results').map do |item|
+        transform_document(item)
+      end
+      {
+        results: results,
+        next_page_cursor: parsed_body.dig('nextPageCursor')
+      }
+    end
+
+    def get_documents_page(page_cursor: nil, updated_after:, location:, category:)
+      params = {}
+      params['updatedAfter'] = updated_after if updated_after
+      params['location'] = location if location
+      params['category'] = category if category
+      params['pageCursor'] = page_cursor if page_cursor
+      url = V3_BASE_URL + 'list/?' + URI.encode_www_form(params)
+
+      get_readwise_request(url)
+    end
+
     def export_page(page_cursor: nil, updated_after: nil, book_ids: [])
       parsed_body = get_export_page(page_cursor: page_cursor, updated_after: updated_after, book_ids: book_ids)
       results = parsed_body.dig('results').map do |item|
-        Book.new(
-          asin: item['asin'],
-          author: item['author'],
-          book_id: item['user_book_id'].to_s,
-          category: item['category'],
-          cover_image_url: item['cover_image_url'],
-          note: item['document_note'],
-          readable_title: item['readable_title'],
-          readwise_url: item['readwise_url'],
-          source: item['source'],
-          source_url: item['source_url'],
-          tags: item['book_tags'].map { |tag| transform_tag(tag) },
-          title: item['title'],
-          unique_url: item['unique_url'],
-          highlights: item['highlights'].map { |highlight| transform_highlight(highlight) },
-        )
+        transform_book(item)
       end
       {
         results: results,
@@ -79,7 +189,27 @@ module Readwise
       url = BASE_URL + 'export/?' + URI.encode_www_form(params)
 
       get_readwise_request(url)
+    end
 
+    def transform_book(res)
+      highlights = (res['highlights'] || []).map { |highlight| transform_highlight(highlight) }
+      Book.new(
+        asin: res['asin'],
+        author: res['author'],
+        book_id: res['user_book_id'].to_s,
+        category: res['category'],
+        cover_image_url: res['cover_image_url'],
+        note: res['document_note'],
+        readable_title: res['readable_title'],
+        readwise_url: res['readwise_url'] || res['highlights_url'],
+        source: res['source'],
+        source_url: res['source_url'],
+        tags: (res['book_tags'] || res['tags'] || []).map { |tag| transform_tag(tag) },
+        title: res['title'],
+        unique_url: res['unique_url'],
+        highlights: highlights,
+        num_highlights: res['num_highlights'] || highlights.size,
+      )
     end
 
     def transform_highlight(res)
@@ -104,13 +234,66 @@ module Readwise
       )
     end
 
+    def transform_document(res)
+      Document.new(
+        author: res['author'],
+        category: res['category'],
+        created_at: res['created_at'],
+        html: res['html'],
+        id: res['id'].to_s,
+        image_url: res['image_url'],
+        location: res['location'],
+        notes: res['notes'],
+        parent_id: res['parent_id'],
+        published_date: res['published_date'],
+        reading_progress: res['reading_progress'],
+        site_name: res['site_name'],
+        source: res['source'],
+        source_url: res['source_url'],
+        summary: res['summary'],
+        tags: transform_tags(res['tags']),
+        title: res['title'],
+        updated_at: res['updated_at'],
+        url: res['url'],
+        word_count: res['word_count'],
+      )
+    end
+
+    def transform_tags(res)
+      if res.is_a?(Array)
+        res.map { |tag| transform_tag(tag) }
+      elsif res.is_a?(Hash)
+        res.map do |tag_id, tag|
+          tag['id'] = tag_id
+          transform_tag(tag)
+        end
+      else
+        []
+      end
+    end
+
     def transform_tag(res)
+      if res.is_a?(String)
+        return Tag.new(name: res)
+      end
+
       Tag.new(
-        tag_id: res['id'].to_s,
+        tag_id: res['id']&.to_s,
         name: res['name'],
       )
     end
 
+    def transform_review(res)
+      highlights = (res['highlights'] || []).map { |highlight| transform_highlight(highlight) }
+
+      Review.new(
+        id: res['review_id'],
+        url: res['review_url'],
+        completed: res['review_completed'],
+        highlights: highlights
+      )
+    end
+
     def get_readwise_request(url)
       uri = URI.parse(url)
       req = Net::HTTP::Get.new(uri)
@@ -118,10 +301,51 @@ module Readwise
       res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
         http.request(req)
       end
-      
-      raise Error, 'Export request failed' unless res.is_a?(Net::HTTPSuccess)
-  
+
+      raise Error, "Get request failed with status code: #{res.code}" unless res.is_a?(Net::HTTPSuccess)
+
+      JSON.parse(res.body)
+    end
+
+    def patch_readwise_request(url, payload:)
+      uri = URI.parse(url)
+      req = Net::HTTP::Patch.new(uri)
+      req['Authorization'] = "Token #{@token}"
+      req['Content-Type'] = 'application/json'
+      req.body = payload.to_json
+      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
+        http.request(req)
+      end
+
+      raise Error, 'Patch request failed' unless res.is_a?(Net::HTTPSuccess)
+
       JSON.parse(res.body)
     end
+
+    def post_readwise_request(url, payload:)
+      uri = URI.parse(url)
+      req = Net::HTTP::Post.new(uri)
+      req['Authorization'] = "Token #{@token}"
+      req['Content-Type'] = 'application/json'
+      req.body = payload.to_json
+      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
+        http.request(req)
+      end
+
+      raise Error, 'Post request failed' unless res.is_a?(Net::HTTPSuccess)
+
+      JSON.parse(res.body)
+    end
+
+    def delete_readwise_request(url)
+      uri = URI.parse(url)
+      req = Net::HTTP::Delete.new(uri)
+      req['Authorization'] = "Token #{@token}"
+      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
+        http.request(req)
+      end
+
+      raise Error, 'Delete request failed' unless res.is_a?(Net::HTTPSuccess)
+    end
   end
 end

data/lib/readwise/document.rb

@@ -0,0 +1,140 @@
+require 'time'
+
+module Readwise
+  Document = Struct.new(
+    'ReadwiseDocument',
+    :author,
+    :category,  # One of: article, email, rss, highlight, note, pdf, epub, tweet or video.
+                # Default is guessed based on the URL, usually article.
+    :created_at,
+    :html,
+    :id,
+    :image_url,
+    :location,  # One of: new, later, archive or feed. Default is new.
+    :notes,
+    :published_date,
+    :reading_progress,
+    :site_name,
+    :source,
+    :source_url,
+    :summary,
+    :tags,
+    :title,
+    :updated_at,
+    :url,
+    :word_count,
+    :parent_id, # both highlights and notes made in Reader are also considered Documents.
+                # Highlights and notes will have `parent_id` set, which is the Document id
+                # of the article/book/etc and highlight that they belong to, respectively.
+    keyword_init: true
+  ) do
+    def created_at_time
+      return unless created_at
+
+      Time.parse(created_at)
+    end
+
+    def updated_at_time
+      return unless updated_at
+
+      Time.parse(updated_at)
+    end
+
+    def published_date_time
+      return unless published_date
+
+      Time.at(published_date/1000)
+    end
+
+    def read?(threshold: 0.85)
+      reading_progress >= threshold
+    end
+
+    def parent?
+      parent_id.nil?
+    end
+
+    def child?
+      !parent?
+    end
+
+    def in_new?
+      location == 'new'
+    end
+
+    def in_later?
+      location == 'later'
+    end
+
+    def in_archive?
+      location == 'archive'
+    end
+
+    def pdf?
+      category == 'pdf'
+    end
+
+    def epub?
+      category == 'epub'
+    end
+
+    def tweet?
+      category == 'tweet'
+    end
+
+    def video?
+      category == 'video'
+    end
+
+    def article?
+      category == 'article'
+    end
+
+    def book?
+      category == 'book'
+    end
+
+    def email?
+      category == 'email'
+    end
+
+    def rss?
+      category == 'rss'
+    end
+
+    def highlight?
+      category == 'highlight'
+    end
+
+    def note?
+      category == 'note'
+    end
+
+    def serialize
+      to_h
+    end
+  end
+
+  DocumentCreate = Struct.new(
+    'ReadwiseDocumentCreate',
+    :author,
+    :category,  # One of: article, email, rss, highlight, note, pdf, epub, tweet or video.
+                # Default is guessed based on the URL, usually article.
+    :html,
+    :image_url,
+    :location,  # One of: new, later, archive or feed. Default is new.
+    :notes,
+    :published_date,
+    :saved_using,
+    :should_clean_html,
+    :summary,
+    :tags,
+    :title,
+    :url,
+    keyword_init: true
+  ) do
+    def serialize
+      to_h.compact
+    end
+  end
+end

data/lib/readwise/highlight.rb

@@ -39,5 +39,45 @@ module Readwise
 
       Time.parse(highlighted_at)
     end
+
+    def serialize
+      to_h
+    end
+  end
+
+  HighlightCreate = Struct.new(
+    'ReadwiseHighlightCreate',
+    :author,
+    :category,  # One of: books, articles, tweets or podcasts.
+                # (default: articles when source_url is provided, otherwise: books)
+    :highlight_url,
+    :highlighted_at,
+    :image_url,
+    :location,
+    :location_type, # One of: page, order or time_offset (default: order)
+    :note,
+    :source_type,
+    :source_url,
+    :text,
+    :title,
+    keyword_init: true
+  ) do
+    def serialize
+      to_h.compact
+    end
+  end
+
+  HighlightUpdate = Struct.new(
+    'ReadwiseHighlightUpdate',
+    :color,
+    :location,
+    :note,
+    :text,
+    :url,
+    keyword_init: true
+  ) do
+    def serialize
+      to_h.compact
+    end
   end
 end

data/lib/readwise/review.rb

@@ -0,0 +1,17 @@
+module Readwise
+  Review = Struct.new(
+    :id,
+    :url,
+    :completed,
+    :highlights,
+    keyword_init: true
+  ) do
+    def completed?
+      completed
+    end
+
+    def serialize
+      to_h.compact
+    end
+  end
+end

data/lib/readwise/tag.rb

@@ -4,5 +4,9 @@ module Readwise
     :tag_id,
     :name,
     keyword_init: true
-  )
+  ) do
+    def serialize
+      to_h
+    end
+  end
 end

data/lib/readwise/version.rb

@@ -1,3 +1,3 @@
 module Readwise
-  VERSION = "0.4.0"
+  VERSION = "1.0.0"
 end

data/lib/readwise.rb

@@ -1,5 +1,5 @@
-require 'readwise/version'
-require 'readwise/client'
+require_relative 'readwise/version'
+require_relative 'readwise/client'
 
 module Readwise
   class Error < StandardError; end

data/readwise.gemspec

@@ -11,7 +11,7 @@ Gem::Specification.new do |spec|
 
   spec.summary       = "Readwise API client"
   spec.description   = "Minimal Readwise API client and highlight parsing library"
-  spec.homepage      = "https://github.com/andjosh/readwise-ruby"
+  spec.homepage      = "https://github.com/joshbeckman/readwise-ruby"
   spec.license       = "MIT"
 
   # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
@@ -22,6 +22,7 @@ Gem::Specification.new do |spec|
     spec.metadata["homepage_uri"] = spec.homepage
     spec.metadata["source_code_uri"] = spec.homepage
     spec.metadata["changelog_uri"] = spec.homepage + "/blob/main/CHANGELOG.md"
+    spec.metadata["funding_uri"] = "https://github.com/sponsors/joshbeckman"
   else
     raise "RubyGems 2.0 or newer is required to protect against " \
       "public gem pushes."

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: readwise
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Josh Beckman
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-03-19 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -87,19 +86,21 @@ files:
 - lib/readwise.rb
 - lib/readwise/book.rb
 - lib/readwise/client.rb
+- lib/readwise/document.rb
 - lib/readwise/highlight.rb
+- lib/readwise/review.rb
 - lib/readwise/tag.rb
 - lib/readwise/version.rb
 - readwise.gemspec
-homepage: https://github.com/andjosh/readwise-ruby
+homepage: https://github.com/joshbeckman/readwise-ruby
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/andjosh/readwise-ruby
-  source_code_uri: https://github.com/andjosh/readwise-ruby
-  changelog_uri: https://github.com/andjosh/readwise-ruby/blob/main/CHANGELOG.md
-post_install_message:
+  homepage_uri: https://github.com/joshbeckman/readwise-ruby
+  source_code_uri: https://github.com/joshbeckman/readwise-ruby
+  changelog_uri: https://github.com/joshbeckman/readwise-ruby/blob/main/CHANGELOG.md
+  funding_uri: https://github.com/sponsors/joshbeckman
 rdoc_options: []
 require_paths:
 - lib
@@ -114,8 +115,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.7
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Readwise API client
 test_files: []