activity_notification 2.0.0 → 2.1.0

data/lib/activity_notification/optional_targets/base.rb

@@ -3,22 +3,11 @@ module ActivityNotification
   module OptionalTarget
     # Abstract optional target class to develop optional notification target class.
     class Base
-      # View context to render notification message
-      # @return View context to render notification message
-      attr_accessor :view_context
-
       # Initialize method to create view context in this OptionalTarget instance
       # @param [Hash] options Options for initializing target
       # @option options [Boolean] :skip_initializing_target (false) Whether skip calling initialize_target method
       # @option options [Hash]    others                            Options for initializing target
       def initialize(options = {})
-        @view_context = ActionView::Base.new(ActionController::Base.view_paths, {})
-        @view_context.class_eval do 
-          include Rails.application.routes.url_helpers
-          def default_url_options
-            ActionMailer::Base.default_url_options
-          end
-        end
         initialize_target(options) unless options.delete(:skip_initializing_target)
       end
 
@@ -64,12 +53,17 @@ module ActivityNotification
               "activity_notification/optional_targets/default/base"
             ]
           options[:fallback] ||= :default
-          @view_context.assign((options[:assignment] || {}).merge(notification: notification, target: notification.target))
 
           message, missing_template = nil, nil
           partial_root_list.each do |partial_root|
             begin
-              message = notification.render(@view_context, options.merge(partial_root: partial_root)).to_str
+              message = notification.render(
+                ActivityNotification::NotificationsController.renderer,
+                options.merge(
+                  partial_root: partial_root,
+                  assigns: (options[:assignment] || {}).merge(notification: notification, target: notification.target)
+                )
+              ).to_s
               break
             rescue ActionView::MissingTemplate => e
               missing_template = e

data/lib/activity_notification/orm/active_record/notification.rb

@@ -126,6 +126,22 @@ module ActivityNotification
         # @return [ActiveRecord_AssociationRelation<Notificaion>] Database query of filtered notifications
         scope :filtered_by_group,                 ->(group) { where(group: group) }
 
+        # Selects filtered notifications later than specified time.
+        # @example Get filtered unopened notificatons of the @user later than @notification
+        #   @notifications = @user.notifications.unopened_only.later_than(@notification.created_at)
+        # @scope class
+        # @param [Time] Created time of the notifications for filter
+        # @return [ActiveRecord_AssociationRelation<Notificaion>, Mongoid::Criteria<Notificaion>] Database query of filtered notifications
+        scope :later_than,                        ->(created_time) { where('created_at > ?', created_time) }
+
+        # Selects filtered notifications earlier than specified time.
+        # @example Get filtered unopened notificatons of the @user earlier than @notification
+        #   @notifications = @user.notifications.unopened_only.earlier_than(@notification.created_at)
+        # @scope class
+        # @param [Time] Created time of the notifications for filter
+        # @return [ActiveRecord_AssociationRelation<Notificaion>, Mongoid::Criteria<Notificaion>] Database query of filtered notifications
+        scope :earlier_than,                      ->(created_time) { where('created_at < ?', created_time) }
+
         # Includes target instance with query for notifications.
         # @return [ActiveRecord_AssociationRelation<Notificaion>] Database query of notifications with target
         scope :with_target,                       -> { includes(:target) }
@@ -152,7 +168,7 @@ module ActivityNotification
 
         # Raise DeleteRestrictionError for notifications.
         # @param [String] error_text Error text for raised exception
-        # @raise DeleteRestrictionError
+        # @raise [ActiveRecord::DeleteRestrictionError] DeleteRestrictionError from used ORM
         # @return [void]
         def self.raise_delete_restriction_error(error_text)
           raise ::ActiveRecord::DeleteRestrictionError.new(error_text)

data/lib/activity_notification/orm/active_record/subscription.rb

@@ -17,7 +17,7 @@ module ActivityNotification
         serialize  :optional_targets, Hash
 
         validates  :target,               presence: true
-        validates  :key,                  presence: true
+        validates  :key,                  presence: true, uniqueness: { scope: :target }
         validates_inclusion_of :subscribing,          in: [true, false]
         validates_inclusion_of :subscribing_to_email, in: [true, false]
         validate   :subscribing_to_email_cannot_be_true_when_subscribing_is_false

data/lib/activity_notification/orm/dynamoid.rb

@@ -249,6 +249,26 @@ module Dynamoid # :nodoc: all
         where(key: key)
       end
 
+      # Selects filtered notifications later than specified time.
+      # @example Get filtered unopened notificatons of the @user later than @notification
+      #   @notifications = @user.notifications.unopened_only.later_than(@notification.created_at)
+      # @scope class
+      # @param [Time] Created time of the notifications for filter
+      # @return [ActiveRecord_AssociationRelation<Notificaion>, Mongoid::Criteria<Notificaion>] Database query of filtered notifications
+      def later_than(created_time)
+        where('created_at.gt': created_time)
+      end
+
+      # Selects filtered notifications earlier than specified time.
+      # @example Get filtered unopened notificatons of the @user earlier than @notification
+      #   @notifications = @user.notifications.unopened_only.earlier_than(@notification.created_at)
+      # @scope class
+      # @param [Time] Created time of the notifications for filter
+      # @return [ActiveRecord_AssociationRelation<Notificaion>, Mongoid::Criteria<Notificaion>] Database query of filtered notifications
+      def earlier_than(created_time)
+        where('created_at.lt': created_time)
+      end
+
       # Selects filtered notifications or subscriptions by notifiable_type, group or key with filter options.
       # @example Get filtered unopened notificatons of the @user for Comment notifiable class
       #   @notifications = @user.notifications.unopened_only.filtered_by_options({ filtered_by_type: 'Comment' })
