tinysky 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 684a3be9f4c117588a0abadfaa148e33fa90d45b8d261fc7e554e053433adc38
-  data.tar.gz: 68722993bf6155095a02c95caaf538bb1cb56f2ac32f044f09c46c2bd7be9688
+  metadata.gz: 276b6d688f7a617d0d2a3ab3b4933f43144b19e7451a7e06fa6c83ad49f80cba
+  data.tar.gz: db21e24e978955fe7f4c3087e342e3c2a7eda1f8e2b8ad4983e2a890d0b60562
 SHA512:
-  metadata.gz: 9805134a66b69b767c2891fb48fd290b85f7c79f0fe9bb7694786cea6bc5d22344b9de282e0c7047098639f60a064c5c995f4cb84dd695eeffd13c15eb36e200
-  data.tar.gz: 486fa0974e2756090a2f15c49f178df1707e72e90c486771cccb263f60e7d28cbd18a8b6a8662534b284f489346d6c79064180e565073c60b07ceb1c85347b17
+  metadata.gz: 6c9481b63bbf00e0b2fb77b2af51a09321a1dcefbc951675a3297191a5067ab913032cd63865423c6012b12d06fc8c4ee70ce10b89fbb614672e9515551579cb
+  data.tar.gz: ab878e737f2f974073323f6baf28ab0b967572aacaae533a37c94ab2a45985351db63a95e8ecf9570af325957084f44c2c84c243bf19300585211b63323708e8

data/.tool-versions

@@ -0,0 +1 @@
+ruby 4.0.1

data/CHANGELOG.md

@@ -22,6 +22,23 @@ The format is based on [Keep a Changelog][] and this project adheres to
 
 ### Security
 
