noticed 1.5.5 → 1.5.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 90b43c50384068092455c10cd6686fc46cd766121c0ea5cf593bbc4c8306e8de
-  data.tar.gz: 23edb385b0c9981dd9c292c8f4c15ce6fadd9abb131adc1eb6440ab39c5fa186
+  metadata.gz: 85a89c655531764a6b6c97213a6b1368c21bee48e55298cb35be1154c32534ff
+  data.tar.gz: 404987e57e6f834fe21dc9b895664643767ed08e0d23e05c32cb31ebe0a8c5ab
 SHA512:
-  metadata.gz: 9a5d92df6618d53f8be91ca71bdf6dfc6ff0b66279662a5690c6efaa162939f2ae4fe1868956427ff10a83fa77329c16c96af3faef9e2fa48e441f1478c91ed0
-  data.tar.gz: 6d485a661fe14b24811479615e125cb4bf2794808dd28b39c102e677b1a1e99a0f22807acbc75a728442764f521c498ffa884998e243dacad5ea9e4e4cd2ca19
+  metadata.gz: 2cd89b9b0d0c0b76792861aba31db3402effab9136574425abfa44cb26130be894166834b1d80aca357c7d811c81d9f32dc5d5f4ad2e8bb68096310c9a8a7a1e
+  data.tar.gz: ec0b3c75c8976cd3e4789e54ca8d1744dad95d118f3c4d20a648153422425f03b8a34f1a5b16ed583db85eb3bfe778c996d354d168ac32765421b8a0bd33b8c6

data/README.md

@@ -16,6 +16,7 @@ Currently, we support these notification delivery methods out of the box:
 * Twilio (SMS)
 * Vonage / Nexmo (SMS)
 * iOS Apple Push Notifications
+* Firebase Cloud Messaging (Android and more)
 
 And you can easily add new notification types for any other delivery methods.
 
@@ -190,6 +191,31 @@ Example:
 deliver_by :slack, debug: true
 ```
 
+## ✅ Best Practices
+
+A common use case is to trigger a notification when a record is created. For example,
+
+```ruby
+class Message < ApplicationRecord
+  belongs_to :recipient, class_name: "User"
+  
+  after_create_commit :notify_recipient
+  
+  private
+  
+  def notify_recipient
+    NewMessageNotification.with(message: self).deliver_later(recipient)
+  end
+```
+
+If you are creating the notification on a background job (i.e. via `#deliver_later`), make sure you use a `commit` hook such as `after_create_commit` or `after_commit`.
+
+Using `after_create` might cause the notification delivery methods to fail. This is because the job was enqueued while inside a database transaction, and the `Message` record might not yet be saved to the database.
+
+A common symptom of this problem is undelivered notifications and the following error in your logs.
+
+> `Discarded Noticed::DeliveryMethods::Email due to a ActiveJob::DeserializationError.`
+
 ## 🚛 Delivery Methods
 
 The delivery methods are designed to be modular so you can customize the way each type gets delivered.
@@ -205,6 +231,7 @@ For example, emails will require a subject, body, and email address while an SMS
 * [Test](docs/delivery_methods/test.md)
 * [Twilio](docs/delivery_methods/twilio.md)
 * [Vonage](docs/delivery_methods/vonage.md)
+* [Firebase Cloud Messaging](docs/delivery_methods/fcm.md)
 
 ### Fallback Notifications
 

data/lib/noticed/delivery_methods/base.rb

@@ -29,8 +29,8 @@ module Noticed
         end
       end
 
-      def perform(args)
-        @notification = args[:notification_class].constantize.new(args[:params])
+      def assign_args(args)
+        @notification = args.fetch(:notification_class).constantize.new(args[:params])
         @options = args[:options] || {}
         @params = args[:params]
         @recipient = args[:recipient]
@@ -39,6 +39,11 @@ module Noticed
         # Make notification aware of database record and recipient during delivery
         @notification.record = args[:record]
         @notification.recipient = args[:recipient]
+        self
+      end
+
+      def perform(args)
+        assign_args(args)
 
         return if (condition = @options[:if]) && !@notification.send(condition)
         return if (condition = @options[:unless]) && @notification.send(condition)
@@ -57,16 +62,16 @@ module Noticed
       # Helper method for making POST requests from delivery methods
       #
       # Usage:
-      #   post("http://example.com", basic_auth: {user:, pass:}, json: {}, form: {})
+      #   post("http://example.com", basic_auth: {user:, pass:}, headers: {}, json: {}, form: {})
       #
       def post(url, args = {})
+        options ||= {}
         basic_auth = args.delete(:basic_auth)
+        headers = args.delete(:headers)
 
-        request = if basic_auth
-          HTTP.basic_auth(user: basic_auth[:user], pass: basic_auth[:pass])
-        else
-          HTTP
-        end
+        request = HTTP
+        request = request.basic_auth(user: basic_auth[:user], pass: basic_auth[:pass]) if basic_auth
+        request = request.headers(headers) if headers
 
         response = request.post(url, args)
 
@@ -76,6 +81,8 @@ module Noticed
         end
 
         if !options[:ignore_failure] && !response.status.success?
+          puts response.status
+          puts response.body
           raise ResponseUnsuccessful.new(response)
         end
 

data/lib/noticed/delivery_methods/fcm.rb

