skyfall 0.5.1 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8fb36995d08abb6e93e1ce9f29ca74a88cea54bf21b3a1ae0d66a1cb9feb9240
-  data.tar.gz: b9c21937b269d0cae220563bd912ce13d0d381bec920a139d40c33b6ace06253
+  metadata.gz: 5d216f6eca172d8982c358d594511fa31212dd9dfdb949ed1149d16b23862bfa
+  data.tar.gz: c381c2abebdb22265568b0183b7d78525a6cbbbd01192b32faad4ed1dadbec02
 SHA512:
-  metadata.gz: f71bc939578c8fd50278562c28c19e00e558297e93440f1627b567df8f0c5fa3dc88b22efa2cd5a284fc58c241d1f66a21f9c482b7dda3fc799263ebfd777ee0
-  data.tar.gz: 579db31d36c8fcee844f3d26193eea2fcdc9721e037ac5c6d1e1ee20362059f9051afd1fb56fab4ba15e566add9571751e85d8b0663fda190f80756959882468
+  metadata.gz: 1d4c45ef3103036b5e13c5614615f20b61d9beaa7092af2058b8135cd4b460ede00c23b1d05cc5b57751a64a50e6286946d438ccd80c899023c9d92be6ac710e
+  data.tar.gz: d7bd5bb732b86db3c56b9389a25a5e6d80f57629ec27621c32330ad0155c379864388eb347381e8f5e38387c4b22ce019fd4879c0e33eb46852e1565c2aef844

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [0.6.1] - 2026-01-08
+
+- added `:bsky_notif_declaration` shortcode for `app.bsky.notification.declaration` collection
+- throw error when trying to run two streams in one process (see b4a1514f5da28983205765e55724b5c4abe6c5e4 for details)
+- added protected `#send_data` and `#socket` methods in `Stream` for use in `Stream` subclasses (currently for the Tapfall gem)
+- added a way to customize headers sent when connecting in `Stream` subclasses through the `#request_headers` method
+
+## [0.6.0] - 2025-06-25
+
+- significantly speeded up reading of events from the binary firehose (`Skyfall::Firehose`) - up to 4-5x faster than before
+- removed the `Skyfall::Stream.new` constructor deprecated in 0.5.0
+
 ## [0.5.1] - 2025-05-18
 
 - added support for the new `#sync` message type

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The zlib License
 
-Copyright (c) 2023-2024 Jakub Suder
+Copyright (c) 2026 Jakub Suder
 
 This software is provided 'as-is', without any express or implied
 warranty.  In no event will the authors be held liable for any damages

data/README.md

@@ -3,7 +3,7 @@
 A Ruby gem for streaming data from the Bluesky/ATProto firehose 🦋
 
 > [!NOTE]
