command_tower 0.4.0 → 0.10.0

data/app/errors/command_tower/errors/auth/signup_ip_rate_limit_error.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class SignupIpRateLimitError < CommandTower::Errors::ApplicationError
+        def initialize(retry_after_seconds: nil)
+          super(details: retry_after_seconds ? { retry_after_seconds: retry_after_seconds } : nil)
+        end
+
+        def code
+          "signup_ip_rate_limited"
+        end
+
+        def message
+          "Too many signup requests from this network"
+        end
+
+        def log_level
+          :warn
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/auth/signup_session_expired_error.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class SignupSessionExpiredError < CommandTower::Errors::UnauthorizedError
+        def code
+          "signup_session_expired"
+        end
+
+        def message
+          "Signup session token has expired"
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/auth/signup_session_invalid_error.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class SignupSessionInvalidError < CommandTower::Errors::UnauthorizedError
+        def code
+          "signup_session_invalid"
+        end
+
+        def message
+          "Signup session token is invalid"
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/auth/signup_session_missing_error.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class SignupSessionMissingError < CommandTower::Errors::UnauthorizedError
+        def code
+          "signup_session_missing"
+        end
+
+        def message
+          "Signup session token is required"
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/auth/signup_session_rate_limit_error.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class SignupSessionRateLimitError < CommandTower::Errors::ApplicationError
+        def initialize(retry_after_seconds: nil)
+          super(details: retry_after_seconds ? { retry_after_seconds: retry_after_seconds } : nil)
+        end
+
+        def code
+          "signup_session_rate_limited"
+        end
+
+        def message
+          "Signup session lookup limit exceeded"
+        end
+
+        def log_level
+          :warn
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/auth/verification_code_invalid_error.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class VerificationCodeInvalidError < CommandTower::Errors::ValidationError
+        def code
+          "verification_code_invalid"
+        end
+
+        def message
+          "Verification code is invalid"
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/auth/verification_send_failed_error.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class VerificationSendFailedError < CommandTower::Errors::ApplicationError
+        def code
+          "verification_send_failed"
+        end
+
+        def message
+          "Unable to send verification email"
+        end
+
+        def retryable?
+          true
+        end
+
+        def log_level
+          :error
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/forbidden_error.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    class ForbiddenError < ApplicationError
+      def code
+        "forbidden"
+      end
+
+      def message
+        "Forbidden"
+      end
+
+      def log_level
+        :warn
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/internal_error.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    class InternalError < ApplicationError
+      def code
+        "internal_error"
+      end
+
+      def message
+        "Internal error"
+      end
+
+      def log_level
+        :error
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/messaging/accept_rejected_error.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Messaging
+      class AcceptRejectedError < CommandTower::Errors::ApplicationError
+        def code
+          "messaging_accept_rejected"
+        end
+
+        def message
+          "Messaging accept was rejected"
+        end
+
+        def log_level
+          :warn
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/messaging/idempotency_conflict_error.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Messaging
+      class IdempotencyConflictError < CommandTower::Errors::ApplicationError
+        def code
+          "messaging_idempotency_conflict"
+        end
+
+        def message
+          "Messaging accept conflicts with an existing host event"
+        end
+
+        def log_level
+          :warn
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/messaging/recipient_unresolved_error.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Messaging
+      class RecipientUnresolvedError < CommandTower::Errors::ApplicationError
+        def code
+          "messaging_recipient_unresolved"
+        end
+
+        def message
+          "Unable to resolve messaging recipient"
+        end
+
+        def log_level
+          :warn
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/not_found_error.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    class NotFoundError < ApplicationError
+      def code
+        "not_found"
+      end
+
+      def message
+        "Not found"
+      end
+
+      def log_level
+        :info
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/unauthorized_error.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    class UnauthorizedError < ApplicationError
+      def code
+        "unauthorized"
+      end
+
+      def message
+        "Unauthorized"
+      end
+
+      def log_level
+        :warn
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/validation_error.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    class ValidationError < ApplicationError
+      def code
+        "validation_failed"
+      end
+
+      def message
+        "Validation failed"
+      end
+    end
+  end
+end

data/app/jobs/command_tower/messaging/channel_delivery_execution_job.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Messaging
+    class ChannelDeliveryExecutionJob < CommandTower::ApplicationJob
+      queue_as :messaging_execution
+
+      # Execution::Recovery is the sole retry coordinator for execution failures.
+      # Do not configure ActiveJob retry_on for placeholder/execution failures.
+
+      def perform(channel_delivery_id)
+        CommandTower::Workflows::Messaging::Execution::DeliverWorkflow.call_from_job(
+          channel_delivery_id:,
+        )
+      end
+    end
+  end
+end