+## [0.0.4][] - 2026-02-22
+
+### Added
+
+* Add update script ([#7][])
+* Add support for link facets ([#15][])
+* Add support for record embeds ([#16][])
+
+### Changed
+
+* Use Zeitwerk for loading ([#10][])
+* Update Ruby matrix for CI ([#11][])
+* Upgrade to Ruby 4 ([#12][])
+* Improve CI configuration ([#13][])
+* Extract modules for api details ([#14][])
+* Move to automated release on CI ([#17][])
+
 ## [0.0.3][] - 2024-09-15
 
 ### Changed
@@ -45,13 +62,23 @@ The format is based on [Keep a Changelog][] and this project adheres to
 
 * Initial release
 
-[Unreleased]: https://github.com/jonallured/tinysky/compare/v0.0.3...HEAD
+[Unreleased]: https://github.com/jonallured/tinysky/compare/v0.0.4...HEAD
 
 [0.0.1]: https://github.com/jonallured/tinysky/releases/tag/v0.0.1
 [0.0.2]: https://github.com/jonallured/tinysky/releases/tag/v0.0.2
-[0.0.2]: https://github.com/jonallured/tinysky/releases/tag/v0.0.3
+[0.0.3]: https://github.com/jonallured/tinysky/releases/tag/v0.0.3
+[0.0.4]: https://github.com/jonallured/tinysky/releases/tag/v0.0.4
 
 [#3]: https://github.com/jonallured/tinysky/pull/3
 [#4]: https://github.com/jonallured/tinysky/pull/4
 [#5]: https://github.com/jonallured/tinysky/pull/5
 [#6]: https://github.com/jonallured/tinysky/pull/6
+[#7]: https://github.com/jonallured/tinysky/pull/7
+[#10]: https://github.com/jonallured/tinysky/pull/10
+[#11]: https://github.com/jonallured/tinysky/pull/11
+[#12]: https://github.com/jonallured/tinysky/pull/12
+[#13]: https://github.com/jonallured/tinysky/pull/13
+[#14]: https://github.com/jonallured/tinysky/pull/14
+[#15]: https://github.com/jonallured/tinysky/pull/15
+[#16]: https://github.com/jonallured/tinysky/pull/16
+[#17]: https://github.com/jonallured/tinysky/pull/17

data/README.md

@@ -35,6 +35,21 @@ After checking out the repo, run `bin/setup` to install dependencies. Then, run
 
 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 the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
+## Releasing
+
+The release process is automated but should start with a commit to update the
+CHANGELOG. This commit should add the new version and then update the Unreleased
+section back to defaults. It should also update the links. Once that's done then
+the actual process can be kicked off like so:
+
+```
+$ bin/release
+```
+
+Which will create a commit that bumps the patch version, push the commit to
+GitHub and then push the tag that triggers the release.yml workflow. That
+workflow will run tests and then push to RubyGems.org.
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/jonallured/tinysky.
@@ -43,5 +58,5 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/jonall
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
-[actions]: https://github.com/jonallured/tinysky/actions
+[actions]: https://github.com/jonallured/tinysky/actions/workflows/main.yml
 [badge]: https://github.com/jonallured/tinysky/actions/workflows/main.yml/badge.svg

data/Rakefile

@@ -2,5 +2,6 @@ require "bundler/gem_tasks"
 require "rspec/core/rake_task"
 require "standard/rake"
 
-RSpec::Core::RakeTask.new(:spec)
+RSpec::Core::RakeTask.new(:spec) { |t| t.verbose = false }
+
 task default: %i[standard spec]

data/examples/create_record_with_embed.rb

@@ -0,0 +1,37 @@
+require "bundler/setup"
+require "tinysky"
+
+BlogPost = Struct.new(:url, :title, :description, :image_url)
+
+blog_post = BlogPost.new(
+  "https://www.jonallured.com/posts/2026/02/14/upgrading-to-ruby-four-oh.html",
+  "Upgrading to Ruby 4.0",
+  "Ruby 4.0 was released a couple months ago on Christmas and I had been meaning to upgrade for a while. I noticed that version 4.0.1 came out too so that's always a good sign that things are stable and ready for prime time.",
+  "https://www.jonallured.com/images/post-95/social-share.png"
+)
+
+credentials_path = "/Users/jon/Desktop/tinysky_credentials.json"
+credentials = JSON.load_file(credentials_path, symbolize_names: true)
+client = Tinysky::Client.new(credentials)
+
+blob_data = Faraday.get(blog_post.image_url).body
+content_type = "image/png"
+upload_response = client.upload_blob(blob_data, content_type)
+thumb = upload_response.body["blob"]
+
+embed = Tinysky::ExternalEmbed.new(
+  description: blog_post.description,
+  thumb: thumb,
+  title: blog_post.title,
+  uri: blog_post.url
+)
+
+message = "New blog post: https://www.jonallured.com/posts/2026/02/14/upgrading-to-ruby-four-oh.html"
+facets = Tinysky::FacetParser.for(message)
+
+record_options = {
+  embed: embed,
+  facets: facets
+}
+
+client.create_record(message, record_options)

data/examples/create_record_with_facet.rb

@@ -0,0 +1,12 @@
+require "bundler/setup"
+require "tinysky"
+
+credentials_path = "/Users/jon/Desktop/tinysky_credentials.json"
+credentials = JSON.load_file(credentials_path, symbolize_names: true)
+client = Tinysky::Client.new(credentials)
+
+text = "Upgrading to Ruby 4.0 https://www.jonallured.com/posts/2026/02/14/upgrading-to-ruby-four-oh.html"
+facets = Tinysky::FacetParser.for(text)
+options = {facets: facets}
+
+client.create_record(text, options)

data/lib/tinysky/client.rb

@@ -16,7 +16,8 @@ module Tinysky
         password: @credentials[:app_password]
       }
 
-      response = @connection.post(CREATE_SESSION_PATH, body)
+      path = Tinysky::Endpoints::SERVER_CREATE_SESSION
+      response = @connection.post(path, body)
 
       @access_jwt = response.body["accessJwt"]
       payload, _header = JWT.decode(@access_jwt, nil, false)
@@ -25,25 +26,33 @@ module Tinysky
       response
     end
 
-    def create_record(text)
+    def create_record(text, options)
       create_session if expired_token?
 
-      record = {
-        "$type" => POST_LEXICON_TYPE,
-        "createdAt" => DateTime.now.iso8601,
-        "langs" => ["en-US"],
-        "text" => text
-      }
+      feed_post = FeedPost.new(text, options)
 
       body = {
-        collection: POST_LEXICON_TYPE,
-        record: record,
+        collection: Tinysky::Lexicon::FEED_POST,
+        record: feed_post.to_hash,
         repo: @credentials[:handle]
       }
 
       headers = {"Authorization" => "Bearer #{@access_jwt}"}
 
-      @connection.post(CREATE_RECORD_PATH, body, headers)
+      path = Tinysky::Endpoints::REPO_CREATE_RECORD
+      @connection.post(path, body, headers)
+    end
+
+    def upload_blob(blob_data, content_type)
+      create_session if expired_token?
+
+      headers = {
+        "Authorization" => "Bearer #{@access_jwt}",
+        "Content-Type" => content_type
+      }
+
+      path = Tinysky::Endpoints::REPO_UPLOAD_BLOB
+      @connection.post(path, blob_data, headers)
     end
 
     private

data/lib/tinysky/endpoints.rb

@@ -0,0 +1,7 @@
+module Tinysky
+  module Endpoints
+    REPO_CREATE_RECORD = "/xrpc/com.atproto.repo.createRecord"
+    REPO_UPLOAD_BLOB = "/xrpc/com.atproto.repo.uploadBlob"
+    SERVER_CREATE_SESSION = "/xrpc/com.atproto.server.createSession"
+  end
+end

data/lib/tinysky/external_embed.rb

@@ -0,0 +1,22 @@
+module Tinysky
+  class ExternalEmbed
+    def initialize(attrs)
+      @description = attrs[:description]
+      @thumb = attrs[:thumb]
+      @title = attrs[:title]
+      @uri = attrs[:uri]
+    end
+
+    def to_hash
+      {
+        "$type" => Tinysky::Lexicon::EXTERNAL_EMBED,
+        "external" => {
+          "description" => @description,
+          "thumb" => @thumb,
+          "title" => @title,
+          "uri" => @uri
+        }
+      }
+    end
+  end
+end

data/lib/tinysky/facet_parser.rb

@@ -0,0 +1,25 @@
+module Tinysky
+  class FacetParser
+    URL_PATTERN = /https?:\/\/\S+/
+
+    def self.for(text)
+      parser = new(text)
+      parser.find_facets
+    end
+
+    def initialize(text)
+      @text = text || ""
+    end
+
+    def find_facets
+      scan_enumerator = @text.enum_for(:scan, URL_PATTERN)
+
+      scan_enumerator.map do |url|
+        char_start = Regexp.last_match.begin(0)
+        byte_start = @text[0, char_start].bytesize
+        byte_end = byte_start + url.bytesize
+        LinkFacet.new(byte_start, byte_end, url)
+      end
+    end
+  end
+end

data/lib/tinysky/feed_post.rb

@@ -0,0 +1,39 @@
+module Tinysky
+  class FeedPost
+    def initialize(text, options)
+      @text = text
+      @options = options
+    end
+
+    def to_hash
+      hsh = {
+        "$type" => Tinysky::Lexicon::FEED_POST,
+        "createdAt" => created_at,
+        "langs" => ["en-US"],
+        "text" => @text
+      }
+
+      hsh["embed"] = embed.to_hash unless embed.nil?
+      hsh["facets"] = facets.map(&:to_hash) if facets.any?
+
+      hsh
+    end
+
+    private
+
+    def created_at
+      as_of = @options[:as_of] || DateTime.now
+      as_of.iso8601
+    end
+
+    def embed
+      @options[:embed]
+    end
+
+    def facets
+      return [] if @options[:facets].nil?
+
+      @options[:facets]
+    end
+  end
+end

data/lib/tinysky/lexicon.rb

@@ -0,0 +1,7 @@
+module Tinysky
+  module Lexicon
+    EXTERNAL_EMBED = "app.bsky.embed.external"
+    FEED_POST = "app.bsky.feed.post"
+    LINK_FACET = "app.bsky.richtext.facet#link"
+  end
+end

data/lib/tinysky/link_facet.rb

@@ -0,0 +1,24 @@
+module Tinysky
+  class LinkFacet
+    def initialize(byte_start, byte_end, uri)
+      @byte_start = byte_start
+      @byte_end = byte_end
+      @uri = uri
+    end
+
+    def to_hash
+      {
+        "features" => [
+          {
+            "$type" => Tinysky::Lexicon::LINK_FACET,
+            "uri" => @uri
+          }
+        ],
+        "index" => {
+          "byteEnd" => @byte_end,
+          "byteStart" => @byte_start
+        }
+      }
+    end
+  end
+end

data/lib/tinysky/version.rb

@@ -1,3 +1,3 @@
 module Tinysky
-  VERSION = "0.0.3"
+  VERSION = "0.0.4"
 end

data/lib/tinysky.rb

@@ -1,17 +1,13 @@
 require "faraday"
 require "jwt"
+require "zeitwerk"
 
-require_relative "tinysky/version"
-require_relative "tinysky/client"
+loader = Zeitwerk::Loader.for_gem
+loader.setup
 
 module Tinysky
   ROOT_URL = "https://bsky.social"
 
-  CREATE_RECORD_PATH = "/xrpc/com.atproto.repo.createRecord"
-  CREATE_SESSION_PATH = "/xrpc/com.atproto.server.createSession"
-
-  POST_LEXICON_TYPE = "app.bsky.feed.post"
-
   def self.generate_connection
     Faraday.new(url: ROOT_URL) do |f|
       f.request :json

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: tinysky
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors:
 - Jon Allured
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-09-15 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -38,6 +37,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A tiny client gem for the Bluesky API that focuses on creating posts.
 email:
 - jon@jonallured.com
@@ -47,21 +60,28 @@ extra_rdoc_files: []
 files:
 - ".rspec"
 - ".standard.yml"
+- ".tool-versions"
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
 - Rakefile
+- examples/create_record_with_embed.rb
+- examples/create_record_with_facet.rb
 - lib/tinysky.rb
 - lib/tinysky/client.rb
+- lib/tinysky/endpoints.rb
+- lib/tinysky/external_embed.rb
+- lib/tinysky/facet_parser.rb
+- lib/tinysky/feed_post.rb
+- lib/tinysky/lexicon.rb
+- lib/tinysky/link_facet.rb
 - lib/tinysky/version.rb
 - sig/tinysky.rbs
-- tinysky.gemspec
 homepage: https://github.com/jonallured/tinysky
 licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/jonallured/tinysky
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -69,15 +89,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.6.0
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Tiny client for the Bluesky API.
 test_files: []

data/tinysky.gemspec

@@ -1,30 +0,0 @@
-require_relative "lib/tinysky/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "tinysky"
-  spec.version = Tinysky::VERSION
-  spec.authors = ["Jon Allured"]
-  spec.email = ["jon@jonallured.com"]
-
-  spec.summary = "Tiny client for the Bluesky API."
-  spec.description = "A tiny client gem for the Bluesky API that focuses on creating posts."
-  spec.homepage = "https://github.com/jonallured/tinysky"
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 2.6.0"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-
-  spec.files = Dir.chdir(__dir__) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (File.expand_path(f) == __FILE__) ||
-        f.start_with?(*%w[bin/ test/ spec/ features/ .git .circleci appveyor Gemfile])
-    end
-  end
-
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  spec.add_dependency "faraday", "~> 2"
-  spec.add_dependency "jwt", "~> 2"
-end