-> ATProto Ruby gems collection: [skyfall](https://github.com/mackuba/skyfall) | [blue_factory](https://github.com/mackuba/blue_factory) | [minisky](https://github.com/mackuba/minisky) | [didkit](https://github.com/mackuba/didkit)
+> Part of ATProto Ruby SDK: [ruby.sdk.blue](https://ruby.sdk.blue)
 
 
 ## What does it do
@@ -15,13 +15,15 @@ Since version 0.5, Skyfall also supports connecting to [Jetstream](https://githu
 
 ## Installation
 
-From the command line:
+To use Skyfall, you need a reasonably new version of Ruby – it should run on Ruby 2.6 and above, although it's recommended to use a version that's still getting maintainance updates, i.e. currently 3.2+. A compatible version should be preinstalled on macOS Big Sur and above and on many Linux systems. Otherwise, you can install one using tools such as [RVM](https://rvm.io), [asdf](https://asdf-vm.com), [ruby-install](https://github.com/postmodern/ruby-install) or [ruby-build](https://github.com/rbenv/ruby-build), or `rpm` or `apt-get` on Linux (see more installation options on [ruby-lang.org](https://www.ruby-lang.org/en/downloads/)).
 
-    gem install skyfall
+To install the gem, run the command:
 
-Or, add this to your `Gemfile`:
+    [sudo] gem install skyfall
 
-    gem 'skyfall', '~> 0.5'
+Or add this to your app's `Gemfile`:
+
+    gem 'skyfall', '~> 0.6'
 
 
 ## Usage
@@ -198,7 +200,7 @@ sky.on_message do |m|
 end
 ```
 
-For more examples, see the [example](https://github.com/mackuba/skyfall/blob/master/example) folder or the [bluesky-feeds-rb](https://github.com/mackuba/bluesky-feeds-rb/blob/master/app/firehose_stream.rb) project, which implements a feed generator service.
+For more examples, see the [examples page](https://ruby.sdk.blue/examples/) on [ruby.sdk.blue](https://ruby.sdk.blue), or the [bluesky-feeds-rb](https://tangled.org/mackuba.eu/bluesky-feeds-rb/blob/master/app/firehose_stream.rb) project, which implements a feed generator service.
 
 
 ### Note on custom lexicons
@@ -305,7 +307,7 @@ See [Jetstream docs](https://github.com/bluesky-social/jetstream?tab=readme-ov-f
 
 ## Credits
 
-Copyright © 2024 Kuba Suder ([@mackuba.eu](https://bsky.app/profile/mackuba.eu)).
+Copyright © 2026 Kuba Suder ([@mackuba.eu](https://bsky.app/profile/did:plc:oio4hkxaop4ao4wz2pp3f4cr)).
 
 The code is available under the terms of the [zlib license](https://choosealicense.com/licenses/zlib/) (permissive, similar to MIT).
 

data/lib/skyfall/collection.rb

@@ -17,7 +17,8 @@ module Skyfall
     BSKY_VERIFICATION = "app.bsky.graph.verification"
     BSKY_LABELER      = "app.bsky.labeler.service"
 
-    BSKY_CHAT_DECLARATION = "chat.bsky.actor.declaration"
+    BSKY_NOTIF_DECLARATION = "app.bsky.notification.declaration"
+    BSKY_CHAT_DECLARATION  = "chat.bsky.actor.declaration"
 
     SHORT_CODES = {
       BSKY_ACTOR_STATUS => :bsky_actor_status,
@@ -37,6 +38,7 @@ module Skyfall
       BSKY_THREADGATE   => :bsky_threadgate,
       BSKY_VERIFICATION => :bsky_verification,
       BSKY_CHAT_DECLARATION => :bsky_chat_declaration,
+      BSKY_NOTIF_DECLARATION => :bsky_notif_declaration
     }
 
     def self.short_code(collection)

data/lib/skyfall/errors.rb

@@ -5,6 +5,15 @@ module Skyfall
   class UnsupportedError < StandardError
   end
 
+  class ReactorActiveError < StandardError
+    def initialize
+      super(
+        "An EventMachine reactor thread is already running, but it seems to have been launched by another Stream. " +
+        "Skyfall doesn't currently support running two different Stream instances in a single process."
+      )
+    end
+  end
+
   class SubscriptionError < StandardError
     attr_reader :error_type, :error_message
 

data/lib/skyfall/firehose.rb

@@ -13,28 +13,17 @@ module Skyfall
 
     attr_accessor :cursor
 
-    def self.new(server, endpoint, cursor = nil)
-      # to be removed in 0.6
-      instance = self.allocate
-      instance.send(:initialize, server, endpoint, cursor)
-      instance
-    end
-
     def initialize(server, endpoint, cursor = nil)
       require_relative 'firehose/message'
       super(server)
 
       @endpoint = check_endpoint(endpoint)
       @cursor = check_cursor(cursor)
-      @root_url = @root_url.chomp('/')
-
-      if URI(@root_url).path != ''
-        raise ArgumentError, "Server parameter should not include any path"
-      end
+      @root_url = ensure_empty_path(@root_url)
     end
 
     def handle_message(msg)
-      data = msg.data.pack('C*')
+      data = msg.data
       @handlers[:raw_message]&.call(data)
 
       if @handlers[:message]

data/lib/skyfall/jetstream.rb

@@ -6,27 +6,15 @@ require 'uri'
 
 module Skyfall
   class Jetstream < Stream
-    def self.new(server, params = {})
-      # to be removed in 0.6
-      instance = self.allocate
-      instance.send(:initialize, server, params)
-      instance
-    end
-
     attr_accessor :cursor
 
     def initialize(server, params = {})
       require_relative 'jetstream/message'
       super(server)
 
-      @root_url = @root_url.chomp('/')
-
-      if URI(@root_url).path != ''
-        raise ArgumentError, "Server parameter should not include any path"
-      end
-
       @params = check_params(params)
       @cursor = @params.delete(:cursor)
+      @root_url = ensure_empty_path(@root_url)
     end
 
     def handle_message(msg)

data/lib/skyfall/stream.rb

@@ -12,20 +12,8 @@ module Skyfall
     attr_accessor :auto_reconnect, :last_update, :user_agent
     attr_accessor :heartbeat_timeout, :heartbeat_interval, :check_heartbeat
 
-    def self.new(server, endpoint = nil, cursor = nil)
-      # to be removed in 0.6
-      if endpoint || cursor
-        STDERR.puts "Warning: Skyfall::Stream has been renamed to Skyfall::Firehose. This initializer will be removed in the next version."
-        Firehose.new(server, endpoint, cursor)
-      else
-        instance = self.allocate
-        instance.send(:initialize, server)
-        instance
-      end
-    end
-
-    def initialize(service)
-      @root_url = build_root_url(service)
+    def initialize(server)
+      @root_url = build_root_url(server)
 
       @handlers = {}
       @auto_reconnect = true
@@ -45,11 +33,14 @@ module Skyfall
       url = build_websocket_url
 
       @handlers[:connecting]&.call(url)
-      @engines_on = true
 
       @reconnect_timer&.cancel
       @reconnect_timer = nil
 
+      raise ReactorActiveError if existing_reactor?
+
+      @engines_on = true
+
       EM.run do
         EventMachine.error_handler do |e|
           @handlers[:error]&.call(e)
@@ -175,8 +166,27 @@ module Skyfall
     end
 
 
+    protected
+
+    def request_headers
+      {}
+    end
+
+    def socket
+      @ws
+    end
+
+    def send_data(data)
+      @ws.send(data)
+    end
+
+
     private
 
+    def existing_reactor?
+      EM.reactor_running? && !@engines_on
+    end
+
     def reconnect_delay
       if @connection_attempts == 0
         0
@@ -186,29 +196,41 @@ module Skyfall
     end
 
     def build_websocket_client(url)
-      Faye::WebSocket::Client.new(url, nil, { headers: { 'User-Agent' => user_agent }})
+      Faye::WebSocket::Client.new(url, nil, { headers: { 'User-Agent' => user_agent }.merge(request_headers) })
     end
 
     def build_websocket_url
       @root_url
     end
 
-    def build_root_url(service)
-      if service.is_a?(String)
-        if service.include?('/')
-          uri = URI(service)
-          if uri.scheme != 'ws' && uri.scheme != 'wss'
-            raise ArgumentError, "Service parameter should be a hostname or a ws:// or wss:// URL"
-          end
-          uri.to_s
-        else
-          service = "wss://#{service}"
-          uri = URI(service) # raises if invalid
-          service
+    def build_root_url(server)
+      if !server.is_a?(String)
+        raise ArgumentError, "Server parameter should be a string"
+      end
+
+      if server.include?('://')
+        uri = URI(server)
+
+        if uri.scheme != 'ws' && uri.scheme != 'wss'
+          raise ArgumentError, "Server parameter should be a hostname or a ws:// or wss:// URL"
         end
+
+        uri.to_s
       else
-        raise ArgumentError, "Service parameter should be a string"
+        server = "wss://#{server}"
+        uri = URI(server) # raises if invalid
+        server
       end
     end
+
+    def ensure_empty_path(url)
+      url = url.chomp('/')
+
+      if URI(url).path != ''
+        raise ArgumentError, "Server URL should only include a hostname, without any path"
+      end
+
+      url
+    end
   end
 end

data/lib/skyfall/version.rb

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

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: skyfall
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.6.1
 platform: ruby
 authors:
 - Kuba Suder
 bindir: bin
 cert_chain: []
-date: 2025-05-19 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base32
@@ -89,14 +89,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '0.12'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '0.12'
 description: "\n    Skyfall is a Ruby library for connecting to the \"firehose\" of
   the Bluesky social network, i.e. a websocket which\n    streams all new posts and
   everything else happening on the Bluesky network in real time. The code connects
@@ -112,17 +112,12 @@ files:
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
-- example/block_tracker.rb
-- example/jet_monitor_phrases.rb
-- example/print_all_posts.rb
-- example/push_notifications.rb
 - lib/skyfall.rb
 - lib/skyfall/car_archive.rb
 - lib/skyfall/cid.rb
 - 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
@@ -146,13 +141,13 @@ files:
 - lib/skyfall/stream.rb
 - lib/skyfall/version.rb
 - sig/skyfall.rbs
-homepage: https://github.com/mackuba/skyfall
+homepage: https://ruby.sdk.blue
 licenses:
 - Zlib
 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
+  bug_tracker_uri: https://tangled.org/mackuba.eu/skyfall/issues
+  changelog_uri: https://tangled.org/mackuba.eu/skyfall/blob/master/CHANGELOG.md
+  source_code_uri: https://tangled.org/mackuba.eu/skyfall
 rdoc_options: []
 require_paths:
 - lib
@@ -167,7 +162,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 4.0.3
 specification_version: 4
-summary: A Ruby gem for streaming data from the Bluesky/AtProto firehose
+summary: A Ruby gem for streaming data from the Bluesky/ATProto firehose
 test_files: []

data/example/block_tracker.rb

@@ -1,84 +0,0 @@
-#!/usr/bin/env ruby
-
-# Example: monitor the network for people blocking your account or adding you to mute lists.
-
-# load skyfall from a local folder - you normally won't need this
-$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
-
-require 'json'
-require 'open-uri'
-require 'skyfall'
-
-$monitored_did = ARGV[0]
-
-if $monitored_did.to_s.empty?
-  puts "Usage: #{$PROGRAM_NAME} <monitored_did>"
-  exit 1
-elsif ARGV[0] !~ /^did:plc:[a-z0-9]{24}$/
-  puts "Not a valid DID: #{$monitored_did}"
-  exit 1
-end
-
-sky = Skyfall::Firehose.new('bsky.network', :subscribe_repos)
-
-sky.on_connect { puts "Connected, monitoring #{$monitored_did}" }
-sky.on_disconnect { puts "Disconnected" }
-sky.on_reconnect { puts "Reconnecting..." }
-sky.on_error { |e| puts "ERROR: #{e}" }
-
-sky.on_message do |msg|
-  # we're only interested in repo commit messages
-  next if msg.type != :commit
-
-  msg.operations.each do |op|
-    next if op.action != :create
-
-    begin
-      case op.type
-      when :bsky_block
-        process_block(msg, op)
-      when :bsky_listitem
-        process_list_item(msg, op)
-      end
-    rescue StandardError => e
-      puts "Error: #{e}"
-    end
-  end
-end
-
-def process_block(msg, op)
-  if op.raw_record['subject'] == $monitored_did
-    owner_handle = get_user_handle(op.repo)
-    puts "@#{owner_handle} has blocked you! (#{msg.time.getlocal})"
-  end
-end
-
-def process_list_item(msg, op)
-  if op.raw_record['subject'] == $monitored_did
-    owner_handle = get_user_handle(op.repo)
-
-    list_uri = op.raw_record['list']
-    list_name = get_list_name(list_uri)
-
-    puts "@#{owner_handle} has added you to list \"#{list_name}\" (#{msg.time.getlocal})"
-  end
-end
-
-def get_user_handle(did)
-  url = "https://plc.directory/#{did}"
-  json = JSON.parse(URI.open(url).read)
-  json['alsoKnownAs'][0].gsub('at://', '')
-end
-
-def get_list_name(list_uri)
-  repo, type, rkey = list_uri.gsub('at://', '').split('/')
-  url = "https://bsky.social/xrpc/com.atproto.repo.getRecord?repo=#{repo}&collection=#{type}&rkey=#{rkey}"
-
-  json = JSON.parse(URI.open(url).read)
-  json['value']['name']
-end
-
-# close the connection cleanly on Ctrl+C
-trap("SIGINT") { sky.disconnect }
-
-sky.connect

data/example/jet_monitor_phrases.rb

@@ -1,54 +0,0 @@
-#!/usr/bin/env ruby
-
-# Example: monitor new posts for mentions of one or more words or phrases (e.g. anyone mentioning your name or the name
-# of your company, project etc.). This example uses a Jetstream connection.
-
-# load skyfall from a local folder - you normally won't need this
-$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
-
-require 'json'
-require 'open-uri'
-require 'skyfall'
-
-terms = ARGV.map(&:downcase)
-
-if terms.empty?
-  puts "Usage: #{$PROGRAM_NAME} <word_or_phrase> [<word_or_phrase>...]"
-  exit 1
-end
-
-# tell Jetstream to send us only post records
-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
-  next if msg.type != :commit
-
-  msg.operations.each do |op|
-    # ignore any operations other than "create post"
-    next unless op.action == :create && op.type == :bsky_post
-
-    text = op.raw_record['text'].to_s.downcase
-
-    if terms.any? { |x| text.include?(x) }
-      owner_handle = get_user_handle(op.repo)
-      puts "\n#{msg.time.getlocal} @#{owner_handle}: #{op.raw_record['text']}"
-    end
-  end
-end
-
-def get_user_handle(did)
-  url = "https://plc.directory/#{did}"
-  json = JSON.parse(URI.open(url).read)
-  json['alsoKnownAs'][0].gsub('at://', '')
-end
-
-sky.on_connect { puts "Connected" }
-sky.on_disconnect { puts "Disconnected" }
-sky.on_reconnect { puts "Reconnecting..." }
-sky.on_error { |e| puts "ERROR: #{e}" }
-
-# close the connection cleanly on Ctrl+C
-trap("SIGINT") { sky.disconnect }
-
-sky.connect

data/example/print_all_posts.rb

@@ -1,34 +0,0 @@
-#!/usr/bin/env ruby
-
-# Example: print the date and text of every new post made on the network as they appear.
-
-# load skyfall from a local folder - you normally won't need this
-$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
-
-require 'skyfall'
-
-sky = Skyfall::Firehose.new('bsky.network', :subscribe_repos)
-
-sky.on_message do |msg|
-  # we're only interested in repo commit messages
-  next if msg.type != :commit
-
-  msg.operations.each do |op|
-    # ignore any operations other than "create post"
-    next unless op.action == :create && op.type == :bsky_post
-
-    puts "#{op.repo} • #{msg.time.getlocal}"
-    puts op.raw_record['text']
-    puts
-  end
-end
-
-sky.on_connect { puts "Connected" }
-sky.on_disconnect { puts "Disconnected" }
-sky.on_reconnect { puts "Reconnecting..." }
-sky.on_error { |e| puts "ERROR: #{e}" }
-
-# close the connection cleanly on Ctrl+C
-trap("SIGINT") { sky.disconnect }
-
-sky.connect

data/example/push_notifications.rb

@@ -1,262 +0,0 @@
-#!/usr/bin/env ruby
-
-# Example: send push notifications to a client app about interactions with a given account.
-
-# load skyfall from a local folder - you normally won't need this
-$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
-
-require 'json'
-require 'open-uri'
-require 'skyfall'
-
-monitored_did = ARGV[0]
-
-if monitored_did.to_s.empty?
-  puts "Usage: #{$PROGRAM_NAME} <monitored_did>"
-  exit 1
-elsif monitored_did !~ /^did:plc:[a-z0-9]{24}$/
-  puts "Not a valid DID: #{monitored_did}"
-  exit 1
-end
-
-class InvalidURIException < StandardError
-  def initialize(uri)
-    super("Invalid AT URI: #{uri}")
-  end
-end
-
-class AtURI
-  attr_reader :did, :collection, :rkey
-
-  def initialize(uri)
-    if uri =~ /\Aat:\/\/(did:[\w]+:[\w\.\-]+)\/([\w\.]+)\/([\w\-]+)\z/
-      @did = $1
-      @collection = $2
-      @rkey = $3
-    else
-      raise InvalidURIException, uri
-    end
-  end
-end
-
-class NotificationEngine
-  def initialize(user_did)
-    @user_did = user_did
-  end
-
-  def connect
-    @sky = Skyfall::Firehose.new('bsky.network', :subscribe_repos)
-
-    @sky.on_connect { puts "Connected, monitoring #{@user_did}" }
-    @sky.on_disconnect { puts "Disconnected" }
-    @sky.on_reconnect { puts "Reconnecting..." }
-    @sky.on_error { |e| puts "ERROR: #{e}" }
-
-    @sky.on_message do |msg|
-      process_message(msg)
-    end
-
-    @sky.connect
-  end
-
-  def disconnect
-    @sky.disconnect
-  end
-
-  def process_message(msg)
-    # we're only interested in repo commit messages
-    return if msg.type != :commit
-
-    # ignore user's own actions
-    return if msg.repo == @user_did
-
-    msg.operations.each do |op|
-      next if op.action != :create
-
-      begin
-        case op.type
-        when :bsky_post
-          process_post(msg, op)
-        when :bsky_like
-          process_like(msg, op)
-        when :bsky_repost
-          process_repost(msg, op)
-        when :bsky_follow
-          process_follow(msg, op)
-        end
-      rescue StandardError => e
-        puts "Error: #{e}"
-      end
-    end
-  end
-
-
-  # posts
-
-  def process_post(msg, op)
-    data = op.raw_record
-
-    if reply = data['reply']
-      # check for replies (direct only)
-      if reply['parent'] && reply['parent']['uri']
-        parent_uri = AtURI.new(reply['parent']['uri'])
-
-        if parent_uri.did == @user_did
-          send_reply_notification(msg, op)
-        end
-      end
-    end
-
-    if embed = data['embed']
-      # check for quotes
-      if embed['record'] && embed['record']['uri']
-        quoted_uri = AtURI.new(embed['record']['uri'])
-
-        if quoted_uri.did == @user_did
-          send_quote_notification(msg, op)
-        end
-      end
-
-      # second type of quote (recordWithMedia)
-      if embed['record'] && embed['record']['record'] && embed['record']['record']['uri']
-        quoted_uri = AtURI.new(embed['record']['record']['uri'])
-
-        if quoted_uri.did == @user_did
-          send_quote_notification(msg, op)
-        end
-      end
-    end
-
-    if facets = data['facets']
-      # check for mentions
-      if facets.any? { |f| f['features'] && f['features'].any? { |x| x['did'] == @user_did }}
-        send_mention_notification(msg, op)
-      end
-    end
-  end
-
-  def send_reply_notification(msg, op)
-    handle = get_user_handle(msg.repo)
-
-    send_push("@#{handle} replied:", op.raw_record)
-  end
-
-  def send_quote_notification(msg, op)
-    handle = get_user_handle(msg.repo)
-
-    send_push("@#{handle} quoted you:", op.raw_record)
-  end
-
-  def send_mention_notification(msg, op)
-    handle = get_user_handle(msg.repo)
-
-    send_push("@#{handle} mentioned you:", op.raw_record)
-  end
-
-
-  # likes
-
-  def process_like(msg, op)
-    data = op.raw_record
-
-    if data['subject'] && data['subject']['uri']
-      liked_uri = AtURI.new(data['subject']['uri'])
-
-      if liked_uri.did == @user_did
-        case liked_uri.collection
-        when 'app.bsky.feed.post'
-          send_post_like_notification(msg, liked_uri)
-        when 'app.bsky.feed.generator'
-          send_feed_like_notification(msg, liked_uri)
-        end
-      end
-    end
-  end
-
-  def send_post_like_notification(msg, uri)
-    handle = get_user_handle(msg.repo)
-    post = get_record(uri)
-
-    send_push("@#{handle} liked your post", post)
-  end
-
-  def send_feed_like_notification(msg, uri)
-    handle = get_user_handle(msg.repo)
-    feed = get_record(uri)
-
-    send_push("@#{handle} liked your feed", feed)
-  end
-
-
-  # reposts
-
-  def process_repost(msg, op)
-    data = op.raw_record
-
-    if data['subject'] && data['subject']['uri']
-      reposted_uri = AtURI.new(data['subject']['uri'])
-
-      if reposted_uri.did == @user_did && reposted_uri.collection == 'app.bsky.feed.post'
-        send_repost_notification(msg, reposted_uri)
-      end
-    end
-  end
-
-  def send_repost_notification(msg, uri)
-    handle = get_user_handle(msg.repo)
-    post = get_record(uri)
-
-    send_push("@#{handle} reposted your post", post)
-  end
-
-
-  # follows
-
-  def process_follow(msg, op)
-    if op.raw_record['subject'] == @user_did
-      send_follow_notification(msg)
-    end
-  end
-
-  def send_follow_notification(msg)
-    handle = get_user_handle(msg.repo)
-
-    send_push("@#{handle} followed you", msg.repo)
-  end
-
-
-  #
-  # Note: in this example, we're calling the Bluesky AppView to get details about the person interacting with the user
-  # and the post/feed that was liked/reposted etc. In a real app, you might run into rate limits if you do that,
-  # because these requests will all be sent from the server's IP.
-  #
-  # So you might need to take a different route and send just the info that you have here in the push notification data
-  # (the AT URI / DID) and fetch the details on the client side, e.g. in a Notification Service Extension on iOS.
-  #
-
-  def get_user_handle(did)
-    url = "https://api.bsky.app/xrpc/app.bsky.actor.getProfile?actor=#{did}"
-    json = JSON.parse(URI.open(url).read)
-    json['handle']
-  end
-
-  def get_record(uri)
-    url = "https://api.bsky.app/xrpc/com.atproto.repo.getRecord?" +
-          "repo=#{uri.did}&collection=#{uri.collection}&rkey=#{uri.rkey}"
-    json = JSON.parse(URI.open(url).read)
-    json['value']
-  end
-
-  def send_push(message, data = nil)
-    # send the message to APNS/FCM here
-    puts
-    puts "[#{Time.now}] #{message} #{data&.inspect}"
-  end
-end
-
-engine = NotificationEngine.new(monitored_did)
-
-# close the connection cleanly on Ctrl+C
-trap("SIGINT") { engine.disconnect }
-
-engine.connect

data/lib/skyfall/faye_ext.rb

@@ -1,48 +0,0 @@
-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