hubbado-trailblazer 1.2.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 73c78de9e6399b2943e694031b7cfd30b6c13776944b37221fbe89a47518aeb6
-  data.tar.gz: 4fd46589064ce601305b990873d981554a50ee97b634b50ee97ca19478bf96f3
+  metadata.gz: f0d94f46fd55fd7b149ec18fb82e6923b8d828b4d9fbf4e23465bbfbd448688e
+  data.tar.gz: 5a63ac1ee253726b488acd45acbdaad37eb9af1fea81d9716f2089727aeae80f
 SHA512:
-  metadata.gz: d728feb3ee223119e4f32ef9efb908c5965e89d712b85d3f8984234d4abde74a280cd2638da7e539f65f566955ee991a38f786ceae1b855b9093a560e0ae1dc1
-  data.tar.gz: d89402e82251ce04726a280ebfbca988c295608ac48aba5125fd390d3bcc45dc6ef995119ea0756dcd580e7e3f987cf07f4196a250a88b831d13e89e6540e0e4
+  metadata.gz: 7fb80170ecf81108173c6fcca1cf4271eb7e927f9bbc179cf2e66dc7e6f1e57b9681ecd99658af9184494330b46044d2c1cb60ab866e2c5c6efc8b08badc471f
+  data.tar.gz: afd335df6d8698d1fc89e722ba7fac1415e06b46f1722cb3796e6546d444005c98df54fb5cdbb9881ac5bd8703c8dc01d65898d7e834a68382b5be9188458bc2

data/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.4.0] - 2025-12-09
+
+### Added
+
+- `policy_unauthorized_message` template method to customize the policy unauthorized exception message
+
+## [1.3.0] - 2025-11-26
+
+### Added
+
+- Support for `result.not_found { ... }` block to handle operations with `:not_found` terminus.
+
 ## [1.2.0] - 2025-07-19
 
 ### Added

data/hubbado-trailblazer.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name = "hubbado-trailblazer"
-  s.version = "1.2.0"
+  s.version = "1.4.0"
   s.summary = "Enhanced Trailblazer operation utilities for Ruby applications with improved error handling, operation execution patterns, and ActiveRecord integration."
 
   s.authors = ["Hubbado Devs"]

data/lib/hubbado/trailblazer/run_operation.rb

@@ -16,6 +16,10 @@ module Hubbado
     #    result.raise_policy_failed
     #  end
     #
+    #  result.not_found do |ctx|
+    #    ...
+    #  end
+    #
     #  result.validation_failed do |ctx|
     #    ...
     #  end
@@ -34,6 +38,9 @@ module Hubbado
     # If there is a policy failure and you have not implemented
     # `result.policy_failed` then an exception will be raised.
     #
+    # If the operation has not_found terminus and you have not
+    # implemented `result.not_found` then ActiveRecord::RecordNotFound will be raised.
+    #
     # If the operation fails (due to non-policy error) and you have not
     # implemented `result.otherwise` then an exception will be raised.
     #
@@ -67,6 +74,10 @@ module Hubbado
         ctx
       end
 
+      template_method :policy_unauthorized_message do |ctx, operation_name:|
+        "User #{ctx[:current_user]&.id} not allowed to run #{operation_name}"
+      end
+
       def _run_runtime_options(ctx = {}, *dependencies)
         [_run_options(ctx), *dependencies]
       end
@@ -81,13 +92,23 @@ module Hubbado
 
         ctx = operation.send(operation_method, operation_arguments)
 
-        result = Result.new(operation, ctx, trace_operation)
+        result = Result.new(
+          operation,
+          ctx,
+          trace_operation: trace_operation,
+          policy_unauthorized_message: policy_unauthorized_message(
+            ctx,
+            operation_name: operation.name
+          )
+        )
 
         yield(result) if block_given?
 
         if ctx['result.policy.default']&.failure?
           result.raise_policy_failed unless result.policy_failed_executed?
-        elsif ctx.failure? && !result.validation_failed_executed? && !result.otherwise_executed?
+        elsif !result.not_found_executed? && ctx.terminus.to_h[:semantic] == :not_found
+          result.raise_not_found
+        elsif ctx.failure? && !result.validation_failed_executed? && !result.not_found_executed? && !result.otherwise_executed?
           result.raise_operation_failed
         end
 
@@ -99,11 +120,13 @@ module Hubbado
 
         attr_reader :returned
         attr_reader :trace_operation
+        attr_reader :policy_unauthorized_message
 
-        def initialize(operation, ctx, trace_operation)
+        def initialize(operation, ctx, trace_operation:, policy_unauthorized_message:)
           @operation = operation
           @ctx = ctx
           @trace_operation = trace_operation
+          @policy_unauthorized_message = policy_unauthorized_message
         end
 
         def log_level
@@ -159,6 +182,16 @@ module Hubbado
           @returned
         end
 
+        def not_found
+          return unless ctx.terminus.to_h[:semantic] == :not_found
+
+          @not_found_executed = true
+          @returned = yield(ctx)
+
+          logger.send(log_level, "Not found block executed for operation #{operation}")
+          @returned
+        end
+
         def otherwise
           return if executed?
 
@@ -169,6 +202,12 @@ module Hubbado
           @returned
         end
 
+        def raise_not_found
+          msg = "Record for operation #{operation.name} not found"
+
+          raise ActiveRecord::RecordNotFound, msg
+        end
+
         def raise_operation_failed
           msg = "Operation #{operation.name} failed"
 
@@ -182,13 +221,10 @@ module Hubbado
         end
 
         def raise_policy_failed
-          current_user = ctx[:current_user]
-          true_user = ctx[:true_user]
-
-          msg = "User #{current_user&.id}/#{true_user&.id} (#{current_user&.roles&.join ', '}) " \
-                "not allowed to run #{operation.name}"
-
-          raise Hubbado::Trailblazer::Errors::Unauthorized.new(msg, ctx['result.policy.default'][:policy_result])
+          raise Hubbado::Trailblazer::Errors::Unauthorized.new(
+            policy_unauthorized_message,
+            ctx['result.policy.default'][:policy_result]
+          )
         end
 
         def success_executed?
@@ -203,6 +239,10 @@ module Hubbado
           !!@validation_failed_executed
         end
 
+        def not_found_executed?
+          !!@not_found_executed
+        end
+
         def otherwise_executed?
           !!@otherwise_executed
         end
@@ -211,6 +251,7 @@ module Hubbado
           success_executed? ||
             policy_failed_executed? ||
             validation_failed_executed? ||
+            not_found_executed? ||
             otherwise_executed?
         end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hubbado-trailblazer
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Hubbado Devs
@@ -217,7 +217,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.1
 specification_version: 4
 summary: Enhanced Trailblazer operation utilities for Ruby applications with improved
   error handling, operation execution patterns, and ActiveRecord integration.