data/app/jobs/command_tower/messaging/communications/produce_recipient_job.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Messaging
+    module Communications
+      class ProduceRecipientJob < CommandTower::ApplicationJob
+        queue_as :messaging_produce_fanout
+
+        def perform(user_id, attrs)
+          attrs = attrs.stringify_keys
+          CommandTower::Workflows::Messaging::Communications::ProduceRecipientWorkflow.call_from_job(
+            user_id:,
+            notification_type_key: attrs.fetch("notification_type_key"),
+            campaign_identity: attrs.fetch("campaign_identity"),
+            title: attrs.fetch("title"),
+            body: attrs.fetch("body"),
+            platform_enabled_channels: Array(attrs["platform_enabled_channels"]),
+            metadata: attrs["metadata"],
+          )
+        end
+      end
+    end
+  end
+end

data/app/jobs/command_tower/messaging/execution_recovery_job.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Messaging
+    class ExecutionRecoveryJob < CommandTower::ApplicationJob
+      queue_as :messaging_execution_recovery
+
+      def perform
+        Execution::Recovery.call
+      end
+    end
+  end
+end

data/app/jobs/command_tower/messaging/handoff_job.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Messaging
+    class HandoffJob < CommandTower::ApplicationJob
+      queue_as :messaging_handoff
+
+      def perform(communication_id)
+        CommandTower::Workflows::Messaging::Handoff::ProcessWorkflow.call_from_job(
+          communication_id:,
+        )
+      end
+    end
+  end
+end

data/app/jobs/command_tower/messaging/handoff_recovery_job.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Messaging
+    class HandoffRecoveryJob < CommandTower::ApplicationJob
+      queue_as :messaging_handoff_recovery
+
+      def perform
+        Handoff::Recovery.call
+      end
+    end
+  end
+end

data/app/mailers/command_tower/email_verification_mailer.rb

@@ -2,11 +2,13 @@
 
 module CommandTower
   class EmailVerificationMailer < ApplicationMailer
-    def verify_email(email, user, code)
-      subject = "Welcome to #{}"
+    def verify_email(email, user, code, template_name: nil)
+      subject = "Welcome to #{CommandTower.config.app.communication_name }"
       @user = user
       @code = code
-      mail(to: email, subject:)
+
+      template = template_name || "verify_email"
+      mail(to: email, subject:, template_name: template)
     end
   end
 end

data/app/mailers/command_tower/messaging/channel_mailer.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Messaging
+    class ChannelMailer < ApplicationMailer
+      def deliver_rendered(rendered:)
+        unless rendered.is_a?(Rendering::RenderedPayload)
+          raise ArgumentError, "rendered must be a RenderedPayload"
+        end
+
+        from_address = CredentialResolution.resolve(:smtp).user_name.presence
+        from_address ||= "from@example.com"
+
+        mail(
+          to: rendered.recipient_address,
+          from: from_address,
+          subject: rendered.subject,
+        ) do |format|
+          format.text { render plain: rendered.text_body }
+          format.html { render html: rendered.html_body.html_safe }
+        end
+      end
+    end
+  end
+end

data/app/mailers/command_tower/password_reset_mailer.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module CommandTower
+  class PasswordResetMailer < ApplicationMailer
+    def reset_password(email, user, token, template_name: nil)
+      subject = "Reset Your Password for #{CommandTower.config.app.communication_name}"
+      @user = user
+      @token = token
+      @email = email
+      password_reset_config = CommandTower.config.login.plain_text.password_reset
+      @require_email = password_reset_config.require_email
+      @reset_password_path = password_reset_config.reset_password_path
+
+      template = template_name || password_reset_config.custom_template_name || "reset_password"
+      mail(to: email, subject:, template_name: template)
+    end
+  end
+end

