downstream 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b7d5e8e2cd8390bbb0eef4fc8df4615c1bb2a5f5202ac0711f417b6347b7adc
-  data.tar.gz: 2a13ccafc25da88885ce49a309c41d4fc0cda93a7ffbd37cc2454e94359c1248
+  metadata.gz: 3806c4f875e378357e47571ed0bd5dbac1b45a80f9a01a78187b3c971378f425
+  data.tar.gz: e038408a8fb1ce3e18dfd7614e9fe3931fd72c7913249457c29fa00b14a22aa4
 SHA512:
-  metadata.gz: 5b1cc9d3110a38b6575363b929cf8d2b8a6df186e4099268a9f66f6c20f4d04d3e1c62df9b0c308ee21a5a8e1fcdf9c1f62070e39708db22be739173f8a0d788
-  data.tar.gz: 4ff6301363da1ebff02ba743571166b89eaf35151427a3f6f8e70d54e8bd18a244ae863cdab4247afb412f97ed1a7a7b01a91a3c54d0ab35a56810584d87ef39
+  metadata.gz: 6f81acf6c0da05267067ac4d4c60d9edcb8aefba35d326643651afcf4ba17df09b88a791b379f10318e0c63aeaa691397d10b3a2cad10e23a38b2c29990fa9bf
+  data.tar.gz: 97bf35f16b9542bb032fb0ed52b6192b24ea92a3157d2f0cfc883546f50ee04e759965d6281fbb956e30029ee8bd716b129b8340b5638c3d619be78ca4494faf

data/README.md

@@ -27,6 +27,7 @@ Downstream supports various adapters for event handling. It can be configured in
 ```ruby
 Downstream.configure do |config|
   config.pubsub = :stateless # it's a default adapter
+  config.async_queue = :high_priority # nil by default
 end
 ```
 
