command_tower 0.4.0 → 0.10.0

data/app/deserializers/command_tower/deserializers/messaging/preferences/update_deserializer.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Deserializers
+    module Messaging
+      module Preferences
+        class UpdateDeserializer < CommandTower::Deserializers::ApplicationDeserializer
+          Input = Data.define(:notification_type_key, :preference_state)
+
+          ROUTING_KEYS = %w[controller action format notification_type_key preference].freeze
+          ALLOWED_PREFERENCE_KEYS = %w[inboxEnabled channels].freeze
+
+          def call(params)
+            raw = normalize_hash(params)
+            return failure(errors: { message: "invalid_notification_type_key" }) if raw.nil?
+
+            notification_type_key = raw["notification_type_key"]
+            if notification_type_key.nil? || !notification_type_key.is_a?(String) || notification_type_key.strip.empty?
+              return failure(errors: { message: "invalid_notification_type_key" })
+            end
+
+            extras = raw.keys - ROUTING_KEYS - ["preferences"]
+            return failure(errors: { message: "unexpected_fields" }) if extras.any?
+            return failure(errors: { message: "missing_preferences" }) unless raw.key?("preferences")
+
+            preferences = raw["preferences"]
+            return failure(errors: { message: "invalid_preferences" }) unless preferences.is_a?(Hash)
+
+            preference_state = parse_preferences(preferences)
+            return preference_state if preference_state.is_a?(DeserializerResult)
+
+            success(
+              Input.new(
+                notification_type_key: notification_type_key.strip,
+                preference_state:,
+              ),
+            )
+          end
+
+          private
+
+          def normalize_hash(params)
+            hash =
+              if params.respond_to?(:to_unsafe_h)
+                params.to_unsafe_h
+              elsif params.respond_to?(:to_h)
+                params.to_h
+              else
+                return nil
+              end
+
+            hash.each_with_object({}) do |(key, value), result|
+              result[key.to_s] =
+                if value.respond_to?(:to_unsafe_h)
+                  value.to_unsafe_h.transform_keys(&:to_s)
+                elsif value.is_a?(Hash)
+                  value.transform_keys(&:to_s)
+                else
+                  value
+                end
+            end
+          end
+
+          def parse_preferences(preferences)
+            unknown = preferences.keys - ALLOWED_PREFERENCE_KEYS
+            return failure(errors: { message: "unexpected_preference_fields" }) if unknown.any?
+
+            state = {}
+
+            if preferences.key?("channels")
+              channels = preferences["channels"]
+              return failure(errors: { message: "invalid_channels" }) unless channels.is_a?(Hash)
+
+              parsed_channels = {}
+              channels.each do |channel_key, channel_value|
+                return failure(errors: { message: "invalid_channel_key" }) unless channel_key.is_a?(String) || channel_key.is_a?(Symbol)
+                return failure(errors: { message: "invalid_channel_value" }) unless [true, false].include?(channel_value)
+
+                parsed_channels[channel_key.to_s] = channel_value
+              end
+              state["channels"] = parsed_channels
+            end
+
+            if preferences.key?("inboxEnabled")
+              inbox = preferences["inboxEnabled"]
+              return failure(errors: { message: "invalid_inbox_enabled" }) unless [true, false].include?(inbox)
+
+              state["inbox"] = inbox
+            end
+
+            state
+          end
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/account/phone_already_verified_error.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Account
+      class PhoneAlreadyVerifiedError < CommandTower::Errors::ApplicationError
+        def code
+          "phone_already_verified"
+        end
+
+        def message
+          "Phone number is already verified"
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/account/phone_missing_error.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Account
+      class PhoneMissingError < CommandTower::Errors::ApplicationError
+        def code
+          "phone_missing"
+        end
+
+        def message
+          "Phone number is required"
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/account/phone_verification_code_invalid_error.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Account
+      class PhoneVerificationCodeInvalidError < CommandTower::Errors::ApplicationError
+        def code
+          "phone_verification_code_invalid"
+        end
+
+        def message
+          "Incorrect verification code"
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/account/phone_verification_expired_error.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Account
+      class PhoneVerificationExpiredError < CommandTower::Errors::ApplicationError
+        def code
+          "phone_verification_code_expired"
+        end
+
+        def message
+          "Verification code has expired"
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/account/phone_verification_send_failed_error.rb

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

