morpho 1.1.2 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e6a96107096cf61bdcd55849c2bbad3d5c27c085bac23afd061fab4fb508b86
-  data.tar.gz: 7c061fe271965fc176adde62d3856f343b9e9605ab1e0a7cb096d78d8d78409c
+  metadata.gz: 82024952461a4e2bd7809b6490d89a95ea14ffbdb09bf0eb48f38293195a77d3
+  data.tar.gz: 3f7ddb7bdb31f77544040cc6b6b7576fd6ec2536f88cc66bcbe9e2c4b8ca0065
 SHA512:
-  metadata.gz: f6f6c509deaafd28182fd49d91fc8255aa9d52675753150d0e028e1efb698956131884f2b609c5aac80770eb74996aa47b538c2edc0ee46b52b0d415002047e3
-  data.tar.gz: 45d6a0a2a2aaf7551453373c40ef750c90a3f5f3caf7fa32c6124fdb45baaa5b38249e8c382be7511fa6f03d39c25922b4b4733dd77d8c6bb8b39d0f38b3a8aa
+  metadata.gz: 9accfa9064d5a4d9cfcc2110c107007a8fe511c6847bdb368206d2f57caf5e8549c08e1fbed88b47ed61661ee3eb2deae199196a14955db7f0f829382e469202
+  data.tar.gz: 60ed2c1e0f7fed8363d114ff1d98801455b02ad5f9c627e2b6f098b0443dfdbd6352c9001f565257924a7cd91992a6637bc542b7d325f4bede7533daf4ad7254

data/app/api/morpho/entities/error.rb

@@ -1,8 +1,27 @@
 module Morpho
   module Entities
     class Error < ::Grape::Entity
-      expose :message, documentation: { type: 'string', desc: 'Error standard message', required: true }
-      expose :errors, safe: true, documentation: { type: 'object', desc: 'Error message details' }
+      expose :errors, safe: true, documentation: { type: 'array', desc: 'Error message details' }
+
+      def errors
+        messages = []
+
+        keys = object.errors.keys
+
+        keys.each do |key|
+          messages << {
+            field_name: key,
+            messages: object.errors.messages[key]
+          }
+        end
+
+        messages << {
+          field_name: 'base',
+          messages: [ object.message ]
+        } if messages.empty?
+
+        messages
+      end
     end
   end
 end

data/app/api/morpho/exceptions/standard_error.rb

@@ -0,0 +1,19 @@
+module Morpho
+  module Exceptions
+    class StandardError < ::StandardError
+      attr_reader :status
+      attr_reader :message
+      attr_reader :errors
+
+      def initialize(*args)
+        options = args.extract_options!
+
+        @status = options[:status] || 422
+        @message = options[:message] || I18n.t("morpho.api.messages.general.#{@status}")
+        @errors = options[:errors] || {}
+
+        super(@message)
+      end
+    end
+  end
+end

data/app/api/morpho/formatters/standard_error.rb

@@ -0,0 +1,26 @@
+module Morpho
+  module Formatters
+    module StandardError
+      class << self
+        def call(message, backtrace, options, env, original_exception)
+          if message.is_a?(String)
+            result = {
+              message: message,
+              errors: [
+                { field_name: 'base', messages: [ message ] }
+              ]
+            }
+          elsif message.is_a?(Hash)
+            result = message
+          elsif message.is_a?(Object)
+            return message.to_json if message.respond_to?(:to_json)
+
+            result = message
+          end
+
+          ::Grape::Json.dump(result)
+        end
+      end
+    end
+  end
+end

data/app/api/morpho/helpers/http_responses.rb

@@ -3,76 +3,52 @@ module Morpho
     module HTTPResponses
       protected
 
-      def render_bad_request(errors = {})
-        error!({
-          message: I18n.t('morpho.api.messages.bad_request'),
-          errors: errors,
-          with: Morpho::Entities::Error
-        }, 400)
+      def render_bad_request
+        raise Morpho::Exceptions::StandardError.new(
+          status: 400
+        )
       end
 
-      def render_unauthorized(errors = {})
-        error!({
-          message: I18n.t('morpho.api.messages.unauthorized'),
-          errors: errors,
-          with: Morpho::Entities::Error
-        }, 401)
+      def render_unauthorized
+        raise Morpho::Exceptions::StandardError.new(
+          status: 401
+        )
       end
 
-      def render_unauthorized_detailed(errors = {})
-        render_unauthorized(errors)
+      def render_payment_required
+        raise Morpho::Exceptions::StandardError.new(
+          status: 402
+        )
       end
 
-      def render_payment_required(errors = {})
-        error!({
-          message: I18n.t('morpho.api.messages.payment_required'),
-          errors: errors,
-          with: Morpho::Entities::Error
-        }, 402)
+      def render_forbidden
+        raise Morpho::Exceptions::StandardError.new(
+          status: 403
+        )
       end
 