@@ -269,6 +289,8 @@ module Dynamoid # :nodoc: all
       # @option options [String]     :filtered_by_group_type (nil) Group type for filter, valid with :filtered_by_group_id
       # @option options [String]     :filtered_by_group_id   (nil) Group instance id for filter, valid with :filtered_by_group_type
       # @option options [String]     :filtered_by_key        (nil) Key of the notification for filter
+      # @option options [String]     :later_than             (nil) ISO 8601 format time to filter notification index later than specified time
+      # @option options [String]     :earlier_than           (nil) ISO 8601 format time to filter notification index earlier than specified time
       # @option options [Array|Hash] :custom_filter          (nil) Custom notification filter (e.g. ['created_at.gt': time.hour.ago])
       # @return [Dynamoid::Criteria::Chain] Database query of filtered notifications or subscriptions
       def filtered_by_options(options = {})
@@ -286,6 +308,12 @@ module Dynamoid # :nodoc: all
         if options.has_key?(:filtered_by_key)
           filtered_notifications = filtered_notifications.filtered_by_key(options[:filtered_by_key])
         end
+        if options.has_key?(:later_than)
+          filtered_notifications = filtered_notifications.later_than(Time.iso8601(options[:later_than]))
+        end
+        if options.has_key?(:earlier_than)
+          filtered_notifications = filtered_notifications.earlier_than(Time.iso8601(options[:earlier_than]))
+        end
         if options.has_key?(:custom_filter)
           filtered_notifications = filtered_notifications.where(options[:custom_filter])
         end

data/lib/activity_notification/orm/dynamoid/extension.rb

@@ -1,6 +1,6 @@
 require 'dynamoid/adapter_plugin/aws_sdk_v3'
 
-# Entend Dynamoid to support none, limit, exists?, update_all in Dynamoid::Criteria::Chain.
+# Entend Dynamoid v3.1.0 to support none, limit, exists?, update_all, serializable_hash in Dynamoid::Criteria::Chain.
 # ActivityNotification project will try to contribute these fundamental functions to Dynamoid upstream.
 # @private
 module Dynamoid # :nodoc: all
@@ -32,6 +32,7 @@ module Dynamoid # :nodoc: all
     # https://github.com/Dynamoid/dynamoid/blob/master/lib/dynamoid/criteria/chain.rb
     # @private
     class Chain
+      # Return new none object
       def none
         None.new(self.source)
       end
@@ -64,6 +65,11 @@ module Dynamoid # :nodoc: all
           document.update_attributes(conditions)
         end
       end
+
+      # Return serializable_hash as array
+      def serializable_hash(options = {})
+        all.to_a.map { |r| r.serializable_hash(options) }
+      end
     end
 
     # https://github.com/Dynamoid/dynamoid/blob/master/lib/dynamoid/criteria.rb
@@ -163,6 +169,78 @@ module Dynamoid # :nodoc: all
   end
 end
 
+# Entend Dynamoid to support uniqueness validator
+# @private
+module Dynamoid # :nodoc: all
+  # https://github.com/Dynamoid/dynamoid/blob/master/lib/dynamoid/validations.rb
+  # @private
+  module Validations
+    # Validates whether or not a field is unique against the records in the database.
+    class UniquenessValidator < ActiveModel::EachValidator
+      # Validate the document for uniqueness violations.
+      # @param [Document] document The document to validate.
+      # @param [Symbol] attribute  The name of the attribute.
+      # @param [Object] value      The value of the object.
+      def validate_each(document, attribute, value)
+        return unless validation_required?(document, attribute)
+        document.errors.add(attribute, :taken, options.except(:scope).merge(value: value)) if not_unique?(document, attribute, value)
+      end
+
+      private
+
+      # Are we required to validate the document?
+      # @api private
+      def validation_required?(document, attribute)
+        document.new_record? ||
+          document.send("attribute_changed?", attribute.to_s) ||
+          scope_value_changed?(document)
+      end
+
+      # Scope reference has changed?
+      # @api private
+      def scope_value_changed?(document)
+        Array.wrap(options[:scope]).any? do |item|
+          document.send("attribute_changed?", item.to_s)
+        end
+      end
+
+      # Check whether a record is uniqueness.
+      # @api private
+      def not_unique?(document, attribute, value)
+        klass = document.class
+        while klass.superclass.respond_to?(:validators) && klass.superclass.validators.include?(self)
+          klass = klass.superclass
+        end
+        criteria = create_criteria(klass, document, attribute, value)
+        criteria.exists?
+      end
+
+      # Create the validation criteria.
+      # @api private
+      def create_criteria(base, document, attribute, value)
+        criteria = scope(base, document)
+        filter_criteria(criteria, document, attribute)
+      end
+
+      # Scope the criteria to the scope options provided.
+      # @api private
+      def scope(criteria, document)
+        Array.wrap(options[:scope]).each do |item|
+          criteria = filter_criteria(criteria, document, item)
+        end
+        criteria
+      end
+
+      # Filter the criteria.
+      # @api private
+      def filter_criteria(criteria, document, attribute)
+        value = document.read_attribute(attribute)
+        value.nil? ? criteria.where("#{attribute}.null" => true) : criteria.where(attribute => value)
+      end
+    end
+  end
+end
+
 module ActivityNotification
   # Dynamoid extension module for ActivityNotification.
   module DynamoidExtension

