groovestack-base 0.1.7 → 0.1.9

data/lib/groovestack/base/graphql/{tracers/atomic_multiplex_transaction.rb → tracers.rb}

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+# TODO: add specs
+
 module Groovestack
   module Base
     module GraphQL
@@ -19,23 +21,26 @@ module Groovestack
         # responds to `mutation?`.
 
         module AtomicMultiplexTransaction
-          # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity
-          def execute_multiplex(multiplex:)
-            is_mutation = multiplex.queries.any?(&:mutation?)
+          def execute_multiplex(multiplex:, &block)
+            return yield unless contains_mutation?(multiplex)
+
+            execute_with_transaction(&block)
+          end
 
-            return yield unless is_mutation
+          private
+
+          def contains_mutation?(multiplex)
+            multiplex.queries.any?(&:mutation?)
+          end
 
+          def execute_with_transaction
             results = nil
             rollback = false
 
             begin
               ::ActiveRecord::Base.transaction do
                 results = yield
-
-                rollback = results.any? do |result|
-                  result.is_a?(::GraphQL::Query::Result) && result.to_h['errors'].present?
-                end
-
+                rollback = results_errors?(results)
                 raise ::ActiveRecord::Rollback if rollback
 
                 results
@@ -44,10 +49,16 @@ module Groovestack
               rollback = true
             end
 
-            return results unless rollback
+            rollback ? handle_rollback(results) : results
+          end
 
-            # IF rollback, extract errors and return null for data
+          def results_errors?(results)
+            results.any? do |result|
+              result.is_a?(::GraphQL::Query::Result) && result.to_h['errors'].present?
+            end
+          end
 
+          def handle_rollback(results)
             results.map do |result|
               ::GraphQL::Query::Result.new(
                 query: result.query,
@@ -55,7 +66,6 @@ module Groovestack
               )
             end
           end
-          # rubocop:enable Metrics/AbcSize, Metrics/MethodLength, Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity
         end
       end
     end

data/lib/groovestack/base/graphql/types/aasm_event_attributes.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Groovestack
+  module Base
+    module GraphQL
+      module Types
+        module AASMEventAttributes
+          def all_events
+            object.class.aasm.events.map { |event| event.name.to_s }
+          end
+
+          def permitted_events
+            object.aasm.events(permitted: true).map { |event| event.name.to_s }
+          end
+
+          def status_events
+            all = all_events
+            permitted = permitted_events
+
+            all.map do |event|
+              { name: event.titleize, key: event, enabled: permitted.include?(event) }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/groovestack/base/graphql/types/currency.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Groovestack
+  module Base
+    module GraphQL
+      module Types
+        class Currency < ::Groovestack::Base::GraphQL::Base::Object
+          description 'A currency object'
+
+          field :code, String, null: false, description: 'currency code', method: :iso_code
+          field :symbol, String, null: false, description: 'currency symbol'
+        end
+      end
+    end
+  end
+end

data/lib/groovestack/base/graphql/types/money.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Groovestack
+  module Base
+    module GraphQL
+      module Types
+        class Money < ::Groovestack::Base::GraphQL::Base::Object
+          description 'A money object'
+
+          field :amount, String, null: false, description: 'amount in decimal'
+          field :currency, ::Groovestack::Base::GraphQL::Types::Currency, null: false, description: 'currency metadata'
+          field :formatted_amount, String, null: false,
+                                           description: 'amount in decimal formatted with currency symbol',
+                                           method: :format
+
+          def amount
+            object.amount.to_s
+          end
+        end
+      end
+    end
+  end
+end

data/lib/groovestack/base/graphql/types/subscription_payload.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Groovestack
+  module Base
+    module GraphQL
+      module Types
+        class SubscriptionPayload < ::Groovestack::Base::GraphQL::Base::Object
+          field :event, ::GraphQL::Types::JSON, null: false
+          field :subscription, String, null: false
+          field :subscription_args, ::GraphQL::Types::JSON, null: false
+        end
+      end
+    end
+  end
+end