-      def render_forbidden(errors = {})
-        error!({
-          message: I18n.t('morpho.api.messages.forbidden'),
-          errors: errors,
-          with: Morpho::Entities::Error
-        }, 403)
+      def render_not_found
+        raise Morpho::Exceptions::StandardError.new(
+          status: 404
+        )
       end
 
-      def render_not_found(errors = {})
-        error!({
-          message: I18n.t('morpho.api.messages.not_found'),
-          errors: errors,
-          with: Morpho::Entities::Error
-        }, 404)
+      def render_method_not_allowed
+        raise Morpho::Exceptions::StandardError.new(
+          status: 405
+        )
       end
 
-      def render_method_not_allowed(errors = {})
-        error!({
-          message: I18n.t('morpho.api.messages.method_not_allowed'),
-          errors: errors,
-          with: Morpho::Entities::Error
-        }, 405)
+      def render_unprocessable_entity
+        raise Morpho::Exceptions::StandardError.new(
+          status: 422
+        )
       end
 
-      def render_unprocessable_entity(errors = {})
-        error!({
-          message: I18n.t('morpho.api.messages.unprocessable_entity'),
-          errors: errors,
-          with: Morpho::Entities::Error
-        }, 422)
-      end
-
-      def render_locked(errors = {})
-        error!({
-          message: I18n.t('morpho.api.messages.locked'),
-          errors: errors,
-          with: Morpho::Entities::Error
-        }, 423)
-      end
-
-      def render_unprocessable_entity_detailed(errors = {})
-        render_unprocessable_entity(errors)
+      def render_locked
+        raise Morpho::Exceptions::StandardError.new(
+          status: 423
+        )
       end
 
       def render_no_content

data/app/api/morpho/resources/activations.rb

@@ -5,11 +5,12 @@ module Morpho
 
       namespace :activations do
         desc 'Request user activation token' do
+          detail ''
           success Morpho::Grape::DataWrapper.new(Morpho::Entities::User)
           failure [
-            [ 404, I18n.t('morpho.api.messages.not_found'), Morpho::Entities::Error ],
-            [ 405, I18n.t('morpho.api.messages.method_not_allowed'), Morpho::Entities::Error ],
-            [ 422, I18n.t('morpho.api.messages.unprocessable_entity'), Morpho::Entities::Error ]
+            [ 404, I18n.t('morpho.api.messages.general.404'), Morpho::Entities::Error ],
+            [ 405, I18n.t('morpho.api.messages.general.405'), Morpho::Entities::Error ],
+            [ 422, I18n.t('morpho.api.messages.general.422'), Morpho::Entities::Error ]
           ]
         end
         params do
@@ -20,17 +21,6 @@ module Morpho
 
           if result.success?
             present result['model'], with: Morpho::Entities::User
-          else
-            case result['error']
-            when :unprocessable_entity
-              render_unprocessable_entity(result['contract'].errors)
-            when :not_found
-              render_not_found({ base: I18n.t('morpho.api.messages.activate.not_found') })
-            when :method_not_allowed
-              render_method_not_allowed({ base: I18n.t('morpho.api.messages.activate.method_not_allowed') })
-            else
-              render_unprocessable_entity
-            end
           end
         end
       end

data/app/api/morpho/resources/externals.rb

@@ -5,7 +5,11 @@ module Morpho
 
       namespace :externals do
         desc 'Request user authentication from external provider' do
+          detail ''
           success Morpho::Grape::DataWrapper.new(Morpho::Entities::AuthenticationToken)
+          failure [
+            [ 422, I18n.t('morpho.api.messages.general.422'), Morpho::Entities::Error ]
+          ]
         end
         params do
           requires :data, type: Morpho::Entities::External
@@ -15,13 +19,6 @@ module Morpho
 
           if result.success?
             present result['token'], with: Morpho::Entities::AuthenticationToken
-          else
-            case result['error']
-            when :unprocessable_entity
-              render_unprocessable_entity(result['contract'].errors)
-            else
-              render_unprocessable_entity
-            end
           end
         end
       end

data/app/api/morpho/resources/hello.rb

@@ -5,6 +5,7 @@ module Morpho
 
       namespace :hello do
         desc 'Request hello message' do
+          detail ''
           success Morpho::Grape::DataWrapper.new(Morpho::Entities::Message)
         end
         get :public do
@@ -19,9 +20,10 @@ module Morpho
           end
 
           desc 'Request hello message' do
+            detail ''
             success Morpho::Grape::DataWrapper.new(Morpho::Entities::Message)
             failure [
-              [ 401, I18n.t('morpho.api.messages.unauthorized'), Morpho::Entities::Error ]
+              [ 401, I18n.t('morpho.api.messages.general.401'), Morpho::Entities::Error ]
             ]
           end
           get :private do