data/lib/activity_notification/orm/dynamoid/notification.rb

@@ -116,7 +116,7 @@ module ActivityNotification
 
         # Raise ActivityNotification::DeleteRestrictionError for notifications.
         # @param [String] error_text Error text for raised exception
-        # @raise ActivityNotification::DeleteRestrictionError
+        # @raise [ActivityNotification::DeleteRestrictionError] DeleteRestrictionError from used ORM
         # @return [void]
         def self.raise_delete_restriction_error(error_text)
           raise ActivityNotification::DeleteRestrictionError, error_text

data/lib/activity_notification/orm/dynamoid/subscription.rb

@@ -31,7 +31,7 @@ module ActivityNotification
         global_secondary_index hash_key: :target_key, range_key: :created_at, projected_attributes: :all
 
         validates  :target,               presence: true
-        validates  :key,                  presence: true
+        validates  :key,                  presence: true, uniqueness: { scope: :target_key }
         validates_inclusion_of :subscribing,          in: [true, false]
         validates_inclusion_of :subscribing_to_email, in: [true, false]
         validate   :subscribing_to_email_cannot_be_true_when_subscribing_is_false

data/lib/activity_notification/orm/mongoid.rb

@@ -72,5 +72,27 @@ module ActivityNotification
   end
 end
 
+# Monkey patching for Mongoid::Document as_json
+module Mongoid
+  # Monkey patching for Mongoid::Document as_json
+  module Document
+    # Monkey patching for Mongoid::Document as_json
+    # @param [Hash] options Options parameter
+    # @return [Hash] Hash representing the model
+    def as_json(options = {})
+      json = super(options)
+      json["id"] = json["_id"].to_s.start_with?("{\"$oid\"=>") ? self.id.to_s : json["_id"].to_s
+      if options.has_key?(:include)
+        case options[:include]
+        when Symbol then json[options[:include].to_s] = self.send(options[:include]).as_json
+        when Array  then options[:include].each {|model| json[model.to_s] = self.send(model).as_json }
+        when Hash   then options[:include].each {|model, options| json[model.to_s] = self.send(model).as_json(options) }
+        end
+      end
+      json
+    end
+  end
+end
+
 require_relative 'mongoid/notification.rb'
 require_relative 'mongoid/subscription.rb'

data/lib/activity_notification/orm/mongoid/notification.rb

@@ -143,6 +143,22 @@ module ActivityNotification
             any_of({ :group_id.exists => false, :group_type.exists => false }, { group_id: nil, group_type: nil })
         }
 
+        # Selects filtered notifications later than specified time.
+        # @example Get filtered unopened notificatons of the @user later than @notification
+        #   @notifications = @user.notifications.unopened_only.later_than(@notification.created_at)
+        # @scope class
+        # @param [Time] Created time of the notifications for filter
+        # @return [ActiveRecord_AssociationRelation<Notificaion>, Mongoid::Criteria<Notificaion>] Database query of filtered notifications
+        scope :later_than,                        ->(created_time) { where(:created_at.gt => created_time) }
+
+        # Selects filtered notifications earlier than specified time.
+        # @example Get filtered unopened notificatons of the @user earlier than @notification
+        #   @notifications = @user.notifications.unopened_only.earlier_than(@notification.created_at)
+        # @scope class
+        # @param [Time] Created time of the notifications for filter
+        # @return [ActiveRecord_AssociationRelation<Notificaion>, Mongoid::Criteria<Notificaion>] Database query of filtered notifications
+        scope :earlier_than,                      ->(created_time) { where(:created_at.lt => created_time) }
+
         # Includes target instance with query for notifications.
         # @return [Mongoid::Criteria<Notificaion>] Database query of notifications with target
         scope :with_target,                       -> { }
@@ -179,7 +195,7 @@ module ActivityNotification
 
         # Raise ActivityNotification::DeleteRestrictionError for notifications.
         # @param [String] error_text Error text for raised exception
-        # @raise ActivityNotification::DeleteRestrictionError
+        # @raise [ActivityNotification::DeleteRestrictionError] DeleteRestrictionError from used ORM
         # @return [void]
         def self.raise_delete_restriction_error(error_text)
           raise ActivityNotification::DeleteRestrictionError, error_text

data/lib/activity_notification/orm/mongoid/subscription.rb

@@ -28,7 +28,7 @@ module ActivityNotification
         field :optional_targets,          type: Hash,    default: {}
 
         validates  :target,               presence: true
-        validates  :key,                  presence: true
+        validates  :key,                  presence: true, uniqueness: { scope: :target }
         validates_inclusion_of :subscribing,          in: [true, false]
         validates_inclusion_of :subscribing_to_email, in: [true, false]
         validate   :subscribing_to_email_cannot_be_true_when_subscribing_is_false

data/lib/activity_notification/rails/routes.rb

@@ -23,7 +23,7 @@ module ActionDispatch::Routing
     #       { controller:"activity_notification/notifications", action:"open_all", target_type:"users" }
     #     move_user_notification      GET    /users/:user_id/notifications/:id/move(.:format)
     #       { controller:"activity_notification/notifications", action:"move", target_type:"users" }