data/lib/groovestack/base/graphql/types/type_resolver.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Groovestack
+  module Base
+    module GraphQL
+      module Types
+        module TypeResolver
+          extend ActiveSupport::Concern
+
+          included do
+            field :type, String, null: true, resolver_method: :object_type
+
+            def object_type
+              object.class.to_s if object.respond_to?(:class)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/groovestack/base/version.rb

@@ -2,6 +2,6 @@
 
 module Groovestack
   module Base
-    VERSION = '0.1.7'
+    VERSION = '0.1.9'
   end
 end

data/lib/groovestack/base.rb

@@ -12,27 +12,59 @@ require 'groovestack/base/utilities/string'
 module Groovestack
   module Base
     module GraphQL
-      module Subscriptions
-        autoload :EventHandler, 'groovestack/base/graphql/subscriptions/event_handler'
+      module Authorization
+        autoload :AuthorizedField, 'groovestack/base/graphql/authorization/authorized_field'
+        autoload :AuthorizedObject, 'groovestack/base/graphql/authorization/authorized_object'
+        autoload :VisibleField, 'groovestack/base/graphql/authorization/visible_field'
       end
 
-      autoload :Types, 'groovestack/base/graphql/types'
-      autoload :BaseInputObject, 'groovestack/base/graphql/base_input_object'
-      autoload :BaseMutation, 'groovestack/base/graphql/base_mutation'
-      autoload :Documentation, 'groovestack/base/graphql/documentation'
-      autoload :BaseSubscription, 'groovestack/base/graphql/base_subscription'
-      autoload :Helpers, 'groovestack/base/graphql/helpers'
+      module Base
+        autoload :Argument, 'groovestack/base/graphql/base/argument'
+        autoload :Field, 'groovestack/base/graphql/base/field'
+        autoload :Object, 'groovestack/base/graphql/base/object'
+        autoload :InputObject, 'groovestack/base/graphql/base/input_object'
+        autoload :Mutation, 'groovestack/base/graphql/base/mutation'
+        autoload :Subscription, 'groovestack/base/graphql/base/subscription'
+      end
 
-      module Tracers
-        autoload :AtomicMultiplexTransaction, 'groovestack/base/graphql/tracers/atomic_multiplex_transaction'
+      module Controllers
+        autoload :GraphQLController, 'groovestack/base/graphql/controllers/graphql_controller'
+      end
+
+      module Documentation
+        autoload :Arguments, 'groovestack/base/graphql/documentation/arguments'
+        autoload :Fields, 'groovestack/base/graphql/documentation/fields'
+      end
+
+      module Mutations
+        autoload :AASMEventTrigger, 'groovestack/base/graphql/mutations/aasm_event_trigger'
+        autoload :MethodTrigger, 'groovestack/base/graphql/mutations/method_trigger'
       end
 
       module Providers
         module ReactAdmin
-          autoload :Resource, 'groovestack/base/graphql/providers/react_admin/resource'
-          autoload :Types, 'groovestack/base/graphql/providers/react_admin/types'
+          autoload :Resource, 'groovestack/base/graphql/providers/react_admin'
+          module Types
+            autoload :RAListMetadata, 'groovestack/base/graphql/providers/react_admin'
+          end
         end
       end
+
+      module Subscriptions
+        autoload :Trigger, 'groovestack/base/graphql/subscriptions/trigger'
+      end
+
+      module Types
+        autoload :AASMEventAttributes, 'groovestack/base/graphql/types/aasm_event_attributes'
+        autoload :Currency, 'groovestack/base/graphql/types/currency'
+        autoload :Money, 'groovestack/base/graphql/types/money'
+        autoload :SubscriptionPayload, 'groovestack/base/graphql/types/subscription_payload'
+        autoload :TypeResolver, 'groovestack/base/graphql/types/type_resolver'
+      end
+
+      module Tracers
+        autoload :AtomicMultiplexTransaction, 'groovestack/base/graphql/tracers'
+      end
     end
 
     autoload :ActiveRecord, 'groovestack/base/active_record'
@@ -84,26 +116,49 @@ module Core
   module Base
     module GraphQL
       module Subscriptions
