core_merchant 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2bd7b45750d9491ddf78c12b41e73a1d79d8bc6fa5cdff69df22f536b1765e42
-  data.tar.gz: 056e3021e60c7c5edb4a301dae4a29b6184ad3889b55c81e226dccfcfcb00020
+  metadata.gz: ff6bdd381d58ecdb8153a14ceff12482d22b55b70a738de1e46df9480f3ab472
+  data.tar.gz: a87c17013865cdbe94f70daf969624f494135955568c0662e86cfe41463a6d88
 SHA512:
-  metadata.gz: f916fe4fb53d28a9fbb61c8d7306825cb96d82ceeb559a6aeea1373c83e5401c785c0400dd3b41f0d5f9a4c321f0cc91c85eddead5808d546c7fb09d6b671aa7
-  data.tar.gz: 218935fdbb73a113262735e5b4a0290d7942121b167932ad00a5ead4c1a75ef69d8f18dfffca5fea14aafbbb8bf79f6cb940042f15f0989a59ce1e6c14a58208
+  metadata.gz: 044f0541c54678616eff01372b20b54e4a2bfd3f3d087ba276dc749ce06bc550f6bb047ba90bad084d1edb04f1600774cf5dd681fb56b4c91ef0c8530dbcfa38
+  data.tar.gz: f471e4c215f2d9f36944621e9bb067f9fcde0a6f67d72ee9b6e1cc6a3a2aeb507dd93cdc110bdaf9058be19c7cb700062932609ce9f10437bb5c813c75f0ed82

data/README.md

@@ -10,11 +10,33 @@ CoreMerchant is a library for customer, product, and subscription management in
 - [X] Add initializer generator
 - [X] Add SubscriptionPlan model
 - [X] Add Subscription model
-- [ ] Implement subscription manager and callbacks
+- [X] Implement subscription manager and callbacks
 - [ ] Add sidekiq jobs for subscription management
 - [ ] Add Invoice model
 - [ ] Add billing and invoicing service
 