-    #     open_user_notification      POST   /users/:user_id/notifications/:id/open(.:format)
+    #     open_user_notification      PUT    /users/:user_id/notifications/:id/open(.:format)
     #       { controller:"activity_notification/notifications", action:"open", target_type:"users" }
     #
     # You can also configure notification routes with scope like this:
@@ -42,7 +42,7 @@ module ActionDispatch::Routing
     #       { controller:"activity_notification/notifications", action:"open_all", target_type:"users", routing_scope: :myscope }
     #     move_myscope_user_notification      GET    /myscope/users/:user_id/notifications/:id/move(.:format)
     #       { controller:"activity_notification/notifications", action:"move", target_type:"users", routing_scope: :myscope }
-    #     open_myscope_user_notification      POST   /myscope/users/:user_id/notifications/:id/open(.:format)
+    #     open_myscope_user_notification      PUT    /myscope/users/:user_id/notifications/:id/open(.:format)
     #       { controller:"activity_notification/notifications", action:"open", target_type:"users", routing_scope: :myscope }
     #
     # When you use devise authentication and you want make notification targets assciated with devise,
@@ -60,7 +60,7 @@ module ActionDispatch::Routing
     #       { controller:"activity_notification/notifications_with_devise", action:"open_all", target_type:"users", devise_type:"users" }
     #     move_user_notification      GET    /users/:user_id/notifications/:id/move(.:format)
     #       { controller:"activity_notification/notifications_with_devise", action:"move", target_type:"users", devise_type:"users" }
-    #     open_user_notification      POST   /users/:user_id/notifications/:id/open(.:format)
+    #     open_user_notification      PUT    /users/:user_id/notifications/:id/open(.:format)
     #       { controller:"activity_notification/notifications_with_devise", action:"open", target_type:"users", devise_type:"users" }
     #
     # When you use with_devise option and you want to make simple default routes as follows, you can use devise_default_routes option:
@@ -77,9 +77,31 @@ module ActionDispatch::Routing
     #       { controller:"activity_notification/notifications_with_devise", action:"open_all", target_type:"users", devise_type:"users" }
     #     move_user_notification      GET    /notifications/:id/move(.:format)
     #       { controller:"activity_notification/notifications_with_devise", action:"move", target_type:"users", devise_type:"users" }
-    #     open_user_notification      POST   /notifications/:id/open(.:format)
+    #     open_user_notification      PUT    /notifications/:id/open(.:format)
     #       { controller:"activity_notification/notifications_with_devise", action:"open", target_type:"users", devise_type:"users" }
     #
+    # When you use activity_notification controllers as REST API mode,
+    # you can create as follows in your routes:
+    #   scope :api do
+    #     scope :"v2" do
+    #       notify_to :users, api_mode: true
+    #     end
+    #   end
+    # This api_mode option creates the needed routes as REST API:
+    #   # Notification as API mode routes
+    #     GET    /api/v2/users/:user_id/notifications(.:format)
+    #       { controller:"activity_notification/notifications_api", action:"index", target_type:"users" }
+    #     GET    /api/v2/users/:user_id/notifications/:id(.:format)
+    #       { controller:"activity_notification/notifications_api", action:"show", target_type:"users" }
+    #     DELETE /api/v2/users/:user_id/notifications/:id(.:format)
+    #       { controller:"activity_notification/notifications_api", action:"destroy", target_type:"users" }
+    #     POST   /api/v2/users/:user_id/notifications/open_all(.:format)
+    #       { controller:"activity_notification/notifications_api", action:"open_all", target_type:"users" }
+    #     GET    /api/v2/users/:user_id/notifications/:id/move(.:format)
+    #       { controller:"activity_notification/notifications_api", action:"move", target_type:"users" }
+    #     PUT    /api/v2/users/:user_id/notifications/:id/open(.:format)
+    #       { controller:"activity_notification/notifications_api", action:"open", target_type:"users" }
+    #
     # When you would like to define subscription management paths with notification paths,
     # you can create as follows in your routes:
     #   notify_to :users, with_subscription: true
@@ -102,12 +124,19 @@ module ActionDispatch::Routing
     #   scope :myscope, as: :myscope do
     #     notify_to :myscope, with_devise: :users, devise_default_routes: true, with_subscription: true, routing_scope: :myscope
     #   end
+    # @example Define notification paths as API mode including subscription paths
+    #   scope :api do
+    #     scope :"v2" do
+    #       notify_to :users, api_mode: true, with_subscription: true
+    #     end
+    #   end
     #
     # @overload notify_to(*resources, *options)
     #   @param          [Symbol]       resources Resources to notify
     #   @option options [String]       :routing_scope         (nil)            Routing scope for notification routes
     #   @option options [Symbol]       :with_devise           (false)          Devise resources name for devise integration. Devise integration will be enabled by this option.
     #   @option options [Boolean]      :devise_default_routes (false)          Whether you will create routes as device default routes assciated with authenticated devise resource as the default target
+    #   @option options [Boolean]      :api_mode              (false)          Whether you will use activity_notification controllers as REST API mode
     #   @option options [Hash|Boolean] :with_subscription     (false)          Subscription path options to define subscription management paths with notification paths. Calls subscribed_by routing when truthy value is passed as this option.
     #   @option options [String]       :model                 (:notifications) Model name of notifications
     #   @option options [String]       :controller            ("activity_notification/notifications" | activity_notification/notifications_with_devise") :controller option as resources routing