data/app/api/morpho/resources/passwords.rb

@@ -5,11 +5,12 @@ module Morpho
 
       namespace :passwords do
         desc 'Request user reset password token' do
+          detail ''
           success Morpho::Grape::DataWrapper.new(Morpho::Entities::User)
           failure [
-            [ 404, I18n.t('morpho.api.messages.not_found'), Morpho::Entities::Error ],
-            [ 405, I18n.t('morpho.api.messages.method_not_allowed'), Morpho::Entities::Error ],
-            [ 422, I18n.t('morpho.api.messages.unprocessable_entity'), Morpho::Entities::Error ]
+            [ 404, I18n.t('morpho.api.messages.general.404'), Morpho::Entities::Error ],
+            [ 405, I18n.t('morpho.api.messages.general.405'), Morpho::Entities::Error ],
+            [ 422, I18n.t('morpho.api.messages.general.422'), Morpho::Entities::Error ]
           ]
         end
         params do
@@ -20,19 +21,6 @@ module Morpho
 
           if result.success?
             present result['model'], with: Morpho::Entities::User
-          else
-            case result['error']
-            when :not_valid
-              render_unprocessable_entity(result['contract'].errors)
-            when :not_found
-              render_not_found
-            when :not_allowed
-              render_method_not_allowed
-            when :not_delivered
-              render_unprocessable_entity
-            else
-              render_unprocessable_entity
-            end
           end
         end
       end

data/app/api/morpho/resources/tokens.rb

@@ -5,13 +5,14 @@ module Morpho
 
       namespace :tokens do
         desc 'Request user authentication token' do
+          detail ''
           success Morpho::Grape::DataWrapper.new(Morpho::Entities::AuthenticationToken)
           failure [
-            [ 401, I18n.t('morpho.api.messages.unauthorized'), Morpho::Entities::Error ],
-            [ 403, I18n.t('morpho.api.messages.forbidden'), Morpho::Entities::Error ],
-            [ 404, I18n.t('morpho.api.messages.not_found'), Morpho::Entities::Error ],
-            [ 422, I18n.t('morpho.api.messages.unprocessable_entity'), Morpho::Entities::Error ],
-            [ 423, I18n.t('morpho.api.messages.locked'), Morpho::Entities::Error ]
+            [ 401, I18n.t('morpho.api.messages.general.401'), Morpho::Entities::Error ],
+            [ 403, I18n.t('morpho.api.messages.general.403'), Morpho::Entities::Error ],
+            [ 404, I18n.t('morpho.api.messages.general.404'), Morpho::Entities::Error ],
+            [ 422, I18n.t('morpho.api.messages.general.422'), Morpho::Entities::Error ],
+            [ 423, I18n.t('morpho.api.messages.general.423'), Morpho::Entities::Error ]
           ]
         end
         params do
@@ -22,29 +23,15 @@ module Morpho
 
           if result.success?
             present result['token'], with: Morpho::Entities::AuthenticationToken
-          else
-            case result['error']
-            when :unprocessable_entity
-              render_unprocessable_entity(result['contract'].errors)
-            when :not_found
-              render_not_found({ base: I18n.t('morpho.api.messages.sign_in.not_found') })
-            when :forbidden
-              render_forbidden({ base: I18n.t('morpho.api.messages.sign_in.forbidden') })
-            when :locked
-              render_locked({ base: I18n.t('morpho.api.messages.sign_in.locked') })
-            when :unauthorized
-              render_unauthorized({ base: I18n.t('morpho.api.messages.sign_in.unauthorized') })
-            else
-              render_unprocessable_entity
-            end
           end
         end
 
         desc 'Refresh user authentication token' do
+          detail ''
           success Morpho::Grape::DataWrapper.new(Morpho::Entities::AuthenticationToken)
           failure [
-            [ 404, I18n.t('morpho.api.messages.not_found'), Morpho::Entities::Error ],
-            [ 422, I18n.t('morpho.api.messages.unprocessable_entity'), Morpho::Entities::Error ]
+            [ 404, I18n.t('morpho.api.messages.general.404'), Morpho::Entities::Error ],
+            [ 422, I18n.t('morpho.api.messages.general.422'), Morpho::Entities::Error ]
           ]
         end
         params do
@@ -55,15 +42,6 @@ module Morpho
 
           if result.success?
             present result['token'], with: Morpho::Entities::AuthenticationToken
-          else
-            case result['error']
-            when :unprocessable_entity
-              render_unprocessable_entity(result['contract'].errors)
-            when :not_found
-              render_not_found({ base: I18n.t('morpho.api.messages.refresh_token.not_found') })
-            else
-              render_unprocessable_entity
-            end
           end
         end
       end