-        EventHandler = ::Groovestack::Base::GraphQL::Subscriptions::EventHandler
+        EventHandler = ::Groovestack::Base::GraphQL::Subscriptions::Trigger
       end
 
-      Types = ::Groovestack::Base::GraphQL::Types
-      BaseInputObject = ::Groovestack::Base::GraphQL::BaseInputObject
-      BaseMutation = ::Groovestack::Base::GraphQL::BaseMutation
-      Documentation = ::Groovestack::Base::GraphQL::Documentation
-      BaseSubscription = ::Groovestack::Base::GraphQL::BaseSubscription
-      Helpers = ::Groovestack::Base::GraphQL::Helpers
+      module Types
+        BaseArgument = ::Groovestack::Base::GraphQL::Base::Argument
+        BaseField = ::Groovestack::Base::GraphQL::Base::Field
+        BaseObject = ::Groovestack::Base::GraphQL::Base::Object
+        AuthorizedBaseField = ::Groovestack::Base::GraphQL::Authorization::AuthorizedField
+        AuthorizedBaseObject = ::Groovestack::Base::GraphQL::Authorization::AuthorizedObject
+        VisibleBaseField = ::Groovestack::Base::GraphQL::Authorization::VisibleField
+      end
+      BaseInputObject = ::Groovestack::Base::GraphQL::Base::InputObject
+      BaseMutation = ::Groovestack::Base::GraphQL::Base::Mutation
+      module Documentation
+        Arguments = ::Groovestack::Base::GraphQL::Documentation::Arguments
+        Fields = ::Groovestack::Base::GraphQL::Documentation::Fields
+      end
+      BaseSubscription = ::Groovestack::Base::GraphQL::Base::Subscription
+      module Helpers
+        module Types
+          StatusEventVirtualAttributes = ::Groovestack::Base::GraphQL::Types::AASMEventAttributes
+          Typified = ::Groovestack::Base::GraphQL::Types::TypeResolver
+        end
 
-      module Tracers
-        AtomicMultiplexTransaction = ::Groovestack::Base::GraphQL::Tracers::AtomicMultiplexTransaction
+        module Mutations
+          StatusEvents = ::Groovestack::Base::GraphQL::Mutations::AASMEventTrigger
+          InstanceMethods = ::Groovestack::Base::GraphQL::Mutations::MethodTrigger
+        end
+        Controller = ::Groovestack::Base::GraphQL::Controllers::GraphQLController
       end
 
       module Providers
         module ReactAdmin
           Resource = ::Groovestack::Base::GraphQL::Providers::ReactAdmin::Resource
-          Types = ::Groovestack::Base::GraphQL::Providers::ReactAdmin::Types
+          module Types
+            RAListMetadata = ::Groovestack::Base::GraphQL::Providers::ReactAdmin::Types::RAListMetadata
+          end
         end
       end
+
+      module Tracers
+        AtomicMultiplexTransaction = ::Groovestack::Base::GraphQL::Tracers::AtomicMultiplexTransaction
+      end
     end
 
     ActiveRecord = ::Groovestack::Base::ActiveRecord

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: groovestack-base
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.9
 platform: ruby
 authors:
 - Darren Rush
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-04-07 00:00:00.000000000 Z
+date: 2025-04-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -116,27 +116,39 @@ files:
 - groovestack-base.gemspec
 - lib/groovestack/base.rb
 - lib/groovestack/base/active_record.rb