data/app/models/command_tower/messaging/channel_delivery.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Messaging
+    class ChannelDelivery < CommandTower::ApplicationRecord
+      self.table_name = "messaging_channel_deliveries"
+
+      STATUS_PLANNED = "planned"
+      STATUS_QUEUED = "queued"
+      STATUS_EXECUTING = "executing"
+      STATUS_ACCEPTED_BY_PROVIDER = "accepted_by_provider"
+      STATUS_FAILED_RETRYABLE = "failed_retryable"
+      STATUS_FAILED_TERMINAL = "failed_terminal"
+
+      EXECUTION_TERMINAL_STATUSES = [
+        STATUS_ACCEPTED_BY_PROVIDER,
+        STATUS_FAILED_TERMINAL,
+      ].freeze
+
+      belongs_to :communication,
+                 class_name: "CommandTower::Messaging::Communication",
+                 inverse_of: :channel_deliveries
+
+      has_many :delivery_attempts,
+               class_name: "CommandTower::Messaging::DeliveryAttempt",
+               dependent: :destroy,
+               inverse_of: :channel_delivery
+
+      validates :channel_key, presence: true
+      validates :channel_key, uniqueness: { scope: :communication_id }
+
+      scope :queued_for_execution, -> { where(status: STATUS_QUEUED) }
+      scope :failed_retryable, -> { where(status: STATUS_FAILED_RETRYABLE) }
+      scope :executing, -> { where(status: STATUS_EXECUTING) }
+
+      def execution_terminal?
+        EXECUTION_TERMINAL_STATUSES.include?(status)
+      end
+
+      def execution_claimable?
+        status == STATUS_QUEUED
+      end
+    end
+  end
+end

data/app/models/command_tower/messaging/communication.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Messaging
+    class Communication < CommandTower::ApplicationRecord
+      self.table_name = "messaging_communications"
+
+      STATUS_ACCEPTED = "accepted"
+
+      HANDOFF_PENDING = "pending"
+      HANDOFF_ENQUEUED = "enqueued"
+      HANDOFF_COMPLETE = "complete"
+      HANDOFF_FAILED = "failed"
+
+      HANDOFF_TERMINAL_STATUSES = [HANDOFF_ENQUEUED, HANDOFF_COMPLETE].freeze
+      HANDOFF_RECOVERABLE_STATUSES = [HANDOFF_PENDING, HANDOFF_FAILED].freeze
+
+      belongs_to :user
+
+      has_one :destination_plan,
+              class_name: "CommandTower::Messaging::DestinationPlan",
+              dependent: :destroy,
+              inverse_of: :communication
+      has_one :inbox_item,
+              class_name: "CommandTower::Messaging::InboxItem",
+              dependent: :destroy,
+              inverse_of: :communication
+      has_many :channel_deliveries,
+               class_name: "CommandTower::Messaging::ChannelDelivery",
+               dependent: :destroy,
+               inverse_of: :communication
+
+      serialize :metadata, coder: JSON, type: Hash
+
+      validates :notification_type_key, :title, :body, presence: true
+      validates :execution_handoff_status, presence: true
+
+      scope :needing_handoff_recovery, lambda { |grace_before:|
+        where(status: STATUS_ACCEPTED, execution_handoff_status: HANDOFF_RECOVERABLE_STATUSES)
+          .where(arel_table[:updated_at].lt(grace_before))
+      }
+
+      def self.find_by_idempotency_namespace(user_id:, notification_type_key:, host_event_identity:)
+        find_by(
+          user_id:,
+          notification_type_key: notification_type_key.to_s,
+          host_event_identity: host_event_identity.to_s,
+        )
+      end
+
+      def handoff_terminal?
+        HANDOFF_TERMINAL_STATUSES.include?(execution_handoff_status)
+      end
+
+      def handoff_recoverable?
+        HANDOFF_RECOVERABLE_STATUSES.include?(execution_handoff_status)
+      end
+    end
+  end
+end

data/app/models/command_tower/messaging/delivery_attempt.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Messaging
+    class DeliveryAttempt < CommandTower::ApplicationRecord
+      self.table_name = "messaging_delivery_attempts"
+
+      STATUS_STARTED = "started"
+      STATUS_SUCCEEDED = "succeeded"
+      STATUS_FAILED_RETRYABLE = "failed_retryable"
+      STATUS_FAILED_TERMINAL = "failed_terminal"
+
+      STATUSES = [
+        STATUS_STARTED,
+        STATUS_SUCCEEDED,
+        STATUS_FAILED_RETRYABLE,
+        STATUS_FAILED_TERMINAL,
+      ].freeze
+
+      belongs_to :channel_delivery,
+                 class_name: "CommandTower::Messaging::ChannelDelivery",
+                 inverse_of: :delivery_attempts
+
+      validates :status, presence: true, inclusion: { in: STATUSES }
+      validates :started_at, presence: true
+    end
+  end
+end

data/app/models/command_tower/messaging/destination_plan.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Messaging
+    class DestinationPlan < CommandTower::ApplicationRecord
+      self.table_name = "messaging_destination_plans"
+
+      belongs_to :communication,
+                 class_name: "CommandTower::Messaging::Communication",
+                 inverse_of: :destination_plan
+
+      serialize :decision, coder: JSON, type: Hash
+
+      validates :communication_id, uniqueness: true
+    end
+  end
+end