data/app/api/morpho/resources/unlocks.rb

@@ -5,11 +5,12 @@ module Morpho
 
       namespace :unlocks do
         desc 'Request user unlock token' do
+          detail ''
           success Morpho::Grape::DataWrapper.new(Morpho::Entities::UserEmail)
           failure [
-            [ 404, I18n.t('morpho.api.messages.not_found'), Morpho::Entities::Error ],
-            [ 405, I18n.t('morpho.api.messages.method_not_allowed'), Morpho::Entities::Error ],
-            [ 422, I18n.t('morpho.api.messages.unprocessable_entity'), Morpho::Entities::Error ]
+            [ 404, I18n.t('morpho.api.messages.general.404'), Morpho::Entities::Error ],
+            [ 405, I18n.t('morpho.api.messages.general.405'), Morpho::Entities::Error ],
+            [ 422, I18n.t('morpho.api.messages.general.422'), Morpho::Entities::Error ]
           ]
         end
         params do
@@ -20,17 +21,6 @@ module Morpho
 
           if result.success?
             present result['model'], with: Morpho::Entities::User
-          else
-            case result['error']
-            when :unprocessable_entity
-              render_unprocessable_entity(result['contract'].errors)
-            when :not_found
-              render_not_found({ base: I18n.t('morpho.api.messages.unlock.not_found') })
-            when :method_not_allowed
-              render_method_not_allowed({ base: I18n.t('morpho.api.messages.unlock.method_not_allowed') })
-            else
-              render_unprocessable_entity
-            end
           end
         end
       end

data/app/api/morpho/resources/users.rb

@@ -5,9 +5,10 @@ module Morpho
 
       namespace :users do
         desc 'User registration' do
+          detail ''
           success Morpho::Grape::DataWrapper.new(Morpho::Entities::User)
           failure [
-            [ 422, I18n.t('morpho.api.messages.unprocessable_entity'), Morpho::Entities::Error ]
+            [ 422, I18n.t('morpho.api.messages.general.422'), Morpho::Entities::Error ]
           ]
         end
         params do
@@ -18,15 +19,6 @@ module Morpho
 
           if result.success?
             present result['model'], with: Morpho::Entities::User
-          else
-            case result['error']
-            when :not_valid
-              render_unprocessable_entity(result['contract'].errors)
-            when :not_saved
-              render_unprocessable_entity(result['model'].errors)
-            else
-              render_unprocessable_entity
-            end
           end
         end
       end

data/app/concepts/morpho/user/operation/activate.rb

@@ -1,40 +1,42 @@
 module Morpho
   class User::Operation::Activate < Trailblazer::Operation
-    step :validate
-    fail :unprocessable_entity, fail_fast: true
-    step :find
-    fail :not_found, fail_fast: true
-    step :check
-    fail :method_not_allowed, fail_fast: true
-    pass :activation_email
+    pass :validate!
+    pass :find!
+    pass :check!
+    pass :activation_email!
 
-    def validate (options, **)
+    def validate!(options, **)
       options['contract'] = Morpho::User::Contract::Activate.new(OpenStruct.new)
-      options['contract'].validate(options['data'])
-    end
-
-    def find (options, **)
-      options['model'] = Morpho::User.find_by(email: options['data']['email'])
-    end
 
-    def check (options, **)
-      !options['model'].active?
+      unless options['contract'].validate(options['data'])
+        raise Morpho::Exceptions::StandardError.new(
+          errors: options['contract'].errors
+        )
+      end
     end
 
-    def activation_email (options, **)
-      options['model'].resend_activation_needed_email!
-    end
+    def find!(options, **)
+      options['model'] = Morpho::User.find_by(email: options['data']['email'])
 
-    def unprocessable_entity (options, **)
-      options['error'] = :unprocessable_entity
+      if options['model'].nil?
+        raise Morpho::Exceptions::StandardError.new(
+          message: I18n.t('morpho.api.messages.activate.email_not_exists'),
+          status: 404
+        )
+      end
     end
 
-    def not_found (options, **)
-      options['error'] = :not_found
+    def check!(options, **)
+      if options['model'].active?
+        raise Morpho::Exceptions::StandardError.new(
+          message: I18n.t('morpho.api.messages.activate.account_already_confirmed'),
+          status: 405
+        )
+      end
     end
 
-    def method_not_allowed (options, **)
-      options['error'] = :method_not_allowed
+    def activation_email!(options, **)
+      options['model'].resend_activation_needed_email!
     end
   end
 end

data/app/concepts/morpho/user/operation/external_sign_in.rb

@@ -1,48 +1,52 @@
 module Morpho
   class User::Operation::ExternalSignIn < Trailblazer::Operation