-- lib/groovestack/base/graphql/base_input_object.rb
-- lib/groovestack/base/graphql/base_mutation.rb
-- lib/groovestack/base/graphql/base_subscription.rb
-- lib/groovestack/base/graphql/documentation.rb
-- lib/groovestack/base/graphql/helpers.rb
-- lib/groovestack/base/graphql/providers/react_admin/resource.rb
-- lib/groovestack/base/graphql/providers/react_admin/types.rb
-- lib/groovestack/base/graphql/subscriptions/event_handler.rb
-- lib/groovestack/base/graphql/tracers/atomic_multiplex_transaction.rb
-- lib/groovestack/base/graphql/types.rb
+- lib/groovestack/base/graphql/authorization/authorized_field.rb
+- lib/groovestack/base/graphql/authorization/authorized_object.rb
+- lib/groovestack/base/graphql/authorization/visible_field.rb
+- lib/groovestack/base/graphql/base/argument.rb
+- lib/groovestack/base/graphql/base/field.rb
+- lib/groovestack/base/graphql/base/input_object.rb
+- lib/groovestack/base/graphql/base/mutation.rb
+- lib/groovestack/base/graphql/base/object.rb
+- lib/groovestack/base/graphql/base/subscription.rb
+- lib/groovestack/base/graphql/controllers/graphql_controller.rb
+- lib/groovestack/base/graphql/documentation/arguments.rb
+- lib/groovestack/base/graphql/documentation/fields.rb
+- lib/groovestack/base/graphql/mutations/aasm_event_trigger.rb
+- lib/groovestack/base/graphql/mutations/method_trigger.rb
+- lib/groovestack/base/graphql/providers/react_admin.rb
+- lib/groovestack/base/graphql/subscriptions/trigger.rb
+- lib/groovestack/base/graphql/tracers.rb
+- lib/groovestack/base/graphql/types/aasm_event_attributes.rb
+- lib/groovestack/base/graphql/types/currency.rb
+- lib/groovestack/base/graphql/types/money.rb
+- lib/groovestack/base/graphql/types/subscription_payload.rb
+- lib/groovestack/base/graphql/types/type_resolver.rb
 - lib/groovestack/base/listeners.rb
 - lib/groovestack/base/pub_sub.rb
 - lib/groovestack/base/puma/plugin/core_cron.rb
 - lib/groovestack/base/railtie.rb
 - lib/groovestack/base/utilities/string.rb
 - lib/groovestack/base/version.rb
-homepage: https://github.com/talysto/groovestack-core/
+homepage: https://talysto.com/tech/groovestack/
 licenses: []
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/talysto/groovestack-core/
+  homepage_uri: https://talysto.com/tech/groovestack/
   source_code_uri: https://github.com/talysto/groovestack-core/
   changelog_uri: https://github.com/talysto/groovestack-core/
   rubygems_mfa_required: 'true'

data/lib/groovestack/base/graphql/base_input_object.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-module Groovestack
-  module Base
-    module GraphQL
-      class BaseInputObject < ::GraphQL::Schema::InputObject
-        argument_class ::Groovestack::Base::GraphQL::Types::BaseArgument
-      end
-    end
-  end
-end

data/lib/groovestack/base/graphql/base_mutation.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-module Groovestack
-  module Base
-    module GraphQL
-      class BaseMutation < ::GraphQL::Schema::Mutation
-        argument_class ::Groovestack::Base::GraphQL::Types::BaseArgument
-
-        def resolve(**args)
-          perform(**args)
-        rescue StandardError => e
-          Groovestack::Base.notify_error(self.class, e)
-
-          raise e
-        end
-
-        def perform(**args)
-          raise NotImplementedError
-        end
-      end
-    end
-  end
-end

data/lib/groovestack/base/graphql/base_subscription.rb

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-module Groovestack
-  module Base
-    module GraphQL
-      class BaseSubscription < ::GraphQL::Schema::Subscription
-        argument_class ::Groovestack::Base::GraphQL::Types::BaseArgument
-        field_class ::Groovestack::Base::GraphQL::Types::BaseField
-        object_class ::Groovestack::Base::GraphQL::Types::BaseObject
-      end
-    end
-  end
-end

data/lib/groovestack/base/graphql/helpers.rb

