skyfall 0.5.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d272120c19a97451a6df364e1a7dbbb8191dc0247fd929129ecab0cf05902599
-  data.tar.gz: 242ebbbbf44aee36a883c2fc78be327d29c14fa27168fc1eac66ef38ad16cc16
+  metadata.gz: 8fb36995d08abb6e93e1ce9f29ca74a88cea54bf21b3a1ae0d66a1cb9feb9240
+  data.tar.gz: b9c21937b269d0cae220563bd912ce13d0d381bec920a139d40c33b6ace06253
 SHA512:
-  metadata.gz: cebb5837133466638a7009d52be516af961644c55f91fe3f3e9a6fe120bc8875f614bbf849cea02fe23b81f3f1f4652226214d375adff12198faf3dd81c1bedd
-  data.tar.gz: f1c8c48d58c344a67f4df27afc792b6d38272ecb0aefdf7cf4336269290e36c788d356547c2af0520a9d11664e62fb872157da88951cb669f7081bb0414cc029
+  metadata.gz: f71bc939578c8fd50278562c28c19e00e558297e93440f1627b567df8f0c5fa3dc88b22efa2cd5a284fc58c241d1f66a21f9c482b7dda3fc799263ebfd777ee0
+  data.tar.gz: 579db31d36c8fcee844f3d26193eea2fcdc9721e037ac5c6d1e1ee20362059f9051afd1fb56fab4ba15e566add9571751e85d8b0663fda190f80756959882468

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [0.5.1] - 2025-05-18
+
+- added support for the new `#sync` message type
+- added `#unknown?` helper in `Skyfall::Firehose::Message` and `Skyfall::Jetstream::Message`, which returns true if the message type is `UnknownMessage`
+- added `:bsky_verification` and `:bsky_actor_status` lexicon type and shortcode
+- added one missing require
+
 ## [0.5.0] - 2024-11-15
 
 Jetstream support! You can now connect to [Jetstream](https://github.com/bluesky-social/jetstream) sources using `Skyfall::Jetstream` (see readme).

data/README.md

@@ -80,7 +80,7 @@ Alternatively, you can connect to a [Jetstream](https://github.com/bluesky-socia
 Jetstream connections are made using a `Skyfall::Jetstream` instance, which has more or less the same API as `Skyfall::Firehose`, so it should be possible to switch between those by just changing the line that creates the client instance:
 
 ```rb
-sky = Skyfall::Jetstream.new('jetstream1.us-east.bsky.network')
+sky = Skyfall::Jetstream.new('jetstream2.us-east.bsky.network')
 
 sky.on_message { |msg| ... }
 sky.on_error { |e| ... }
@@ -113,7 +113,7 @@ Jetstream has a similar mechanism, except the cursor is the event's timestamp in
 ```rb
 cursor = load_cursor
 
-sky = Skyfall::Jetstream.new('jetstream1.us-east.bsky.network', { cursor: cursor })
+sky = Skyfall::Jetstream.new('jetstream2.us-east.bsky.network', { cursor: cursor })
 sky.on_message do |msg|
   save_cursor(msg.seq)
   process_message(msg)
@@ -283,7 +283,7 @@ Jetstream allows you to specify [filters](https://github.com/bluesky-social/jets
 To use these filters, pass the "wantedCollections" and/or "wantedDids" parameters in the options hash when initializing `Skyfall::Jetstream`. You can use the original JavaScript param names, or a more Ruby-like snake_case form:
 
 ```rb
-sky = Skyfall::Jetstream.new('jetstream1.us-east.bsky.network', {
+sky = Skyfall::Jetstream.new('jetstream2.us-east.bsky.network', {
   wanted_collections: 'app.bsky.feed.post',
   wanted_dids: @dids
 })
@@ -292,7 +292,7 @@ sky = Skyfall::Jetstream.new('jetstream1.us-east.bsky.network', {
 For collections, you can also use the symbol codes used in `Operation#type`, e.g. `:bsky_post`:
 
 ```rb
-sky = Skyfall::Jetstream.new('jetstream1.us-east.bsky.network', {
+sky = Skyfall::Jetstream.new('jetstream2.us-east.bsky.network', {
   wanted_collections: [:bsky_post]
 })
 ```

data/example/jet_monitor_phrases.rb

@@ -18,7 +18,7 @@ if terms.empty?
 end
 
 # tell Jetstream to send us only post records
-sky = Skyfall::Jetstream.new('jetstream1.us-east.bsky.network', { wanted_collections: [:bsky_post] })
+sky = Skyfall::Jetstream.new('jetstream2.us-east.bsky.network', { wanted_collections: [:bsky_post] })
 
 sky.on_message do |msg|
   # we're only interested in repo commit messages

data/lib/skyfall/collection.rb

@@ -1,37 +1,41 @@
 module Skyfall
   module Collection
-    BSKY_PROFILE     = "app.bsky.actor.profile"
-    BSKY_FEED        = "app.bsky.feed.generator"
-    BSKY_LIKE        = "app.bsky.feed.like"
-    BSKY_POST        = "app.bsky.feed.post"
-    BSKY_POSTGATE    = "app.bsky.feed.postgate"
-    BSKY_REPOST      = "app.bsky.feed.repost"
-    BSKY_THREADGATE  = "app.bsky.feed.threadgate"
-    BSKY_BLOCK       = "app.bsky.graph.block"
-    BSKY_FOLLOW      = "app.bsky.graph.follow"
-    BSKY_LIST        = "app.bsky.graph.list"
-    BSKY_LISTBLOCK   = "app.bsky.graph.listblock"
-    BSKY_LISTITEM    = "app.bsky.graph.listitem"
-    BSKY_STARTERPACK = "app.bsky.graph.starterpack"
-    BSKY_LABELER     = "app.bsky.labeler.service"
+    BSKY_PROFILE      = "app.bsky.actor.profile"
+    BSKY_ACTOR_STATUS = "app.bsky.actor.status"
+    BSKY_FEED         = "app.bsky.feed.generator"
+    BSKY_LIKE         = "app.bsky.feed.like"
+    BSKY_POST         = "app.bsky.feed.post"
+    BSKY_POSTGATE     = "app.bsky.feed.postgate"
+    BSKY_REPOST       = "app.bsky.feed.repost"
+    BSKY_THREADGATE   = "app.bsky.feed.threadgate"
+    BSKY_BLOCK        = "app.bsky.graph.block"
+    BSKY_FOLLOW       = "app.bsky.graph.follow"
+    BSKY_LIST         = "app.bsky.graph.list"
+    BSKY_LISTBLOCK    = "app.bsky.graph.listblock"
+    BSKY_LISTITEM     = "app.bsky.graph.listitem"
+    BSKY_STARTERPACK  = "app.bsky.graph.starterpack"
+    BSKY_VERIFICATION = "app.bsky.graph.verification"
+    BSKY_LABELER      = "app.bsky.labeler.service"
 
     BSKY_CHAT_DECLARATION = "chat.bsky.actor.declaration"
 
     SHORT_CODES = {
-      BSKY_BLOCK       => :bsky_block,
-      BSKY_FEED        => :bsky_feed,
-      BSKY_FOLLOW      => :bsky_follow,
-      BSKY_LABELER     => :bsky_labeler,
-      BSKY_LIKE        => :bsky_like,
-      BSKY_LIST        => :bsky_list,
-      BSKY_LISTBLOCK   => :bsky_listblock,
-      BSKY_LISTITEM    => :bsky_listitem,
-      BSKY_POST        => :bsky_post,
-      BSKY_POSTGATE    => :bsky_postgate,
-      BSKY_PROFILE     => :bsky_profile,
-      BSKY_REPOST      => :bsky_repost,
-      BSKY_STARTERPACK => :bsky_starterpack,
-      BSKY_THREADGATE  => :bsky_threadgate,
+      BSKY_ACTOR_STATUS => :bsky_actor_status,
+      BSKY_BLOCK        => :bsky_block,
+      BSKY_FEED         => :bsky_feed,
+      BSKY_FOLLOW       => :bsky_follow,
+      BSKY_LABELER      => :bsky_labeler,
+      BSKY_LIKE         => :bsky_like,
+      BSKY_LIST         => :bsky_list,
+      BSKY_LISTBLOCK    => :bsky_listblock,
+      BSKY_LISTITEM     => :bsky_listitem,
+      BSKY_POST         => :bsky_post,
+      BSKY_POSTGATE     => :bsky_postgate,
+      BSKY_PROFILE      => :bsky_profile,
+      BSKY_REPOST       => :bsky_repost,
+      BSKY_STARTERPACK  => :bsky_starterpack,
+      BSKY_THREADGATE   => :bsky_threadgate,
+      BSKY_VERIFICATION => :bsky_verification,
       BSKY_CHAT_DECLARATION => :bsky_chat_declaration,
     }
 

data/lib/skyfall/faye_ext.rb

@@ -0,0 +1,48 @@
+require 'websocket/driver'
+require_relative 'firehose'
+
+module WebSocket
+  class Driver
+    class Hybi
+      def emit_message
+        message  = @extensions.process_incoming_message(@message)
+        @message = nil
+
+        payload = message.data
+
+        case message.opcode
+          when OPCODES[:text] then
+            payload = Driver.encode(payload, Encoding::UTF_8)
+            payload = nil unless payload.valid_encoding?
+          # when OPCODES[:binary]
+          #   payload = payload.bytes.to_a
+        end
+
+        if payload
+          emit(:message, MessageEvent.new(payload))
+        else
+          fail(:encoding_error, 'Could not decode a text frame as UTF-8')
+        end
+      rescue ::WebSocket::Extensions::ExtensionError => error
+        fail(:extension_error, error.message)
+      end
+    end
+  end
+end
+
+module Skyfall
+  class Firehose
+    def handle_message(msg)
+      data = msg.data #.pack('C*')
+      @handlers[:raw_message]&.call(data)
+
+      if @handlers[:message]
+        atp_message = Message.new(data)
+        @cursor = atp_message.seq
+        @handlers[:message].call(atp_message)
+      else
+        @cursor = nil
+      end
+    end
+  end
+end

data/lib/skyfall/firehose/message.rb

@@ -15,6 +15,7 @@ module Skyfall
     require_relative 'identity_message'
     require_relative 'info_message'
     require_relative 'labels_message'
+    require_relative 'sync_message'
     require_relative 'tombstone_message'
     require_relative 'unknown_message'
 
@@ -34,6 +35,7 @@ module Skyfall
         when '#identity'  then Firehose::IdentityMessage
         when '#info'      then Firehose::InfoMessage
         when '#labels'    then Firehose::LabelsMessage
+        when '#sync'      then Firehose::SyncMessage
         when '#tombstone' then Firehose::TombstoneMessage
         else Firehose::UnknownMessage
       end
@@ -56,6 +58,10 @@ module Skyfall
       []
     end
 
+    def unknown?
+      self.is_a?(Firehose::UnknownMessage)
+    end
+
     def time
       @time ||= @data_object['time'] && Time.parse(@data_object['time'])
     end

data/lib/skyfall/firehose/sync_message.rb

@@ -0,0 +1,9 @@
+require_relative '../firehose'
+
+module Skyfall
+  class Firehose::SyncMessage < Firehose::Message
+    def rev
+      @rev ||= @data_object['rev']
+    end
+  end
+end

data/lib/skyfall/jetstream/message.rb

@@ -39,6 +39,10 @@ module Skyfall
       @time_us = @json['time_us']
     end
 
+    def unknown?
+      self.is_a?(Jetstream::UnknownMessage)
+    end
+
     def operations
       []
     end

data/lib/skyfall/stream.rb

@@ -2,6 +2,8 @@ require 'eventmachine'
 require 'faye/websocket'
 require 'uri'
 
+require_relative 'version'
+
 module Skyfall
   class Stream
     EVENTS = %w(message raw_message connecting connect disconnect reconnect error timeout)
@@ -53,7 +55,7 @@ module Skyfall
           @handlers[:error]&.call(e)
         end
 
-        @ws = Faye::WebSocket::Client.new(url, nil, { headers: { 'User-Agent' => user_agent }})
+        @ws = build_websocket_client(url)
 
         @ws.on(:open) do |e|
           @handlers[:connect]&.call
@@ -183,6 +185,10 @@ module Skyfall
       end
     end
 
+    def build_websocket_client(url)
+      Faye::WebSocket::Client.new(url, nil, { headers: { 'User-Agent' => user_agent }})
+    end
+
     def build_websocket_url
       @root_url
     end

data/lib/skyfall/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Skyfall
-  VERSION = "0.5.0"
+  VERSION = "0.5.1"
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: skyfall
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.1
 platform: ruby
 authors:
 - Kuba Suder
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-15 00:00:00.000000000 Z
+date: 2025-05-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base32
@@ -123,6 +122,7 @@ files:
 - lib/skyfall/collection.rb
 - lib/skyfall/errors.rb
 - lib/skyfall/extensions.rb
+- lib/skyfall/faye_ext.rb
 - lib/skyfall/firehose.rb
 - lib/skyfall/firehose/account_message.rb
 - lib/skyfall/firehose/commit_message.rb
@@ -132,6 +132,7 @@ files:
 - lib/skyfall/firehose/labels_message.rb
 - lib/skyfall/firehose/message.rb
 - lib/skyfall/firehose/operation.rb
+- lib/skyfall/firehose/sync_message.rb
 - lib/skyfall/firehose/tombstone_message.rb
 - lib/skyfall/firehose/unknown_message.rb
 - lib/skyfall/jetstream.rb
@@ -152,7 +153,6 @@ metadata:
   bug_tracker_uri: https://github.com/mackuba/skyfall/issues
   changelog_uri: https://github.com/mackuba/skyfall/blob/master/CHANGELOG.md
   source_code_uri: https://github.com/mackuba/skyfall
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -167,8 +167,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: A Ruby gem for streaming data from the Bluesky/AtProto firehose
 test_files: []