-    step :validate
-    fail :unprocessable_entity, fail_fast: true
-    pass :find_authentication
-    pass :find_user
-    pass :sign_in
-    pass :register
-    pass :sign_up
-    step :generate_refresh_token
-    step :register_last_login_activity
-    step :authentication_token
+    pass :validate!
+    pass :find_authentication!
+    pass :find_user!
+    pass :sign_in!
+    pass :register!
+    pass :sign_up!
+    pass :generate_refresh_token!
+    pass :register_last_login_activity!
+    pass :authentication_token!
 
-    def validate (options, **)
+    def validate!(options, **)
       options['contract'] = Morpho::User::Contract::ExternalSignIn.new(OpenStruct.new)
-      options['contract'].validate(options['data'])
+
+      unless options['contract'].validate(options['data'])
+        raise Morpho::Exceptions::StandardError.new(
+          errors: options['contract'].errors
+        )
+      end
     end
 
-    def find_authentication (options, **)
+    def find_authentication!(options, **)
       options['authentication.model'] = Morpho::Authentication.find_by(
         uid: options['data']['uid'],
         provider: options['data']['provider']
       )
     end
 
-    def find_user (options, **)
+    def find_user!(options, **)
       options['user.model'] = Morpho::User.find_by(email: options['data']['email'])
     end
 
-    def sign_in (options, **)
+    def sign_in!(options, **)
       if options['authentication.model']
         options['user.model'] = options['authentication.model'].user
       end
     end
 
-    def register (options, **)
-      if options['user.model'] && !options['authentication.model']
+    def register!(options, **)
+      if options['user.model'] && options['authentication.model'].nil?
         provider = options['data']['provider'].downcase
 
         options['user.model'].add_provider_to_user(provider, options['data']['uid'])
       end
     end
 