@@ -1,152 +0,0 @@
-# frozen_string_literal: true
-
-module Groovestack
-  module Base
-    module GraphQL
-      module Helpers
-        module Types
-          module StatusEventVirtualAttributes
-            def all_events
-              object.class.aasm.events.map { |event| event.name.to_s }
-            end
-
-            def permitted_events
-              object.aasm.events(permitted: true).map { |event| event.name.to_s }
-            end
-
-            def status_events
-              all = all_events
-              permitted = permitted_events
-
-              all.map do |event|
-                { name: event.titleize, key: event, enabled: permitted.include?(event) }
-              end
-            end
-          end
-
-          module Typified
-            extend ActiveSupport::Concern
-
-            included do
-              field :type, String, null: true, resolver_method: :object_type
-
-              def object_type
-                object.class.to_s if object.respond_to?(:class)
-              end
-            end
-          end
-        end
-
-        module Mutations
-          module StatusEvents
-            def trigger_status_event!(obj:, attrs:, event:, args: nil, authorization_policy: nil) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
-              # NOTE: args spread requires keys to be symbols, but by default
-              # they are passed as strings. This is why we use `symbolize_keys` here
-              raise ::GraphQL::ExecutionError, 'event not present' if event.blank?
-
-              event = event.gsub('!', '').to_sym
-
-              if attrs.present?
-                raise ::GraphQL::ExecutionError,
-                      'Cannot update multiple attributes when firing instance methods'
-              end
-              unless obj.aasm.events.map(&:name).include?(event)
-                raise ::GraphQL::ExecutionError,
-                      "#{event.capitalize} unavailable"
-              end
-              unless authorization_policy.nil? || authorization_policy.permitted_aasm_events.include?(event)
-                raise ::GraphQL::ExecutionError,
-                      "Unauthorized not allowed to #{event} this #{obj.class}"
-              end
-
-              event = :"#{event}!"
-
-              if args.present? && args.is_a?(Array)
-                obj.send(event.to_s, *args)
-              elsif args.present? && args.is_a?(Hash)
-                obj.send(event.to_s, **args.symbolize_keys!)
-              else
-                obj.send(event.to_s)
-              end
-            end
-          end
-
-          module InstanceMethods
-            def trigger_instance_method!(obj:, attrs:, instance_method:, args: nil, authorization_policy: nil) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
-              raise GraphQL::ExecutionError, 'instance_method not present' if instance_method.blank?
-
-              instance_method = instance_method.to_sym
-
-              raise ::GraphQL::ExecutionError, 'instance_method undefined' unless obj.respond_to?(instance_method)
-
-              if attrs.present?
-                raise ::GraphQL::ExecutionError,
-                      'Cannot update multiple attributes when triggering instance method'
-              end
-              unless authorization_policy.nil? || authorization_policy.permitted_instance_methods.include?(instance_method) # rubocop:disable Layout/LineLength
-                raise ::GraphQL::ExecutionError,
-                      "Unauthorized not allowed to trigger #{instance_method} for this #{obj.class}"
-              end
-
-              if args.present? && args.is_a?(Array)
-                obj.send(instance_method.to_s, *args)
-              elsif args.present? && args.is_a?(Hash)
-                obj.send(instance_method.to_s, **args.symbolize_keys!)
-              else
-                obj.send(instance_method.to_s)
-              end
-            end
-          end
-        end
-
-        module Controller
-          extend ActiveSupport::Concern
-
-          included do # rubocop:disable Metrics/BlockLength
-            private
-
-            def operation_name
-              params[:operationName]
-            end
-
-            def query
-              params[:query]
-            end
-
-            def variables
-              prepare_variables(params[:variables])
-            end
-
-            # Handle variables in form data, JSON body, or a blank value
-            def prepare_variables(variables_param)
-              case variables_param
-              when String
-                if variables_param.present?
-                  JSON.parse(variables_param) || {}
-                else
-                  {}
-                end
-              when Hash
-                variables_param
-              when ActionController::Parameters
-                variables_param.to_unsafe_hash # GraphQL-Ruby will validate name and type of incoming variables.
-              when nil
-                {}
-              else
-                raise ArgumentError, "Unexpected parameter: #{variables_param}"
-              end
-            end
-
-            def handle_error_in_development(err)
-              logger.error err.message
-              logger.error err.backtrace.join('\/n')
-
-              render json: { errors: [{ message: err.message, backtrace: err.backtrace }], data: {} },
-                     status: :internal_server_error
-            end
-          end
-        end
-      end
-    end
-  end
-end