@@ -120,7 +149,7 @@ module ActionDispatch::Routing
 
       resources.each do |target|
         options[:defaults] = { target_type: target.to_s }.merge(options[:devise_defaults])
-        resources_options = options.select { |key, _| [:with_devise, :devise_default_routes, :with_subscription, :subscription_option, :model, :devise_defaults].exclude? key }
+        resources_options = options.select { |key, _| [:api_mode, :with_devise, :devise_default_routes, :with_subscription, :subscription_option, :model, :devise_defaults].exclude? key }
         if options[:with_devise].present? && options[:devise_default_routes].present?
           create_notification_routes options, resources_options
         else
@@ -146,23 +175,25 @@ module ActionDispatch::Routing
     #   # Subscription routes
     #     user_subscriptions                                GET    /users/:user_id/subscriptions(.:format)
     #       { controller:"activity_notification/subscriptions", action:"index", target_type:"users" }
+    #     find_user_subscriptions                           GET    /users/:user_id/subscriptions/find(.:format)
+    #       { controller:"activity_notification/subscriptions", action:"find", target_type:"users" }
     #     user_subscription                                 GET    /users/:user_id/subscriptions/:id(.:format)
     #       { controller:"activity_notification/subscriptions", action:"show", target_type:"users" }
-    #     open_all_user_subscriptions                       POST   /users/:user_id/subscriptions(.:format)
+    #                                                       PUT    /users/:user_id/subscriptions(.:format)
     #       { controller:"activity_notification/subscriptions", action:"create", target_type:"users" }
-    #     user_subscription                                 DELETE /users/:user_id/subscriptions/:id(.:format)
+    #                                                       DELETE /users/:user_id/subscriptions/:id(.:format)
     #       { controller:"activity_notification/subscriptions", action:"destroy", target_type:"users" }
-    #     subscribe_user_subscription                       POST   /users/:user_id/subscriptions/:id/subscribe(.:format)
+    #     subscribe_user_subscription                       PUT    /users/:user_id/subscriptions/:id/subscribe(.:format)
     #       { controller:"activity_notification/subscriptions", action:"subscribe", target_type:"users" }
-    #     unsubscribe_user_subscription                     POST   /users/:user_id/subscriptions/:id/unsubscribe(.:format)
+    #     unsubscribe_user_subscription                     PUT    /users/:user_id/subscriptions/:id/unsubscribe(.:format)
     #       { controller:"activity_notification/subscriptions", action:"unsubscribe", target_type:"users" }
-    #     subscribe_to_email_user_subscription              POST   /users/:user_id/subscriptions/:id/subscribe_to_email(.:format)
+    #     subscribe_to_email_user_subscription              PUT    /users/:user_id/subscriptions/:id/subscribe_to_email(.:format)
     #       { controller:"activity_notification/subscriptions", action:"subscribe_to_email", target_type:"users" }
-    #     unsubscribe_to_email_user_subscription            POST   /users/:user_id/subscriptions/:id/unsubscribe_to_email(.:format)
+    #     unsubscribe_to_email_user_subscription            PUT    /users/:user_id/subscriptions/:id/unsubscribe_to_email(.:format)
     #       { controller:"activity_notification/subscriptions", action:"unsubscribe_to_email", target_type:"users" }
-    #     subscribe_to_optional_target_user_subscription    POST   /users/:user_id/subscriptions/:id/subscribe_to_optional_target(.:format)
+    #     subscribe_to_optional_target_user_subscription    PUT    /users/:user_id/subscriptions/:id/subscribe_to_optional_target(.:format)
     #       { controller:"activity_notification/subscriptions", action:"subscribe_to_optional_target", target_type:"users" }
-    #     unsubscribe_to_optional_target_user_subscription  POST   /users/:user_id/subscriptions/:id/unsubscribe_to_optional_target(.:format)
+    #     unsubscribe_to_optional_target_user_subscription  PUT    /users/:user_id/subscriptions/:id/unsubscribe_to_optional_target(.:format)
     #       { controller:"activity_notification/subscriptions", action:"unsubscribe_to_optional_target", target_type:"users" }
     #
     # You can also configure notification routes with scope like this:
@@ -173,23 +204,25 @@ module ActionDispatch::Routing
     #   # Subscription routes
     #     myscope_user_subscriptions                                GET    /myscope/users/:user_id/subscriptions(.:format)
     #       { controller:"activity_notification/subscriptions", action:"index", target_type:"users", routing_scope: :myscope }
+    #     find_myscope_user_subscriptions                           GET    /myscope/users/:user_id/subscriptions/find(.:format)
+    #       { controller:"activity_notification/subscriptions", action:"find", target_type:"users", routing_scope: :myscope }
     #     myscope_user_subscription                                 GET    /myscope/users/:user_id/subscriptions/:id(.:format)
     #       { controller:"activity_notification/subscriptions", action:"show", target_type:"users", routing_scope: :myscope }
-    #     open_all_myscope_user_subscriptions                       POST   /myscope/users/:user_id/subscriptions(.:format)
+    #                                                               PUT    /myscope/users/:user_id/subscriptions(.:format)
     #       { controller:"activity_notification/subscriptions", action:"create", target_type:"users", routing_scope: :myscope }
-    #     myscope_user_subscription                                 DELETE /myscope/users/:user_id/subscriptions/:id(.:format)
+    #                                                               DELETE /myscope/users/:user_id/subscriptions/:id(.:format)
     #       { controller:"activity_notification/subscriptions", action:"destroy", target_type:"users", routing_scope: :myscope }
