skypost 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 72251c65823ba0eb09ed0383726432a97ee1cb1359fef32441158e4c7c090c89
+  data.tar.gz: bd91c3aa9a407183191f6e6203a3279c7b76c4d4518fbd9355c6f08e3361d9d4
+SHA512:
+  metadata.gz: aebd23ca3736be8ce1b4e80b084e28f5b3032557d747e0fd07186dd508775708f78339f0eff58789936559d3f0d78d96028e94509aa4c983e07bf5a1d498ea8e
+  data.tar.gz: fc2d2eb5d9bdf1a69b54c864f95aefd00b64f3d08cb56c8980e7848ad51447300624f3bb0fd8d3191559aabd39aaac6b845acdd6dfada4ddbff2e967e1381296

data/README.md

@@ -0,0 +1,61 @@
+# Skypost
+
+A Ruby gem for posting messages to Bluesky social network.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'skypost'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install skypost
+
+## Usage
+
+```ruby
+require 'skypost'
+
+# Initialize the client with your Bluesky credentials
+# You can use either your custom domain or .bsky.social handle
+client = Skypost::Client.new("username.com", "your-app-password")
+# OR
+client = Skypost::Client.new("username.bsky.social", "your-app-password")
+
+# Post a message
+client.post("Hello from Skypost!")
+
+# Post a message with a clickable link
+client.post('Check out this cool website: <a href="https://example.com">Example</a>!')
+```
+
+### App Password
+To get your app password, go to your Bluesky account settings at [bsky.app/settings/app-passwords](https://bsky.app/settings/app-passwords) and create a new app password. Never use your main account password for API access.
+
+### Handle Format
+You can use either:
+1. Your custom domain (if you have one), e.g., `username.com`
+2. Your Bluesky handle in the format `username.bsky.social`
+
+To find your handle, look at your profile URL in Bluesky. For example:
+- If your profile is at `https://bsky.app/profile/username.com`, use `username.com`
+- If your profile is at `https://bsky.app/profile/username.bsky.social`, use `username.bsky.social`
+
+## Development
+
+After checking out the repo, run `bundle install` to install dependencies.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub.
+
+## License
+
+The gem is available as open source under the terms of the MIT License.

data/lib/skypost/client.rb

@@ -0,0 +1,116 @@
+require 'faraday'
+require 'json'
+
+module Skypost
+  class Client
+    BASE_URL = "https://bsky.social"
+    
+    class AuthenticationError < StandardError; end
+    class ValidationError < StandardError; end
+
+    def initialize(identifier = nil, password = nil)
+      @identifier = identifier
+      @password = password
+      @session = nil
+      validate_identifier if identifier
+    end
+
+    def authenticate
+      raise AuthenticationError, "Identifier and password are required" if @identifier.nil? || @password.nil?
+
+      response = connection.post("/xrpc/com.atproto.server.createSession") do |req|
+        req.headers["Content-Type"] = "application/json"
+        req.body = JSON.generate({
+          identifier: @identifier,
+          password: @password
+        })
+      end
+
+      @session = JSON.parse(response.body)
+      @session
+    rescue Faraday::ResourceNotFound => e
+      raise AuthenticationError, "Authentication failed: Invalid credentials or incorrect handle format. Your handle should be either your custom domain (e.g., 'username.com') or your Bluesky handle (e.g., 'username.bsky.social')"
+    rescue Faraday::Error => e
+      raise AuthenticationError, "Failed to authenticate: #{e.message}"
+    end
+
+    def post(text)
+      ensure_authenticated
+
+      current_time = Time.now.utc.strftime("%Y-%m-%dT%H:%M:%S.%3NZ")
+      facets = extract_links(text)
+      
+      request_body = {
+        repo: @session["did"],
+        collection: "app.bsky.feed.post",
+        record: {
+          text: text.gsub(/<a href="[^"]*">|<\/a>/, ''),  # Remove HTML tags but keep link text
+          facets: facets,
+          createdAt: current_time,
+          "$type": "app.bsky.feed.post"
+        }
+      }
+
+      response = connection.post("/xrpc/com.atproto.repo.createRecord") do |req|
+        req.headers["Content-Type"] = "application/json"
+        req.headers["Authorization"] = "Bearer #{@session["accessJwt"]}"
+        req.body = JSON.generate(request_body)
+      end
+
+      JSON.parse(response.body)
+    rescue Faraday::ResourceNotFound => e
+      raise "Failed to post: The API endpoint returned 404. Please check if you're authenticated and using the correct API endpoint."
+    rescue Faraday::Error => e
+      raise "Failed to post: #{e.message}"
+    end
+
+    private
+
+    def validate_identifier
+      unless @identifier.include?(".")
+        raise ValidationError, "Invalid handle format. Handle must be either a custom domain (e.g., 'username.com') or a Bluesky handle (e.g., 'username.bsky.social')"
+      end
+    end
+
+    def ensure_authenticated
+      authenticate if @session.nil?
+    end
+
+    def connection
+      @connection ||= Faraday.new(url: BASE_URL) do |f|
+        f.request :json
+        f.response :raise_error
+      end
+    end
+
+    def extract_links(text)
+      facets = []
+      link_pattern = /<a href="([^"]*)">(.*?)<\/a>/
+      
+      # First, find all matches to calculate correct byte positions
+      matches = text.to_enum(:scan, link_pattern).map { Regexp.last_match }
+      plain_text = text.gsub(/<a href="[^"]*">|<\/a>/, '')  # Text with HTML removed
+      
+      matches.each do |match|
+        url = match[1]
+        link_text = match[2]
+        
+        # Find the link text in the plain text to get correct byte positions
+        if link_position = plain_text.index(link_text)
+          facets << {
+            index: {
+              byteStart: link_position,
+              byteEnd: link_position + link_text.bytesize
+            },
+            features: [{
+              "$type": "app.bsky.richtext.facet#link",
+              uri: url
+            }]
+          }
+        end
+      end
+
+      facets
+    end
+  end
+end

data/lib/skypost/version.rb

@@ -0,0 +1,3 @@
+module Skypost
+  VERSION = "0.0.1"
+end

data/lib/skypost.rb

@@ -0,0 +1,8 @@
+require "faraday"
+require "json"
+require_relative "skypost/client"
+require_relative "skypost/version"
+
+module Skypost
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification
+name: skypost
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Jeroen Roosenboom
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-11-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: A simple Ruby gem that allows posting messages to the Bluesky social
+  network
+email:
+- hi@jro7.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/skypost.rb
+- lib/skypost/client.rb
+- lib/skypost/version.rb
+homepage: https://github.com/jro7/skypost
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.23
+signing_key:
+specification_version: 4
+summary: A Ruby gem for posting to Bluesky
+test_files: []