@@ -112,6 +113,20 @@ Downstream.subscribed(subscriber, to: ProfileCreated) do
 end
 ```
 
+If you want to handle events in a background job, you can pass the `async: true` option:
+
+```ruby
+store.subscribe OnProfileCreated::DoThat, async: true
+```
+
+By default, a job will be enqueued into `async_queue` name from the Downstream config. You can define your own queue name for a specific subscriber:
+
+```ruby
+store.subscribe OnProfileCreated::DoThat, async: {queue: :low_priority}
+```
+
+**NOTE:** all subscribers are synchronous by default
+
 ## Testing
 
 You can test subscribers as normal Ruby objects.

data/lib/downstream/config.rb

@@ -4,6 +4,7 @@ require "active_support/inflections"
 
 module Downstream
   class Config
+    attr_accessor :async_queue
     attr_writer :namespace
 
     def namespace

data/lib/downstream/event.rb

@@ -1,10 +1,24 @@
 # frozen_string_literal: true
 
+GlobalID::Locator.use :downstream do |gid|
+  params = gid.params.each_with_object({}) do |(key, value), memo|
+    memo[key.to_sym] = if value.is_a?(String) && value.start_with?("gid://")
+      GlobalID::Locator.locate(value)
+    else
+      value
+    end
+  end
+
+  gid.model_name.constantize
+    .new(event_id: gid.model_id, **params)
+end
+
 module Downstream
   class Event
     extend ActiveModel::Naming
+    include GlobalID::Identification
 
-    RESERVED_ATTRIBUTES = %i[event_id type].freeze
+    RESERVED_ATTRIBUTES = %i[id event_id type].freeze
 
     class << self
       attr_writer :identifier
@@ -57,6 +71,8 @@ module Downstream
 
     attr_reader :event_id, :data, :errors
 
+    alias_method :id, :event_id
+
     def initialize(event_id: nil, **params)
       @event_id = event_id || SecureRandom.hex(10)
       validate_attributes!(params)
@@ -77,6 +93,20 @@ module Downstream
       }
     end
 
+    def to_global_id
+      new_data = data.each_with_object({}) do |(key, value), memo|
+        memo[key] = if value.respond_to?(:to_global_id)
+          value.to_global_id
+        else
+          value
+        end
+      end
+
+      super(new_data.merge!(app: :downstream))
+    end
+
+    alias_method :to_gid, :to_global_id
+
     def inspect
       "#{self.class.name}<#{type}##{event_id}>, data: #{data}"
     end
@@ -85,6 +115,15 @@ module Downstream
       data.fetch(attr)
     end
 
+    def ==(other)
+      super ||
+        other.instance_of?(self.class) &&
+          !event_id.nil? &&
+          other.event_id == event_id
+    end
+
+    alias_method :eql?, :==
+
     private
 
     def validate_attributes!(params)

data/lib/downstream/pubsub_adapters/stateless/pubsub.rb

@@ -4,10 +4,10 @@ require_relative "subscriber"
 module Downstream
   module Stateless
     class Pubsub < AbstractPubsub
-      def subscribe(identifier, callable)
+      def subscribe(identifier, callable, async: false)
         ActiveSupport::Notifications.subscribe(
           identifier,
-          Subscriber.new(callable)
+          Subscriber.new(callable, async: async)
         )
       end
 

data/lib/downstream/pubsub_adapters/stateless/subscriber.rb

@@ -1,19 +1,53 @@
+require_relative "subscriber_job"
+
 module Downstream
   module Stateless
     class Subscriber
-      attr_reader :callable
+      include AfterCommitEverywhere
+
+      attr_reader :callable, :async
 
-      def initialize(callable)
+      def initialize(callable, async: false)
         @callable = callable
+        @async = async
+      end
+
+      def async?
+        !!async
       end
 
-      def call(name, event)
-        if (callable.respond_to?(:arity) && callable.arity == 2) || callable.method(:call).arity == 2
-          callable.call(name, event)
+      def call(_name, event)
+        if async?
+          if callable.is_a?(Proc) || callable.name.nil?
+            raise ArgumentError, "Anonymous subscribers (blocks/procs/lambdas or anonymous modules) cannot be asynchronous"
+          end
+
+          raise ArgumentError, "Async subscriber must be a module/class, not instance" unless callable.is_a?(Module)
+
+          after_commit do
+            SubscriberJob.then do |job|
+              if (queue_name = async_queue_name)
+                job.set(queue: queue_name)
+              else
+                job
+              end
+            end.perform_later(event, callable.name)
+          end
         else
           callable.call(event)
         end
       end
+
+      private
+
+      def async_queue_name
+        return @async_queue_name if defined?(@async_queue_name)
+
+        name = async[:queue] if async.is_a?(Hash)
+        name ||= Downstream.config.async_queue
+
+        @async_queue_name = name
+      end
     end
   end
 end

data/lib/downstream/pubsub_adapters/stateless/subscriber_job.rb

@@ -0,0 +1,9 @@
+module Downstream
+  module Stateless
+    class SubscriberJob < ActiveJob::Base
+      def perform(event, callable)
+        callable.constantize.call(event)
+      end
+    end
+  end
+end

data/lib/downstream/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Downstream
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 end

data/lib/downstream.rb

@@ -1,7 +1,10 @@
 # frozen_string_literal: true
 
 require "active_support"
+require "active_job"
 require "active_model"
+require "globalid"
+require "after_commit_everywhere"
 
 require "downstream/config"
 require "downstream/event"
@@ -20,13 +23,13 @@ module Downstream
       yield config
     end
 
-    def subscribe(subscriber = nil, to: nil, &block)
+    def subscribe(subscriber = nil, to: nil, async: false, &block)
       subscriber ||= block if block
       raise ArgumentError, "Subsriber must be present" if subscriber.nil?
 
       identifier = construct_identifier(subscriber, to)
 
-      pubsub.subscribe(identifier, subscriber)
+      pubsub.subscribe(identifier, subscriber, async: async)
     end
 
     # temporary subscriptions

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: downstream
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - merkushin.m.s@gmail.com
@@ -9,8 +9,36 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-10-29 00:00:00.000000000 Z
+date: 2021-11-01 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: after_commit_everywhere
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: globalid
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
@@ -53,6 +81,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: combustion
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: debug
   requirement: !ruby/object:Gem::Requirement
@@ -95,6 +137,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
 - !ruby/object:Gem::Dependency
   name: standard
   requirement: !ruby/object:Gem::Requirement
@@ -124,6 +194,7 @@ files:
 - lib/downstream/pubsub_adapters/abstract_pubsub.rb
 - lib/downstream/pubsub_adapters/stateless/pubsub.rb
 - lib/downstream/pubsub_adapters/stateless/subscriber.rb
+- lib/downstream/pubsub_adapters/stateless/subscriber_job.rb
 - lib/downstream/rspec.rb
 - lib/downstream/rspec/have_published_event.rb
 - lib/downstream/version.rb