-    #     subscribe_myscope_user_subscription                       POST   /myscope/users/:user_id/subscriptions/:id/subscribe(.:format)
+    #     subscribe_myscope_user_subscription                       PUT    /myscope/users/:user_id/subscriptions/:id/subscribe(.:format)
     #       { controller:"activity_notification/subscriptions", action:"subscribe", target_type:"users", routing_scope: :myscope }
-    #     unsubscribe_myscope_user_subscription                     POST   /myscope/users/:user_id/subscriptions/:id/unsubscribe(.:format)
+    #     unsubscribe_myscope_user_subscription                     PUT    /myscope/users/:user_id/subscriptions/:id/unsubscribe(.:format)
     #       { controller:"activity_notification/subscriptions", action:"unsubscribe", target_type:"users", routing_scope: :myscope }
-    #     subscribe_to_email_myscope_user_subscription              POST   /myscope/users/:user_id/subscriptions/:id/subscribe_to_email(.:format)
+    #     subscribe_to_email_myscope_user_subscription              PUT    /myscope/users/:user_id/subscriptions/:id/subscribe_to_email(.:format)
     #       { controller:"activity_notification/subscriptions", action:"subscribe_to_email", target_type:"users", routing_scope: :myscope }
-    #     unsubscribe_to_email_myscope_user_subscription            POST   /myscope/users/:user_id/subscriptions/:id/unsubscribe_to_email(.:format)
+    #     unsubscribe_to_email_myscope_user_subscription            PUT    /myscope/users/:user_id/subscriptions/:id/unsubscribe_to_email(.:format)
     #       { controller:"activity_notification/subscriptions", action:"unsubscribe_to_email", target_type:"users", routing_scope: :myscope }
-    #     subscribe_to_optional_target_myscope_user_subscription    POST   /myscope/users/:user_id/subscriptions/:id/subscribe_to_optional_target(.:format)
+    #     subscribe_to_optional_target_myscope_user_subscription    PUT    /myscope/users/:user_id/subscriptions/:id/subscribe_to_optional_target(.:format)
     #       { controller:"activity_notification/subscriptions", action:"subscribe_to_optional_target", target_type:"users", routing_scope: :myscope }
-    #     unsubscribe_to_optional_target_myscope_user_subscription  POST   /myscope/users/:user_id/subscriptions/:id/unsubscribe_to_optional_target(.:format)
+    #     unsubscribe_to_optional_target_myscope_user_subscription  PUT    /myscope/users/:user_id/subscriptions/:id/unsubscribe_to_optional_target(.:format)
     #       { controller:"activity_notification/subscriptions", action:"unsubscribe_to_optional_target", target_type:"users", routing_scope: :myscope }
     #
     # When you use devise authentication and you want make subscription targets assciated with devise,
@@ -199,23 +232,25 @@ module ActionDispatch::Routing
     #   # Subscription with devise routes
     #     user_subscriptions                                GET    /users/:user_id/subscriptions(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"index", target_type:"users", devise_type:"users" }
+    #     find_user_subscriptions                           GET    /users/:user_id/subscriptions/find(.:format)
+    #       { controller:"activity_notification/subscriptions_with_devise", action:"find", target_type:"users", devise_type:"users" }
     #     user_subscription                                 GET    /users/:user_id/subscriptions/:id(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"show", target_type:"users", devise_type:"users" }
-    #     open_all_user_subscriptions                       POST   /users/:user_id/subscriptions(.:format)
+    #                                                       PUT    /users/:user_id/subscriptions(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"create", target_type:"users", devise_type:"users" }
-    #     user_subscription                                 DELETE /users/:user_id/subscriptions/:id(.:format)
+    #                                                       DELETE /users/:user_id/subscriptions/:id(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"destroy", target_type:"users", devise_type:"users" }
-    #     subscribe_user_subscription                       POST   /users/:user_id/subscriptions/:id/subscribe(.:format)
+    #     subscribe_user_subscription                       PUT    /users/:user_id/subscriptions/:id/subscribe(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"subscribe", target_type:"users", devise_type:"users" }
-    #     unsubscribe_user_subscription                     POST   /users/:user_id/subscriptions/:id/unsubscribe(.:format)
+    #     unsubscribe_user_subscription                     PUT    /users/:user_id/subscriptions/:id/unsubscribe(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"unsubscribe", target_type:"users", devise_type:"users" }
-    #     subscribe_to_email_user_subscription              POST   /users/:user_id/subscriptions/:id/subscribe_to_email(.:format)
+    #     subscribe_to_email_user_subscription              PUT    /users/:user_id/subscriptions/:id/subscribe_to_email(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"subscribe_to_email", target_type:"users", devise_type:"users" }
-    #     unsubscribe_to_email_user_subscription            POST   /users/:user_id/subscriptions/:id/unsubscribe_to_email(.:format)
+    #     unsubscribe_to_email_user_subscription            PUT    /users/:user_id/subscriptions/:id/unsubscribe_to_email(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"unsubscribe_to_email", target_type:"users", devise_type:"users" }
-    #     subscribe_to_optional_target_user_subscription    POST   /users/:user_id/subscriptions/:id/subscribe_to_optional_target(.:format)
+    #     subscribe_to_optional_target_user_subscription    PUT    /users/:user_id/subscriptions/:id/subscribe_to_optional_target(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"subscribe_to_optional_target", target_type:"users", devise_type:"users" }
-    #     unsubscribe_to_optional_target_user_subscription  POST   /users/:user_id/subscriptions/:id/unsubscribe_to_optional_target(.:format)
+    #     unsubscribe_to_optional_target_user_subscription  PUT    /users/:user_id/subscriptions/:id/unsubscribe_to_optional_target(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"unsubscribe_to_optional_target", target_type:"users", devise_type:"users" }
     #
     # When you use with_devise option and you want to make simple default routes as follows, you can use devise_default_routes option:
@@ -224,37 +259,80 @@ module ActionDispatch::Routing
     #   # Subscription with devise routes
     #     user_subscriptions                                GET    /subscriptions(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"index", target_type:"users", devise_type:"users" }
+    #     find_user_subscriptions                           GET    /subscriptions/find(.:format)
+    #       { controller:"activity_notification/subscriptions_with_devise", action:"find", target_type:"users", devise_type:"users" }
     #     user_subscription                                 GET    /subscriptions/:id(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"show", target_type:"users", devise_type:"users" }
-    #     open_all_user_subscriptions                       POST   /subscriptions(.:format)
+    #                                                       PUT    /subscriptions(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"create", target_type:"users", devise_type:"users" }
-    #     user_subscription                                 DELETE /subscriptions/:id(.:format)
+    #                                                       DELETE /subscriptions/:id(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"destroy", target_type:"users", devise_type:"users" }
-    #     subscribe_user_subscription                       POST   /subscriptions/:id/subscribe(.:format)
+    #     subscribe_user_subscription                       PUT    /subscriptions/:id/subscribe(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"subscribe", target_type:"users", devise_type:"users" }
-    #     unsubscribe_user_subscription                     POST   /subscriptions/:id/unsubscribe(.:format)
+    #     unsubscribe_user_subscription                     PUT    /subscriptions/:id/unsubscribe(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"unsubscribe", target_type:"users", devise_type:"users" }
-    #     subscribe_to_email_user_subscription              POST   /subscriptions/:id/subscribe_to_email(.:format)
+    #     subscribe_to_email_user_subscription              PUT    /subscriptions/:id/subscribe_to_email(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"subscribe_to_email", target_type:"users", devise_type:"users" }
-    #     unsubscribe_to_email_user_subscription            POST   /subscriptions/:id/unsubscribe_to_email(.:format)
+    #     unsubscribe_to_email_user_subscription            PUT    /subscriptions/:id/unsubscribe_to_email(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"unsubscribe_to_email", target_type:"users", devise_type:"users" }
-    #     subscribe_to_optional_target_user_subscription    POST   /subscriptions/:id/subscribe_to_optional_target(.:format)
+    #     subscribe_to_optional_target_user_subscription    PUT    /subscriptions/:id/subscribe_to_optional_target(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"subscribe_to_optional_target", target_type:"users", devise_type:"users" }
-    #     unsubscribe_to_optional_target_user_subscription  POST   /subscriptions/:id/unsubscribe_to_optional_target(.:format)
+    #     unsubscribe_to_optional_target_user_subscription  PUT    /subscriptions/:id/unsubscribe_to_optional_target(.:format)
     #       { controller:"activity_notification/subscriptions_with_devise", action:"unsubscribe_to_optional_target", target_type:"users", devise_type:"users" }
     #
+    # When you use activity_notification controllers as REST API mode,
+    # you can create as follows in your routes:
+    #   scope :api do
+    #     scope :"v2" do
+    #       subscribed_by :users, api_mode: true
+    #     end
+    #   end
+    # This api_mode option creates the needed routes as REST API:
+    #   # Subscription as API mode routes
+    #     GET    /subscriptions(.:format)
+    #       { controller:"activity_notification/subscriptions_api", action:"index", target_type:"users" }
+    #     GET    /subscriptions/find(.:format)
+    #       { controller:"activity_notification/subscriptions_api", action:"find", target_type:"users" }
+    #     GET    /subscriptions/optional_target_names(.:format)
+    #       { controller:"activity_notification/subscriptions_api", action:"optional_target_names", target_type:"users" }
+    #     GET    /subscriptions/:id(.:format)
+    #       { controller:"activity_notification/subscriptions_api", action:"show", target_type:"users" }
+    #     PUT    /subscriptions(.:format)
+    #       { controller:"activity_notification/subscriptions_api", action:"create", target_type:"users" }
+    #     DELETE /subscriptions/:id(.:format)
+    #       { controller:"activity_notification/subscriptions_api", action:"destroy", target_type:"users" }
+    #     PUT    /subscriptions/:id/subscribe(.:format)
+    #       { controller:"activity_notification/subscriptions_api", action:"subscribe", target_type:"users" }
+    #     PUT    /subscriptions/:id/unsubscribe(.:format)
+    #       { controller:"activity_notification/subscriptions_api", action:"unsubscribe", target_type:"users" }
+    #     PUT    /subscriptions/:id/subscribe_to_email(.:format)
+    #       { controller:"activity_notification/subscriptions_api", action:"subscribe_to_email", target_type:"users" }
+    #     PUT    /subscriptions/:id/unsubscribe_to_email(.:format)
+    #       { controller:"activity_notification/subscriptions_api", action:"unsubscribe_to_email", target_type:"users" }
+    #     PUT    /subscriptions/:id/subscribe_to_optional_target(.:format)
+    #       { controller:"activity_notification/subscriptions_api", action:"subscribe_to_optional_target", target_type:"users" }
+    #     PUT    /subscriptions/:id/unsubscribe_to_optional_target(.:format)
+    #       { controller:"activity_notification/subscriptions_api", action:"unsubscribe_to_optional_target", target_type:"users" }
+    #
     # @example Define subscribed_by in config/routes.rb
     #   subscribed_by :users
     # @example Define subscribed_by with options
     #   subscribed_by :users, except: [:index, :show]
     # @example Integrated with Devise authentication
     #   subscribed_by :users, with_devise: :users