@@ -0,0 +1,92 @@
+require "googleauth"
+
+# class CommentNotifier
+#  deliver_by :fcm, credentials: Rails.root.join("config/certs/fcm.json"), format: :format_notification
+#
+#  deliver_by :fcm, credentials: :fcm_credentials
+#   def fcm_credentials
+#     { project_id: "api-12345" }
+#   end
+# end
+
+module Noticed
+  module DeliveryMethods
+    class Fcm < Base
+      BASE_URI = "https://fcm.googleapis.com/v1/projects/"
+
+      option :format
+
+      def deliver
+        device_tokens.each do |device_token|
+          post("#{BASE_URI}#{project_id}/messages:send", headers: {authorization: "Bearer #{access_token}"}, json: {message: format(device_token)})
+        rescue ResponseUnsuccessful
+          cleanup_invalid_token(device_token)
+        end
+      end
+
+      def cleanup_invalid_token(device_token)
+        return unless notification.respond_to?(:cleanup_device_token)
+        notification.send(:cleanup_device_token, token: device_token, platform: "fcm")
+      end
+
+      def credentials
+        @credentials ||= begin
+          option = options[:credentials]
+          credentials_hash = case option
+          when Hash
+            option
+          when Pathname
+            load_json(option)
+          when String
+            load_json(Rails.root.join(option))
+          when Symbol
+            notification.send(option)
+          else
+            Rails.application.credentials.fcm
+          end
+
+          credentials_hash.symbolize_keys
+        end
+      end
+
+      def load_json(path)
+        JSON.parse(File.read(path))
+      end
+
+      def project_id
+        credentials[:project_id]
+      end
+
+      def access_token
+        token = authorizer.fetch_access_token!
+        token["access_token"]
+      end
+
+      def authorizer
+        @authorizer ||= options.fetch(:authorizer, Google::Auth::ServiceAccountCredentials).make_creds(
+          json_key_io: StringIO.new(credentials.to_json),
+          scope: "https://www.googleapis.com/auth/firebase.messaging"
+        )
+      end
+
+      def format(device_token)
+        notification.send(options[:format], device_token)
+      end
+
+      def device_tokens
+        if notification.respond_to?(:fcm_device_tokens)
+          Array.wrap(notification.fcm_device_tokens(recipient))
+        else
+          raise NoMethodError, <<~MESSAGE
+            You must implement `fcm_device_tokens` to send Firebase Cloud Messaging notifications
+
+            # This must return an Array of FCM device tokens
+            def fcm_device_tokens(recipient)
+              recipient.fcm_device_tokens.pluck(:token)
+            end
+          MESSAGE
+        end
+      end
+    end
+  end
+end

data/lib/noticed/delivery_methods/ios.rb

@@ -51,8 +51,8 @@ module Noticed
             You must implement `ios_device_tokens` to send iOS notifications
 
             # This must return an Array of iOS device tokens
-            def ios_device_tokens(user)
-              user.ios_device_tokens.pluck(:token)
+            def ios_device_tokens(recipient)
+              recipient.ios_device_tokens.pluck(:token)
             end
           MESSAGE
         end

data/lib/noticed/version.rb

@@ -1,3 +1,3 @@
 module Noticed
-  VERSION = "1.5.5"
+  VERSION = "1.5.6"
 end

data/lib/noticed.rb

@@ -22,6 +22,7 @@ module Noticed
     autoload :Test, "noticed/delivery_methods/test"
     autoload :Twilio, "noticed/delivery_methods/twilio"
     autoload :Vonage, "noticed/delivery_methods/vonage"
+    autoload :Fcm, "noticed/delivery_methods/fcm"
   end
 
   def self.notify(recipients:, notification:)

data/lib/rails_6_polyfills/base.rb

@@ -1,11 +1,11 @@
 # The following implements polyfills for Rails < 6.0
 module ActionCable
   # If the Rails 6.0 ActionCable::TestHelper is missing then allow it to autoload
-  unless ActionCable.const_defined? "TestHelper"
+  unless ActionCable.const_defined? :TestHelper
     autoload :TestHelper, "rails_6_polyfills/actioncable/test_helper.rb"
   end
   # If the Rails 6.0 test SubscriptionAdapter is missing then allow it to autoload
-  unless ActionCable.const_defined? "SubscriptionAdapter::Test"
+  unless ActionCable::SubscriptionAdapter.const_defined? :Test
     module SubscriptionAdapter
       autoload :Test, "rails_6_polyfills/actioncable/test_adapter.rb"
     end
@@ -13,6 +13,6 @@ module ActionCable
 end
 
 # If the Rails 6.0 ActionJob Serializers are missing then load support for them
-unless Object.const_defined?("ActiveJob::Serializers")
+unless ActiveJob.const_defined?(:Serializers)
   require "rails_6_polyfills/activejob/serializers"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: noticed
 version: !ruby/object:Gem::Version
-  version: 1.5.5
+  version: 1.5.6
 platform: ruby
 authors:
 - Chris Oliver
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-12-01 00:00:00.000000000 Z
+date: 2022-01-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -132,6 +132,7 @@ files:
 - lib/noticed/delivery_methods/base.rb
 - lib/noticed/delivery_methods/database.rb
 - lib/noticed/delivery_methods/email.rb
+- lib/noticed/delivery_methods/fcm.rb
 - lib/noticed/delivery_methods/ios.rb
 - lib/noticed/delivery_methods/microsoft_teams.rb
 - lib/noticed/delivery_methods/slack.rb
@@ -169,7 +170,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
+rubygems_version: 3.2.32
 signing_key:
 specification_version: 4
 summary: Notifications for Ruby on Rails applications