data/app/errors/command_tower/errors/account/phone_verification_stale_error.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Account
+      class PhoneVerificationStaleError < CommandTower::Errors::ApplicationError
+        def code
+          "phone_verification_stale"
+        end
+
+        def message
+          "Verification code is no longer valid for this phone"
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/account/phone_verification_throttled_error.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Account
+      class PhoneVerificationThrottledError < CommandTower::Errors::ApplicationError
+        attr_reader :resend_available_at
+
+        def initialize(resend_available_at: nil)
+          @resend_available_at = resend_available_at
+          super()
+        end
+
+        def code
+          "phone_verification_throttled"
+        end
+
+        def message
+          "Please wait before requesting another code"
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/account/pushover_already_configured_error.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Account
+      class PushoverAlreadyConfiguredError < CommandTower::Errors::ApplicationError
+        def code
+          "pushover_already_configured"
+        end
+
+        def message
+          "Pushover is already configured"
+        end
+
+        def log_level
+          :info
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/account/pushover_capability_unavailable_error.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Account
+      class PushoverCapabilityUnavailableError < CommandTower::Errors::ApplicationError
+        def code
+          "pushover_capability_unavailable"
+        end
+
+        def message
+          "Pushover is currently unavailable"
+        end
+
+        def log_level
+          :warn
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/account/pushover_not_configured_error.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Account
+      class PushoverNotConfiguredError < CommandTower::Errors::ApplicationError
+        def code
+          "pushover_not_configured"
+        end
+
+        def message
+          "Pushover is not configured"
+        end
+
+        def log_level
+          :info
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/account/pushover_provider_unavailable_error.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Account
+      class PushoverProviderUnavailableError < CommandTower::Errors::ApplicationError
+        def code
+          "pushover_provider_unavailable"
+        end
+
+        def message
+          "Pushover provider is temporarily unavailable"
+        end
+
+        def log_level
+          :warn
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/account/pushover_verification_failed_error.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Account
+      class PushoverVerificationFailedError < CommandTower::Errors::ApplicationError
+        def initialize(code: "pushover_verification_failed", message: "Pushover verification failed", details: nil, cause: nil)
+          @code = code
+          @message = message
+          super(details:, cause:)
+        end
+
+        def code
+          @code
+        end
+
+        def message
+          @message
+        end
+
+        def log_level
+          :info
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/account/sms_capability_unavailable_error.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Account
+      class SmsCapabilityUnavailableError < CommandTower::Errors::ApplicationError
+        def code
+          "sms_capability_unavailable"
+        end
+
+        def message
+          "SMS is currently unavailable"
+        end
+
+        def log_level
+          :warn
+        end
+      end
+    end
+  end
+end

data/app/errors/command_tower/errors/application_error.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    class ApplicationError < StandardError
+      attr_reader :details, :cause
+
+      def initialize(details: nil, cause: nil)
+        @details = details
+        @cause = cause
+        super()
+      end
+
+      def code
+        raise NotImplementedError
+      end
+
+      def retryable?
+        false
+      end
+
+      def log_level
+        :info
+      end
+    end
+  end
+end

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

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class CsrfMismatchError < CommandTower::Errors::UnauthorizedError
+        def code
+          "csrf_mismatch"
+        end
+
+        def message
+          "CSRF token mismatch"
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class CsrfMissingError < CommandTower::Errors::UnauthorizedError
+        def code
+          "csrf_missing"
+        end
+
+        def message
+          "CSRF token missing"
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class EmailAlreadyRegisteredError < CommandTower::Errors::ValidationError
+        def code
+          "email_already_registered"
+        end
+
+        def message
+          "Email is already registered"
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class EmailVerificationRequiredError < CommandTower::Errors::UnauthorizedError
+        def code
+          "email_verification_required"
+        end
+
+        def message
+          "Email verification required"
+        end
+
+        def log_level
+          :info
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class InvalidCredentialsError < CommandTower::Errors::UnauthorizedError
+        def code
+          "invalid_credentials"
+        end
+
+        def message
+          "Invalid credentials"
+        end
+
+        def log_level
+          :info
+        end
+      end
+    end
+  end
+end

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

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

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class PasswordRecoverySessionExpiredError < CommandTower::Errors::ApplicationError
+        def code
+          "password_recovery_session_expired"
+        end
+
+        def message
+          "Password recovery session has expired"
+        end
+
+        def log_level
+          :warn
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class PasswordRecoverySessionInvalidError < CommandTower::Errors::ApplicationError
+        def code
+          "password_recovery_session_invalid"
+        end
+
+        def message
+          "Password recovery session is invalid"
+        end
+
+        def log_level
+          :warn
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class PasswordRecoverySessionMissingError < CommandTower::Errors::ApplicationError
+        def code
+          "password_recovery_session_missing"
+        end
+
+        def message
+          "Password recovery session is required"
+        end
+
+        def log_level
+          :warn
+        end
+      end
+    end
+  end
+end

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

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

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class PasswordResetInvalidTokenError < CommandTower::Errors::ApplicationError
+        def code
+          "password_reset_invalid_token"
+        end
+
+        def message
+          "Invalid token"
+        end
+
+        def log_level
+          :warn
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CommandTower
+  module Errors
+    module Auth
+      class PasswordResetUnavailableError < CommandTower::Errors::ApplicationError
+        def code
+          "password_reset_unavailable"
+        end
+
+        def message
+          "Password reset is currently unavailable"
+        end
+
+        def log_level
+          :warn
+        end
+      end
+    end
+  end
+end