+    # @example Define subscription paths as API mode
+    #   scope :api do
+    #     scope :"v2" do
+    #       subscribed_by :users, api_mode: true
+    #     end
+    #   end
     #
     # @overload subscribed_by(*resources, *options)
     #   @param          [Symbol]       resources Resources to notify
     #   @option options [String]       :routing_scope         (nil)            Routing scope for subscription routes
     #   @option options [Symbol]       :with_devise           (false)          Devise resources name for devise integration. Devise integration will be enabled by this option.
     #   @option options [Boolean]      :devise_default_routes (false)          Whether you will create routes as device default routes assciated with authenticated devise resource as the default target
+    #   @option options [Boolean]      :api_mode              (false)          Whether you will use activity_notification controllers as REST API mode
     #   @option options [String]       :model                 (:subscriptions) Model name of subscriptions
     #   @option options [String]       :controller            ("activity_notification/subscriptions" | activity_notification/subscriptions_with_devise") :controller option as resources routing
     #   @option options [Symbol]       :as                    (nil)            :as option as resources routing
@@ -266,7 +344,7 @@ module ActionDispatch::Routing
 
       resources.each do |target|
         options[:defaults] = { target_type: target.to_s }.merge(options[:devise_defaults])
-        resources_options = options.select { |key, _| [:with_devise, :devise_default_routes, :model, :devise_defaults].exclude? key }
+        resources_options = options.select { |key, _| [:api_mode, :with_devise, :devise_default_routes, :model, :devise_defaults].exclude? key }
         if options[:with_devise].present? && options[:devise_default_routes].present?
           create_subscription_routes options, resources_options
         else
@@ -305,20 +383,22 @@ module ActionDispatch::Routing
         # Check resources if it includes target module
         resources_name = resource.to_s.pluralize.underscore
         options[:model] ||= resources_name.to_sym
+        controller_name = "activity_notification/#{resources_name}"
+        controller_name.concat("_api") if options[:api_mode]
         if options[:with_devise].present?
-          options[:controller] ||= "activity_notification/#{resources_name}_with_devise"
+          options[:controller] ||= "#{controller_name}_with_devise"
           options[:as]         ||= resources_name
           # Check devise configuration in model
           options[:devise_defaults] = { devise_type: options[:with_devise].to_s }
           options[:devise_defaults] = options[:devise_defaults].merge(options.slice(:devise_default_routes))
         else
-          options[:controller] ||= "activity_notification/#{resources_name}"
+          options[:controller] ||= controller_name
           options[:devise_defaults] = {}
         end
         (options[:except] ||= []).concat(except_actions)
         if options[:with_subscription].present?
           options[:subscription_option] = (options[:with_subscription].is_a?(Hash) ? options[:with_subscription] : {})
-                                            .merge(options.slice(:with_devise, :devise_default_routes, :routing_scope))
+                                            .merge(options.slice(:api_mode, :with_devise, :devise_default_routes, :routing_scope))
         end
         # Support other options like :as, :path_prefix, :path_names ...
         options
@@ -337,7 +417,7 @@ module ActionDispatch::Routing
           end
           member do
             get  :move     unless ignore_path?(:move, options)
-            post :open     unless ignore_path?(:open, options)
+            put  :open     unless ignore_path?(:open, options)
           end
         end
       end
@@ -350,13 +430,17 @@ module ActionDispatch::Routing
       # @param [Hash] resources_options Options to send resources method
       def create_subscription_routes(options = {}, resources_options = [])
         self.resources options[:model], resources_options do
+          collection do
+            get :find                           unless ignore_path?(:find, options)
+            get :optional_target_names          if options[:api_mode] && !ignore_path?(:optional_target_names, options)
+          end
           member do
-            post :subscribe                      unless ignore_path?(:subscribe, options)
-            post :unsubscribe                    unless ignore_path?(:unsubscribe, options)
-            post :subscribe_to_email             unless ignore_path?(:subscribe_to_email, options)
-            post :unsubscribe_to_email           unless ignore_path?(:unsubscribe_to_email, options)
-            post :subscribe_to_optional_target   unless ignore_path?(:subscribe_to_optional_target, options)
-            post :unsubscribe_to_optional_target unless ignore_path?(:unsubscribe_to_optional_target, options)
+            put :subscribe                      unless ignore_path?(:subscribe, options)
+            put :unsubscribe                    unless ignore_path?(:unsubscribe, options)
+            put :subscribe_to_email             unless ignore_path?(:subscribe_to_email, options)
+            put :unsubscribe_to_email           unless ignore_path?(:unsubscribe_to_email, options)
+            put :subscribe_to_optional_target   unless ignore_path?(:subscribe_to_optional_target, options)
+            put :unsubscribe_to_optional_target unless ignore_path?(:unsubscribe_to_optional_target, options)
           end
         end
       end