+## Table of contents
+- [CoreMerchant](#coremerchant)
+  - [To-dos until 1.0.0 release](#to-dos-until-100-release)
+  - [Table of contents](#table-of-contents)
+  - [Installation](#installation)
+  - [Usage](#usage)
+    - [Initialization](#initialization)
+    - [Configuration](#configuration)
+      - [1. Customer class](#1-customer-class)
+      - [2. Subscription listener class](#2-subscription-listener-class)
+    - [Subscription management](#subscription-management)
+      - [Creating a subscription plan](#creating-a-subscription-plan)
+      - [Creating a subscription](#creating-a-subscription)
+      - [Cancelling a subscription](#cancelling-a-subscription)
+      - [Handling subscription events](#handling-subscription-events)
+  - [Models](#models)
+    - [SubscriptionManager](#subscriptionmanager)
+    - [SubscriptionPlan](#subscriptionplan)
+    - [Subscription](#subscription)
+  - [Contributing](#contributing)
+
+
 ## Installation
 Add this line to your application's Gemfile:
 ```
@@ -31,14 +53,14 @@ $ gem install core_merchant
 ### Initialization
 Run the generator to create the initializer file and the migrations:
 ```
-$ rails generate core_merchant:install --customer_class=User
+$ rails generate core_merchant:install
 ```
-`--customer_class` option is required and should be the name of the model that represents the customer in your application. For example, if you already have a `User` model that represents the users of your application, you can use it as the customer class in CoreMerchant.
 
 This will create the following files:
 - `config/initializers/core_merchant.rb` - Configuration file
+- `config/locales/core_merchant.en.yml` - English translations for core merchant models
 - `db/migrate/xxxxxx_create_core_merchant_subscription_plans.rb` - Migration for subscription plans
-
+- `db/migrate/xxxxxx_create_core_merchant_subscriptions.rb` - Migration for subscriptions
 You can then run the migrations:
 ```
 $ rails db:migrate
@@ -46,11 +68,13 @@ $ rails db:migrate
 
 ### Configuration
 The initializer file `config/initializers/core_merchant.rb` contains the following configuration options:
+
+#### 1. Customer class
 ```ruby
 config.customer_class = 'User'
 ```
 
-You need to include the `CoreMerchant::Customer` module in the customer class:
+This is the class that includes the `CoreMerchant::Customer` module. It should be the model class that represents your customers. For example, if you have a `User` model that represents your customers, you can include the `CoreMerchant::Customer` module in the `User` class:
 ```ruby
 # app/models/user.rb
 class User < ApplicationRecord
@@ -60,9 +84,127 @@ class User < ApplicationRecord
 end
 ```
 
+#### 2. Subscription listener class
+```ruby
+config.subscription_listener_class = 'MySubscriptionListener'
+```
+This is the class that will receive subscription events. It should include the `CoreMerchant::SubscriptionListener` module and implement event handlers for the subscription events. Some examples:
+```ruby
+class MySubscriptionListener
+  include CoreMerchant::SubscriptionListener
+
+  def on_test_event_received
+    puts 'Test event received, hooray!'
+  end
+end
+```
+
+More about subscription events in the [Handling subscription events](#handling-subscription-events) section.
+
+### Subscription management
+
+#### Creating a subscription plan
+You can create a subscription plan using the `SubscriptionPlan` model:
+```ruby
+CoreMerchant::SubscriptionPlan.create(name_key: 'basic', price_cents: 10_00, duration: '1m')
+```
+
+#### Creating a subscription
+You can create a subscription for a customer using the `Subscription` model:
+```ruby
+customer = User.find(1)
+plan = CoreMerchant::SubscriptionPlan.find_by(name_key: 'basic')
+subscription = CoreMerchant::Subscription.create(customer: customer, plan: plan)
+```
+
+Note that the subscription will not be active until you start it:
+```ruby
+subscription.start
+```
+
+#### Cancelling a subscription
+You can cancel a subscription by calling the `cancel` method. You can also specify a reason for the cancellation and whether the cancellation should take effect immediately or at the end of the current billing period:
+```ruby
+subscription.cancel(reason: 'Customer request', at_period_end: false)
+```
+
+#### Handling subscription events
+You can handle subscription events by implementing event handlers in the subscription listener class. For example, you can send an email to the customer when a subscription is created:
+```ruby
+class MySubscriptionListener
+  include CoreMerchant::SubscriptionListener
+
+  
+  def on_subscription_created(subscription)
+    FakeEmailService.send_email(subscription.customer.email, "We're happy to have you on board!")
+
+    # You can also start the subscription automatically
+    subscription.start
+  end
+
+  def on_subscription_started(subscription)
+    FakeEmailService.send_email(subscription.customer.email, "Your subscription has started!")
+  end
+
+  def on_subscription_due_for_renewal(subscription)
+    success = FakePaymentService.charge(subscription.customer, subscription.plan.price_cents)
+
+    if success
+      CoreMerchant.subscription_manager.payment_successful_for_renewal(subscription)
+    else
+      FakeEmailService.send_email(subscription.customer.email, "Payment failed, please update your payment method.")
+      CoreMerchant.subscription_manager.payment_failed_for_renewal(subscription)
+    end
+  end
+
+  def on_subscription_renewed(subscription)
+    FakeEmailService.send_email(subscription.customer.email, "Your subscription has been renewed until #{subscription.current_period_end_date}")
+  end
+end
+```
+
+Available subscription events:
+- `on_subscription_created(subscription)`
+- `on_subscription_destroyed(subscription)`
+- `on_subscription_started(subscription)`
+- `on_subscription_canceled(subscription, reason:, at_period_end:)`
+- `on_subscription_due_for_renewal(subscription)`
+- `on_subscription_renewed(subscription)`
+- `on_subscription_renewal_payment_processing(subscription)`
+- `on_subscription_grace_period_started(subscription, days_remaining:)`
+
 ## Models
+### SubscriptionManager
+Access from `CoreMerchant.subscription_manager`. The `SubscriptionManager` class is responsible for managing subscriptions. It is responsible for notifying listeners when subscription events occur and checking for and handling renewals.
+
+**Attributes**:
+  - `listeners` - An array of listeners that will be notified when subscription events occur.
+
+**Methods**:
+- `check_subscriptions` - Checks all subscriptions for renewals
+- `add_listener(listener)` - Adds a listener to the list of listeners
+- `no_payment_needed_for_renewal(subscription)` - Handles the case where no payment is needed for a renewal.
+  Call when a subscription is renewed without payment.
+- `processing_payment_for_renewal(subscription)` - Handles the case where payment is being processed for a renewal.
+  Call when payment is being processed for a renewal.
+- `payment_successful_for_renewal(subscription)` - Handles the case where payment was successful for a renewal.
+  Call when payment was successful for a renewal.
+- `payment_failed_for_renewal(subscription)` - Handles the case where payment failed for a renewal.
+  Call when payment failed for a renewal.
+
+**Usage**:
+```ruby
+manager = CoreMerchant.subscription_manager
+manager.check_subscriptions
+# ... somewhere else in the code ...
+manager.payment_successful_for_renewal(subscription1)
+manager.payment_failed_for_renewal(subscription2)
+```
+
 ### SubscriptionPlan
-The `SubscriptionPlan` model represents a subscription plan in your application. It has the following attributes:
+The `SubscriptionPlan` model represents a subscription plan in your application. Subscription plans are used to define the pricing and features of a subscription. All prices are in cents.
+
+**Attributes**:
 - `name_key`: A unique key for the subscription plan.
             This key is used to identify the plan in the application,
             as well as the translation key for the plan name through `core_merchant.subscription_plans`.
@@ -73,6 +215,62 @@ The `SubscriptionPlan` model represents a subscription plan in your application.
 - `introductory_price_cents`: The introductory price of the subscription plan in cents.
 - `introductory_duration`: The duration of the introductory price of the subscription plan.
 
+**Usage**:
+``` ruby
+  plan = CoreMerchant::SubscriptionPlan.new(name_key: "basic_monthly", price_cents: 7_99)
+  plan.save
+```
+### Subscription
+Represents a subscription in CoreMerchant.
+This class manages the lifecycle of a customer's subscription to a specific plan.
+
+**Subscriptions can transition through various statuses**:
+- `pending`: Subscription created but not yet started
+- `trial`: In a trial period
+- `active`: Currently active and paid
+- `past_due`: Payment failed but in grace period
+- `pending_cancellation`: Will be canceled at period end
+- `processing_renewal`: Renewal in progress
+- `processing_payment`: Payment processing
+- `canceled`: Canceled by user or due to payment failure
+- `expired`: Subscription period ended
+- `paused`: Temporarily halted, not yet implemented
+- `pending_change`: Plan change scheduled for next renewal, not yet implemented
+
+**Key features**:
+- Supports immediate and end-of-period cancellations
+- Allows plan changes, effective immediately or at next renewal
+- Handles subscription pausing and resuming
+- Manages trial periods
+- Supports variable pricing for renewals
+
+**Attributes**:
+- `customer`: Polymorphic association to the customer
+- `subscription_plan`: The current plan for this subscription
+- `status`: Current status of the subscription (see enum definition)
+- `start_date`: When the subscription started
+- `end_date`: When the subscription ended (or will end)
+- `trial_end_date`: End date of the trial period (if applicable)
+- `canceled_at`: When the subscription was canceled
+- `current_period_start`: Start of the current billing period
+- `current_period_end`: End of the current billing period
+- `pause_start_date`: When the subscription was paused
+- `pause_end_date`: When the paused subscription will resume
+- `current_period_price_cents`: Price for the current period
+- `next_renewal_price_cents`: Price for the next renewal (if different from plan)
+- `cancellation_reason`: Reason for cancellation (if applicable)
+
+**Methods**:
+- `start` - Starts the subscription
+- `cancel(reason:, at_period_end:)` - Cancels the subscription, optionally at the end of the current period
+
+**Usage**:
+```ruby
+subscription = CoreMerchant::Subscription.create(customer: user, subscription_plan: plan, status: :active)
+subscription.start
+subscription.cancel(reason: "Too expensive", at_period_end: true)
+```
+
 > [!NOTE]
 > Other models and features are being developed and will be added in future releases.
 

data/lib/core_merchant/concerns/subscription_manager_notifications.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module CoreMerchant
+  module Concerns
+    # Includes logic for notifying listeners of subscription events.
+    module SubscriptionManagerNotifications
+      extend ActiveSupport::Concern
+
+      included do # rubocop:disable Metrics/BlockLength
+        def notify(subscription, event, **options) # rubocop:disable Metrics/CyclomaticComplexity,Metrics/MethodLength
+          case event
+          when :created
+            notify_subscription_created(subscription)
+          when :destroyed
+            notify_subscription_destroyed(subscription)
+          when :started
+            notify_subscription_started(subscription)
+          when :canceled
+            notify_subscription_canceled(subscription, options[:reason], options[:immediate])
+          when :due_for_renewal
+            notify_subscription_due_for_renewal(subscription)
+          when :renewed
+            notify_subscription_renewed(subscription)
+          when :renewal_payment_processing
+            notify_subscription_renewal_payment_processing(subscription)
+          when :grace_period_started
+            notify_subscription_grace_period_started(subscription, options[:days_remaining])
+          when :expired
+            notify_subscription_expired(subscription)
+          end
+        end
+
+        def notify_test_event
+          send_notification_to_listeners(nil, :on_test_event_received)
+        end
+
+        private
+
+        def notify_subscription_created(subscription)
+          send_notification_to_listeners(subscription, :on_subscription_created)
+        end
+
+        def notify_subscription_destroyed(subscription)
+          send_notification_to_listeners(subscription, :on_subscription_destroyed)
+        end
+
+        def notify_subscription_started(subscription)
+          send_notification_to_listeners(subscription, :on_subscription_started)
+        end
+
+        def notify_subscription_canceled(subscription, reason, immediate)
+          send_notification_to_listeners(subscription, :on_subscription_canceled, reason: reason, immediate: immediate)
+        end
+
+        def notify_subscription_due_for_renewal(subscription)
+          send_notification_to_listeners(subscription, :on_subscription_due_for_renewal)
+        end
+
+        def notify_subscription_renewed(subscription)
+          send_notification_to_listeners(subscription, :on_subscription_renewed)
+        end
+
+        def notify_subscription_renewal_payment_processing(subscription)
+          send_notification_to_listeners(subscription, :on_subscription_renewal_payment_processing)
+        end
+
+        def notify_subscription_expired(subscription)
+          send_notification_to_listeners(subscription, :on_subscription_expired)
+        end
+
+        def notify_subscription_grace_period_started(subscription, days_remaining)
+          send_notification_to_listeners(
+            subscription, :on_subscription_grace_period_started,
+            days_remaining: days_remaining
+          )
+        end
+      end
+    end
+  end
+end

data/lib/core_merchant/subscription.rb

@@ -46,13 +46,10 @@ module CoreMerchant
   # **Usage**:
   #  ```ruby
   #   subscription = CoreMerchant::Subscription.create(customer: user, subscription_plan: plan, status: :active)
+  #   subscription.start
   #   subscription.cancel(reason: "Too expensive", at_period_end: true)
-  #   subscription.change_plan(new_plan, at_period_end: false)
-  #   subscription.pause(until_date: 1.month.from_now)
-  #   subscription.resume
-  #   subscription.renew(price_cents: 1999)
   #   ```
-  class Subscription < ActiveRecord::Base
+  class Subscription < ActiveRecord::Base # rubocop:disable Metrics/ClassLength
     include CoreMerchant::Concerns::SubscriptionStateMachine
     include CoreMerchant::Concerns::SubscriptionNotifications
 
@@ -80,6 +77,12 @@ module CoreMerchant
     validate :end_date_after_start_date, if: :end_date
     validate :canceled_at_with_reason, if: :canceled_at
 
+    scope :due_for_renewal,
+          lambda {
+            where(status: %i[active trial past_due processing_renewal processing_payment])
+              .where("current_period_end <= ?", Time.current)
+          }
+
     # Starts the subscription.
     # Sets the current period start and end dates based on the plan's duration.
     def start
@@ -89,8 +92,8 @@ module CoreMerchant
       transaction do
         transition_to_active!
         update!(
-          current_period_start: new_period_start,
-          current_period_end: new_period_end
+          current_period_start: new_period_start.to_date,
+          current_period_end: new_period_end.to_date
         )
       end
 
@@ -119,6 +122,18 @@ module CoreMerchant
       notify_subscription_manager(:canceled, reason: reason, immediate: !at_period_end)
     end
 
+    # Starts a new period for the subscription.
+    # This is called by SubscriptionManager when a subscription renewal is successful.
+    def start_new_period
+      new_period_start = current_period_end
+      new_period_end = new_period_start + subscription_plan.duration_in_date
+
+      update!(
+        current_period_start: new_period_start.to_date,
+        current_period_end: new_period_end.to_date
+      )
+    end
+
     # Returns the days remaining in the current period.
     # Use to show the user how many days are left before the next renewal or
     # to refund pro-rated amounts for early cancellations.
@@ -151,8 +166,23 @@ module CoreMerchant
     end
 
     def due_for_renewal?
-      (active? || trial? || past_due? || processing_renewal? || processing_payment?) &&
-        current_period_end <= Time.current
+      renewable? && current_period_end <= Time.current
+    end
+
+    def expired_or_canceled?
+      expired? || canceled?
+    end
+
+    def processing?
+      processing_renewal? || processing_payment?
+    end
+
+    def ongoing?
+      active? || trial? || past_due? || processing_renewal? || processing_payment? || pending_cancellation?
+    end
+
+    def renewable?
+      active? || trial? || past_due? || processing?
     end
 
     private

data/lib/core_merchant/subscription_manager.rb

@@ -1,14 +1,38 @@
 # frozen_string_literal: true
 
-require "core_merchant/concerns/subscription_manager_renewals"
+require "core_merchant/concerns/subscription_manager_notifications"
 
 module CoreMerchant
   # Manages subscriptions in CoreMerchant.
-  # This class is responsible for notifying listeners when subscription events occur.
-  # Attributes:
+  # This class is responsible for notifying listeners when subscription events
+  # occur and checking for and handling renewals.
+  # **Attributes**:
   #   - `listeners` - An array of listeners that will be notified when subscription events occur.
+  #
+  # **Methods**:
+  #  - `check_subscriptions` - Checks all subscriptions for renewals
+  #  - `add_listener(listener)` - Adds a listener to the list of listeners
+  #  - `no_payment_needed_for_renewal(subscription)` - Handles the case where no payment is needed for a renewal.
+  #     Call when a subscription is renewed without payment.
+  #  - `processing_payment_for_renewal(subscription)` - Handles the case where payment is being processed for a renewal.
+  #     Call when payment is being processed for a renewal.
+  #  - `payment_successful_for_renewal(subscription)` - Handles the case where payment was successful for a renewal.
+  #     Call when payment was successful for a renewal.
+  #  - `payment_failed_for_renewal(subscription)` - Handles the case where payment failed for a renewal.
+  #     Call when payment failed for a renewal.
+  #
+  # **Usage**:
+  #  ```ruby
+  #  manager = CoreMerchant.subscription_manager
+  #  manager.check_subscriptions
+  #
+  #  # ... somewhere else in the code ...
+  #  manager.payment_successful_for_renewal(subscription1)
+  #  manager.payment_failed_for_renewal(subscription2)
+  #  ```
+  #
   class SubscriptionManager
-    include Concerns::SubscriptionManagerRenewals
+    include Concerns::SubscriptionManagerNotifications
 
     attr_reader :listeners
 
@@ -18,82 +42,69 @@ module CoreMerchant
 
     def check_subscriptions
       check_renewals
+      check_cancellations
     end
 
     def add_listener(listener)
       @listeners << listener
     end
 
-    def notify(subscription, event, **options) # rubocop:disable Metrics/CyclomaticComplexity,Metrics/MethodLength
-      case event
-      when :created
-        notify_subscription_created(subscription)
-      when :destroyed
-        notify_subscription_destroyed(subscription)
-      when :started
-        notify_subscription_started(subscription)
-      when :canceled
-        notify_subscription_canceled(subscription, options[:reason], options[:immediate])
-      when :due_for_renewal
-        notify_subscription_due_for_renewal(subscription)
-      when :renewed
-        notify_subscription_renewed(subscription)
-      when :renewal_payment_processing
-        notify_subscription_renewal_payment_processing(subscription)
-      when :grace_period_started
-        notify_subscription_grace_period_started(subscription, options[:days_remaining])
-      when :expired
-        notify_subscription_expired(subscription)
+    def check_renewals
+      Subscription.find_each do |subscription|
+        process_for_renewal(subscription) if subscription.due_for_renewal?
       end
     end
 
-    def notify_test_event
-      send_notification_to_listeners(nil, :on_test_event_received)
-    end
-
-    private
+    def process_for_renewal(subscription)
+      return unless subscription.transition_to_processing_renewal
 
-    def notify_subscription_created(subscription)
-      send_notification_to_listeners(subscription, :on_subscription_created)
+      notify(subscription, :due_for_renewal)
     end
 
-    def notify_subscription_destroyed(subscription)
-      send_notification_to_listeners(subscription, :on_subscription_destroyed)
+    def no_payment_needed_for_renewal(subscription)
+      renew_subscription(subscription)
     end
 
-    def notify_subscription_started(subscription)
-      send_notification_to_listeners(subscription, :on_subscription_started)
-    end
+    def processing_payment_for_renewal(subscription)
+      return unless subscription.transition_to_processing_payment
 
-    def notify_subscription_canceled(subscription, reason, immediate)
-      send_notification_to_listeners(subscription, :on_subscription_canceled, reason: reason, immediate: immediate)
+      notify(subscription, :renewal_payment_processing)
     end
 
-    def notify_subscription_due_for_renewal(subscription)
-      send_notification_to_listeners(subscription, :on_subscription_due_for_renewal)
+    def payment_successful_for_renewal(subscription)
+      renew_subscription(subscription)
     end
 
-    def notify_subscription_renewed(subscription)
-      send_notification_to_listeners(subscription, :on_subscription_renewed)
+    def payment_failed_for_renewal(subscription)
+      is_in_grace_period = subscription.in_grace_period?
+      if is_in_grace_period
+        subscription.transition_to_past_due
+        notify(subscription, :grace_period_started, days_remaining: subscription.days_remaining_in_grace_period)
+      else
+        subscription.transition_to_expired
+        notify(subscription, :expired)
+      end
     end
 
-    def notify_subscription_renewal_payment_processing(subscription)
-      send_notification_to_listeners(subscription, :on_subscription_renewal_payment_processing)
+    def check_cancellations
+      Subscription.find_each do |subscription|
+        process_for_cancellation(subscription) if subscription.pending_cancellation?
+      end
     end
 
-    def notify_subscription_expired(subscription)
-      send_notification_to_listeners(subscription, :on_subscription_expired)
-    end
+    def process_for_cancellation(subscription)
+      return unless subscription.transition_to_expired
 
-    def notify_subscription_grace_period_started(subscription, days_remaining)
-      send_notification_to_listeners(
-        subscription, :on_subscription_grace_period_started,
-        days_remaining: days_remaining
-      )
+      notify(subscription, :expired)
     end
 
-    def notify_subscription_grace_period_exceeded(subscription)
-      send_notification_to_listeners(subscription, :on_subscription_grace_period_exceeded)
+    private
+
+    def renew_subscription(subscription)
+      return unless subscription.transition_to_active
+
+      subscription.start_new_period
+      notify(subscription, :renewed)
     end
 
     def send_notification_to_listeners(subscription, method_name, **args)

data/lib/core_merchant/subscription_plan.rb

@@ -16,7 +16,7 @@ module CoreMerchant
   # - `introductory_price_cents`: The introductory price of the subscription plan in cents.
   # - `introductory_duration`: The duration of the introductory price of the subscription plan.
   #
-  # Example:
+  # Usage:
   #  ```
   #   plan = CoreMerchant::SubscriptionPlan.new(name_key: "basic_monthly", price_cents: 7_99)
   #   plan.save

data/lib/core_merchant/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CoreMerchant
-  VERSION = "0.8.0"
+  VERSION = "0.9.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: core_merchant
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Seyithan Teymur
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-07-23 00:00:00.000000000 Z
+date: 2024-07-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -144,7 +144,7 @@ files:
 - Rakefile
 - core_merchant.gemspec
 - lib/core_merchant.rb
-- lib/core_merchant/concerns/subscription_manager_renewals.rb
+- lib/core_merchant/concerns/subscription_manager_notifications.rb
 - lib/core_merchant/concerns/subscription_notifications.rb
 - lib/core_merchant/concerns/subscription_state_machine.rb
 - lib/core_merchant/customer_behavior.rb

data/lib/core_merchant/concerns/subscription_manager_renewals.rb

@@ -1,53 +0,0 @@
-# frozen_string_literal: true
-
-module CoreMerchant
-  module Concerns
-    # Includes logic for renewal processing, grace period handling, and expiration checking.
-    module SubscriptionManagerRenewals
-      extend ActiveSupport::Concern
-
-      included do # rubocop:disable Metrics/BlockLength
-        def check_renewals
-          Subscription.find_each do |subscription|
-            process_for_renewal(subscription) if subscription.due_for_renewal?
-          end
-        end
-
-        def process_for_renewal(subscription)
-          return unless subscription.transition_to_processing_renewal
-
-          notify(subscription, :due_for_renewal)
-        end
-
-        def no_payment_needed_for_renewal(subscription)
-          return unless subscription.transition_to_active
-
-          notify(subscription, :renewed)
-        end
-
-        def processing_payment_for_renewal(subscription)
-          return unless subscription.transition_to_processing_payment
-
-          notify(subscription, :renewal_payment_processing)
-        end
-
-        def payment_successful_for_renewal(subscription)
-          return unless subscription.transition_to_active
-
-          notify(subscription, :renewed)
-        end
-
-        def payment_failed_for_renewal(subscription)
-          is_in_grace_period = subscription.in_grace_period?
-          if is_in_grace_period
-            subscription.transition_to_past_due
-            notify(subscription, :grace_period_started, days_remaining: subscription.days_remaining_in_grace_period)
-          else
-            subscription.transition_to_expired
-            notify(subscription, :expired)
-          end
-        end
-      end
-    end
-  end
-end