-    def sign_up (options, **)
-      if !options['user.model'] && !options['authentication.model']
+    def sign_up!(options, **)
+      if options['user.model'].nil? && options['authentication.model'].nil?
         provider = options['data']['provider'].downcase
 
         options['user.model'] = Morpho::User.create_from_provider(provider, options['data']['uid'], {
@@ -51,19 +55,15 @@ module Morpho
       end
     end
 
-    def generate_refresh_token (options, **)
+    def generate_refresh_token!(options, **)
       options['user.model'].generate_refresh_token!
     end
 
-    def register_last_login_activity (options, **)
+    def register_last_login_activity!(options, **)
       options['user.model'].register_last_login_activity!(options['ip'])
     end
 
-    def unprocessable_entity (options, **)
-      options['error'] = :unprocessable_entity
-    end
-
-    def authentication_token (options, **)
+    def authentication_token!(options, **)
       options['token'] = ::Morpho::JWT::Payload.new(options['user.model'])
     end
   end

data/app/concepts/morpho/user/operation/refresh_token.rb

@@ -1,34 +1,36 @@
 module Morpho
   class User::Operation::RefreshToken < Trailblazer::Operation
-    step :validate
-    fail :unprocessable_entity, fail_fast: true
-    step :find
-    fail :not_found, fail_fast: true
-    step :generate_refresh_token
-    step :authentication_token
+    pass :validate!
+    pass :find!
+    pass :generate_refresh_token!
+    pass :authentication_token!
 
-    def validate (options, **)
+    def validate!(options, **)
       options['contract'] = Morpho::User::Contract::RefreshToken.new(OpenStruct.new)
-      options['contract'].validate(options['data'])
-    end
 
-    def find (options, **)
-      options['model'] = Morpho::User.find_by(refresh_token: options['data']['refresh_token'])
+      unless options['contract'].validate(options['data'])
+        raise Morpho::Exceptions::StandardError.new(
+          errors: options['contract'].errors
+        )
+      end
     end
 
-    def generate_refresh_token (options, **)
-      options['model'].generate_refresh_token!
-    end
+    def find!(options, **)
+      options['model'] = Morpho::User.find_by(refresh_token: options['data']['refresh_token'])
 
-    def unprocessable_entity (options, **)
-      options['error'] = :unprocessable_entity
+      if options['model'].nil?
+        raise Morpho::Exceptions::StandardError.new(
+          message: I18n.t('morpho.api.messages.refresh_token.invalid'),
+          status: 404
+        )
+      end
     end
 
-    def not_found (options, **)
-      options['error'] = :not_found
+    def generate_refresh_token!(options, **)
+      options['model'].generate_refresh_token!
     end
 
-    def authentication_token (options, **)
+    def authentication_token!(options, **)
       options['token'] = ::Morpho::JWT::Payload.new(options['model'])
     end
   end

data/app/concepts/morpho/user/operation/reset_password.rb

@@ -1,49 +1,40 @@
 module Morpho
   class User::Operation::ResetPassword < Trailblazer::Operation
-    step :validate
-    fail :not_valid, fail_fast: true
-    step :find
-    fail :not_found, fail_fast: true
-    step :check
-    fail :not_allowed, fail_fast: true
-    step :reset_password_email
-    fail :not_delivered, fail_fast: true
+    pass :validate!
+    pass :find!
+    pass :check!
+    pass :reset_password_email!
 
-    def validate (options, **)
+    def validate!(options, **)
       options['contract'] = Morpho::User::Contract::ResetPassword.new(OpenStruct.new)
-      options['contract'].validate(options['data'])
-    end
-
-    def find (options, **)
-      options['model'] = Morpho::User.find_by(email: options['data']['email'])
-    end
-
-    def check (options, **)
-      !options['model'].external?
-    end
 
-    def reset_password_email (options, **)
-      options['model'].deliver_reset_password_instructions!
-    end
-
-    def not_valid (options, **)
-      options['error'] = :not_valid
+      unless options['contract'].validate(options['data'])
+        raise Morpho::Exceptions::StandardError.new(
+          errors: options['contract'].errors
+        )
+      end
     end
 
-    def not_found (options, **)
-      options['error'] = :not_found
-    end
+    def find!(options, **)
+      options['model'] = Morpho::User.find_by(email: options['data']['email'])
 
-    def not_allowed (options, **)
-      options['error'] = :not_allowed
+      if options['model'].nil?
+        raise Morpho::Exceptions::StandardError.new(
+          status: 404
+        )
+      end
     end
 
-    def not_delivered (options, **)
-      options['error'] = :not_delivered
+    def check!(options, **)
+      if options['model'].external?
+        raise Morpho::Exceptions::StandardError.new(
+          status: 405
+        )
+      end
     end
 
-    def render (options, **)
-      options['model']
+    def reset_password_email!(options, **)
+      options['model'].deliver_reset_password_instructions!
     end
   end
 end

data/app/concepts/morpho/user/operation/sign_in.rb

@@ -1,70 +1,72 @@
 module Morpho
   class User::Operation::SignIn < Trailblazer::Operation
-    step :validate
-    fail :unprocessable_entity, fail_fast: true
-    step :find
-    fail :not_found, fail_fast: true
-    step :check_active
-    fail :forbidden, fail_fast: true
-    step :check_unlocked
-    fail :locked, fail_fast: true
-    step :check_password
-    fail :unauthorized, fail_fast: true
-    step :generate_refresh_token
-    step :register_last_login_activity
-    step :authentication_token
+    pass :validate!
+    pass :find!
+    pass :check_active!
+    pass :check_unlocked!
+    pass :check_password!
+    pass :generate_refresh_token!
+    pass :register_last_login_activity!
+    pass :authentication_token!
 
-    def validate (options, **)
+    def validate!(options, **)
       options['contract'] = Morpho::User::Contract::SignIn.new(OpenStruct.new)
-      options['contract'].validate(options['data'])
+
+      unless options['contract'].validate(options['data'])
+        raise Morpho::Exceptions::StandardError.new(
+          errors: options['contract'].errors
+        )
+      end
     end
 
-    def find (options, **)
+    def find!(options, **)
       options['model'] = Morpho::User.find_by(email: options['data']['email'])
+
+      if options['model'].nil?
+        raise Morpho::Exceptions::StandardError.new(
+          message: I18n.t('morpho.api.messages.sign_in.email_not_exists'),
+          status: 404
+        )
+      end
     end
 
-    def check_active (options, **)
-      options['model'].active?
+    def check_active!(options, **)
+      unless options['model'].active?
+        raise Morpho::Exceptions::StandardError.new(
+          message: I18n.t('morpho.api.messages.sign_in.account_not_confirmed'),
+          status: 403
+        )
+      end
     end
 
-    def check_unlocked (options, **)
-      options['model'].unlocked?
+    def check_unlocked!(options, **)
+      unless options['model'].unlocked?
+        raise Morpho::Exceptions::StandardError.new(
+          message: I18n.t('morpho.api.messages.sign_in.account_locked'),
+          status: 423
+        )
+      end
     end
 
-    def check_password (options, **)
-      options['model'].valid_password?(options['data']['password'])
+    def check_password!(options, **)
+      unless options['model'].valid_password?(options['data']['password'])
+        options['model'].register_failed_login!
+        raise Morpho::Exceptions::StandardError.new(
+          message: I18n.t('morpho.api.messages.sign_in.bad_credentials'),
+          status: 401
+        )
+      end
     end
 
-    def generate_refresh_token (options, **)
+    def generate_refresh_token!(options, **)
       options['model'].generate_refresh_token!
     end
 
-    def register_last_login_activity (options, **)
+    def register_last_login_activity!(options, **)
       options['model'].register_last_login_activity!(options['ip'])
     end
 
-    def unprocessable_entity (options, **)
-      options['error'] = :unprocessable_entity
-    end
-
-    def not_found (options, **)
-      options['error'] = :not_found
-    end
-
-    def forbidden (options, **)
-      options['error'] = :forbidden
-    end
-
-    def locked (options, **)
-      options['error'] = :locked
-    end
-
-    def unauthorized (options, **)
-      options['model'].register_failed_login!
-      options['error'] = :unauthorized
-    end
-
-    def authentication_token (options, **)
+    def authentication_token!(options, **)
       options['token'] = ::Morpho::JWT::Payload.new(options['model'])
     end
   end

data/app/concepts/morpho/user/operation/sign_up.rb

@@ -1,36 +1,32 @@
 module Morpho
   class User::Operation::SignUp < Trailblazer::Operation
-    step :validate
-    fail :not_valid, fail_fast: true
-    step :sync
-    fail :not_synced, fail_fast: true
-    step :save
-    fail :not_saved, fail_fast: true
+    pass :validate!
+    pass :sync!
+    pass :save!
 
-    def validate(options, **)
+    def validate!(options, **)
       options['contract'] = Morpho::User::Contract::SignUp.new(Morpho::User.new)
-      options['contract'].validate(options['data'])
+
+      unless options['contract'].validate(options['data'])
+        raise Morpho::Exceptions::StandardError.new(
+          errors: options['contract'].errors
+        )
+      end
     end
 
-    def sync(options, **)
+    def sync!(options, **)
       options['contract'].sync
     end
 
-    def save (options, **)
+    def save!(options, **)
       options['model'] = options['contract'].model
       options['model'].save
-    end
-
-    def not_valid(options, **)
-      options['error'] = :not_valid
-    end
-
-    def not_synced(options, **)
-      options['error'] = :not_synced
-    end
 
-    def not_saved(options, **)
-      options['error'] = :not_saved
+      unless options['model'].persisted?
+        raise Morpho::Exceptions::StandardError.new(
+          errors: options['model'].errors
+        )
+      end
     end
   end
 end

data/app/concepts/morpho/user/operation/unlock.rb

@@ -1,40 +1,42 @@
 module Morpho
   class User::Operation::Unlock < Trailblazer::Operation
-    step :validate
-    fail :unprocessable_entity, fail_fast: true
-    step :find
-    fail :not_found, fail_fast: true
-    step :check
-    fail :method_not_allowed, fail_fast: true
-    pass :unlock_token_email
+    pass :validate!
+    pass :find!
+    pass :check!
+    pass :unlock_token_email!
 
-    def validate (options, **)
+    def validate!(options, **)
       options['contract'] = Morpho::User::Contract::Unlock.new(OpenStruct.new)
-      options['contract'].validate(options['data'])
-    end
-
-    def find (options, **)
-      options['model'] = Morpho::User.find_by(email: options['data']['email'])
-    end
 
-    def check (options, **)
-      options['model'].login_locked?
+      unless options['contract'].validate(options['data'])
+        raise Morpho::Exceptions::StandardError.new(
+          errors: options['contract'].errors
+        )
+      end
     end
 
-    def unlock_token_email (options, **)
-      options['model'].resend_unlock_token_email!
-    end
+    def find!(options, **)
+      options['model'] = Morpho::User.find_by(email: options['data']['email'])
 
-    def unprocessable_entity (options, **)
-      options['error'] = :unprocessable_entity
+      if options['model'].nil?
+        raise Morpho::Exceptions::StandardError.new(
+          message: I18n.t('morpho.api.messages.unlock.email_not_exists'),
+          status: 404
+        )
+      end
     end
 
-    def not_found (options, **)
-      options['error'] = :not_found
+    def check!(options, **)
+      unless options['model'].login_locked?
+        raise Morpho::Exceptions::StandardError.new(
+          message: I18n.t('morpho.api.messages.unlock.account_not_locked'),
+          status: 405
+        )
+      end
     end
 
-    def method_not_allowed (options, **)
-      options['error'] = :method_not_allowed
+    def unlock_token_email!(options, **)
+      options['model'].resend_unlock_token_email!
     end
   end
 end

data/app/models/morpho/user.rb

@@ -10,6 +10,10 @@ module Morpho
       self.activation_state == 'active'
     end
 
+    def inactive?
+      self.activation_state == 'pending'
+    end
+
     def unlocked?
       !self.login_locked?
     end

data/config/locales/morpho.en.yml

@@ -130,27 +130,28 @@ en:
 
     api:
       messages:
-        bad_request: 'Bad request'
-        unauthorized: 'Unauthorized'
-        payment_required: 'Payment required'
-        forbidden: 'Forbidden'
-        not_found: 'Not found'
-        method_not_allowed: 'Method not allowed'
-        unprocessable_entity: 'Unprocessable entity'
-        locked: 'Locked'
+        general:
+          "400": 'Bad request'
+          "401": 'Unauthorized'
+          "402": 'Payment required'
+          "403": 'Forbidden'
+          "404": 'Not found'
+          "405": 'Method not allowed'
+          "422": 'Unprocessable entity'
+          "423": 'Locked'
         activate:
-          not_found: 'Email address does not belongs to a registered account'
-          method_not_allowed: 'User account has already been confirmed'
+          email_not_exists: 'Email address does not belongs to a registered account'
+          account_already_confirmed: 'User account has already been confirmed'
         sign_in:
-          not_found: 'Email address does not belongs to a registered account'
-          forbidden: 'User account has not been confirmed'
-          unauthorized: 'User email and/or password is incorrect'
-          locked: 'User account has been locked'
+          email_not_exists: 'Email address does not belongs to a registered account'
+          account_not_confirmed: 'User account has not been confirmed'
+          account_locked: 'User account has been locked'
+          bad_credentials: 'User email and/or password is incorrect'
         refresh_token:
-          not_found: 'Invalid token'
+          invalid: 'Invalid token'
         unlock:
-          not_found: 'Email address does not belongs to a registered account'
-          method_not_allowed: 'User account has not been locked'
+          email_not_exists: 'Email address does not belongs to a registered account'
+          account_not_locked: 'User account has not been locked'
   simple_form:
     'yes': 'Yes'
     'no': 'No'

data/config/locales/morpho.es.yml

@@ -130,27 +130,28 @@ es:
 
     api:
       messages:
-        bad_request: 'Solicitud incorrecta'
-        unauthorized: 'No autorizado'
-        payment_required: 'Pago requerido'
-        forbidden: 'Prohibido'
-        not_found: 'No encontrado'
-        method_not_allowed: 'Método no permitido'
-        unprocessable_entity: 'Entidad no procesable'
-        locked: 'Bloqueado'
+        general:
+          "400": 'Solicitud incorrecta'
+          "401": 'No autorizado'
+          "402": 'Pago requerido'
+          "403": 'Prohibido'
+          "404": 'No encontrado'
+          "405": 'Método no permitido'
+          "422": 'Entidad no procesable'
+          "423": 'Bloqueado'
         activate:
-          not_found: 'Correo electrónico no pertenece a un usuario registrado'
-          method_not_allowed: 'Cuenta de usuario ya ha sido confirmada'
+          email_not_exists: 'Correo electrónico no pertenece a un usuario registrado'
+          account_already_confirmed: 'Cuenta de usuario ya ha sido confirmada'
         sign_in:
-          not_found: 'Correo electrónico no pertenece a un usuario registrado'
-          forbidden: 'Cuenta de usuario no ha sido confirmada'
-          unauthorized: 'Correo electrónico y/o contraseña es incorrecto(a)'
-          locked: 'Cuenta de usuario ha sido bloqueada'
+          email_not_exists: 'Correo electrónico no pertenece a un usuario registrado'
+          account_not_confirmed: 'Cuenta de usuario no ha sido confirmada'
+          account_locked: 'Cuenta de usuario ha sido bloqueada'
+          bad_credentials: 'Correo electrónico y/o contraseña es incorrecto(a)'
         refresh_token:
-          not_found: 'El token es inválido'
+          invalid: 'El token es inválido'
         unlock:
-          not_found: 'Correo electrónico no pertenece a un usuario registrado'
-          method_not_allowed: 'Cuenta de usuario no ha sido bloqueada'
+          email_not_exists: 'Correo electrónico no pertenece a un usuario registrado'
+          account_not_locked: 'Cuenta de usuario no ha sido bloqueada'
   simple_form:
     'yes': 'Si'
     'no': 'No'

data/lib/morpho/version.rb

@@ -1,3 +1,3 @@
 module Morpho
-  VERSION = '1.1.2'
+  VERSION = '1.2.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: morpho
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.2.0
 platform: ruby
 authors:
 - Hugo Gilmar Erazo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-01 00:00:00.000000000 Z
+date: 2018-11-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -296,6 +296,8 @@ files:
 - app/api/morpho/entities/user.rb
 - app/api/morpho/entities/user_email.rb
 - app/api/morpho/entities/user_sign_up.rb
+- app/api/morpho/exceptions/standard_error.rb
+- app/api/morpho/formatters/standard_error.rb
 - app/api/morpho/helpers/http_responses.rb
 - app/api/morpho/helpers/jwt_utils.rb
 - app/api/morpho/resources/activations.rb