feat(products): add rate card GraphQL mutations and resolvers

## Context

GraphQL surface for rate cards and their rates, powering the rate cards tabs of
the catalog and the rate timeline management.

## Description

Add the RateCard and RateCardRate object types with their enums (status exposed
as a derived value), create/update inputs, Create/Update/Destroy mutations for
both entities backed by the services, and single + collection rate card
resolvers with pagination, search and product item scoping. Rate cards are
exposed on the ProductItem type and join the activity log resource union; a
rate_cards permission family is registered. Regenerate the GraphQL schema dumps.

Author: rsempe

app/graphql/mutations/rate_card_rates/create.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Mutations
+  module RateCardRates
+    class Create < BaseMutation
+      include AuthenticableApiUser
+      include RequiredOrganization
+
+      REQUIRED_PERMISSION = "rate_cards:create"
+
+      graphql_name "CreateRateCardRate"
+      description "Adds a rate to a rate card"
+
+      input_object_class Types::RateCardRates::CreateInput
+      type Types::RateCardRates::Object
+
+      def resolve(**args)
+        rate_card = current_organization.rate_cards.find_by(id: args[:rate_card_id])
+        result = ::RateCardRates::CreateService.call(rate_card:, params: args.except(:rate_card_id))
+
+        result.success? ? result.rate_card_rate : result_error(result)
+      end
+    end
+  end
+end

app/graphql/mutations/rate_card_rates/destroy.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Mutations
+  module RateCardRates
+    class Destroy < BaseMutation
+      include AuthenticableApiUser
+      include RequiredOrganization
+
+      REQUIRED_PERMISSION = "rate_cards:delete"
+
+      graphql_name "DestroyRateCardRate"
+      description "Deletes a pending rate of a rate card"
+
+      argument :id, ID, required: true
+
+      field :id, ID, null: true
+
+      def resolve(id:)
+        rate_card_rate = current_organization.rate_card_rates.find_by(id:)
+        result = ::RateCardRates::DestroyService.call(rate_card_rate:)
+
+        result.success? ? result.rate_card_rate : result_error(result)
+      end
+    end
+  end
+end

app/graphql/mutations/rate_card_rates/update.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Mutations
+  module RateCardRates
+    class Update < BaseMutation
+      include AuthenticableApiUser
+      include RequiredOrganization
+
+      REQUIRED_PERMISSION = "rate_cards:update"
+
+      graphql_name "UpdateRateCardRate"
+      description "Updates a rate of a rate card"
+
+      input_object_class Types::RateCardRates::UpdateInput
+      type Types::RateCardRates::Object
+
+      def resolve(**args)
+        rate_card_rate = current_organization.rate_card_rates.find_by(id: args[:id])
+        result = ::RateCardRates::UpdateService.call(rate_card_rate:, params: args.except(:id))
+
+        result.success? ? result.rate_card_rate : result_error(result)
+      end
+    end
+  end
+end

app/graphql/mutations/rate_cards/create.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Mutations
+  module RateCards
+    class Create < BaseMutation
+      include AuthenticableApiUser
+      include RequiredOrganization
+
+      REQUIRED_PERMISSION = "rate_cards:create"
+
+      graphql_name "CreateRateCard"
+      description "Creates a new rate card"
+
+      input_object_class Types::RateCards::CreateInput
+      type Types::RateCards::Object
+
+      def resolve(**args)
+        product_item = current_organization.product_items.find_by(id: args[:product_item_id])
+
+        params = args.except(:product_item_id)
+        params[:rates] = params[:rates].map(&:to_h) if params[:rates]
+
+        result = ::RateCards::CreateService.call(product_item:, params:)
+
+        result.success? ? result.rate_card : result_error(result)
+      end
+    end
+  end
+end

app/graphql/mutations/rate_cards/destroy.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Mutations
+  module RateCards
+    class Destroy < BaseMutation
+      include AuthenticableApiUser
+      include RequiredOrganization
+
+      REQUIRED_PERMISSION = "rate_cards:delete"
+
+      graphql_name "DestroyRateCard"
+      description "Deletes a rate card"
+
+      argument :id, ID, required: true
+
+      field :id, ID, null: true
+
+      def resolve(id:)
+        rate_card = current_organization.rate_cards.find_by(id:)
+        result = ::RateCards::DestroyService.call(rate_card:)
+
+        result.success? ? result.rate_card : result_error(result)
+      end
+    end
+  end
+end

app/graphql/mutations/rate_cards/update.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Mutations
+  module RateCards
+    class Update < BaseMutation
+      include AuthenticableApiUser
+      include RequiredOrganization
+
+      REQUIRED_PERMISSION = "rate_cards:update"
+
+      graphql_name "UpdateRateCard"
+      description "Updates an existing rate card"
+
+      input_object_class Types::RateCards::UpdateInput
+      type Types::RateCards::Object
+
+      def resolve(**args)
+        rate_card = current_organization.rate_cards.find_by(id: args[:id])
+        result = ::RateCards::UpdateService.call(rate_card:, params: args.except(:id))
+
+        result.success? ? result.rate_card : result_error(result)
+      end
+    end
+  end
+end

app/graphql/resolvers/rate_card_resolver.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Resolvers
+  class RateCardResolver < Resolvers::BaseResolver
+    include AuthenticableApiUser
+    include RequiredOrganization
+
+    REQUIRED_PERMISSION = "rate_cards:view"
+
+    description "Query a single rate card of an organization"
+
+    argument :id, ID, required: true, description: "Uniq ID of the rate card"
+
+    type Types::RateCards::Object, null: true
+
+    def resolve(id: nil)
+      current_organization.rate_cards.find(id)
+    rescue ActiveRecord::RecordNotFound
+      not_found_error(resource: "rate_card")
+    end
+  end
+end

app/graphql/resolvers/rate_cards_resolver.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Resolvers
+  class RateCardsResolver < Resolvers::BaseResolver
+    include AuthenticableApiUser
+    include RequiredOrganization
+
+    REQUIRED_PERMISSION = "rate_cards:view"
+
+    description "Query rate cards of an organization"
+
+    argument :limit, Integer, required: false
+    argument :page, Integer, required: false
+    argument :product_item_id, ID, required: false
+    argument :search_term, String, required: false
+
+    type Types::RateCards::Object.collection_type, null: false
+
+    def resolve(page: nil, limit: nil, search_term: nil, product_item_id: nil)
+      result = ::RateCardsQuery.call(
+        organization: current_organization,
+        search_term:,
+        pagination: {page:, limit:},
+        filters: {product_item_id:}
+      )
+
+      result.rate_cards
+    end
+  end
+end

app/graphql/types/activity_logs/resource_object.rb

@@ -21,7 +21,8 @@ class ResourceObject < Types::BaseUnion
         Types::Entitlement::FeatureObject,
         Types::Products::Object,
         Types::ProductItems::Object,
-        Types::ProductItemFilters::Object
+        Types::ProductItemFilters::Object,
+        Types::RateCards::Object
 
       def self.resolve_type(object, _context)
         case object.class.to_s
@@ -55,6 +56,8 @@ def self.resolve_type(object, _context)
           Types::ProductItems::Object
         when "ProductItemFilter"
           Types::ProductItemFilters::Object
+        when "RateCard"
+          Types::RateCards::Object
         else
           raise "Unexpected activity log resource type: #{object.inspect}"
         end

app/graphql/types/mutation_type.rb

@@ -243,6 +243,14 @@ class MutationType < Types::BaseObject
     field :destroy_product_item_filter, mutation: Mutations::ProductItemFilters::Destroy
     field :update_product_item_filter, mutation: Mutations::ProductItemFilters::Update
 
+    field :create_rate_card, mutation: Mutations::RateCards::Create
+    field :destroy_rate_card, mutation: Mutations::RateCards::Destroy
+    field :update_rate_card, mutation: Mutations::RateCards::Update
+
+    field :create_rate_card_rate, mutation: Mutations::RateCardRates::Create
+    field :destroy_rate_card_rate, mutation: Mutations::RateCardRates::Destroy
+    field :update_rate_card_rate, mutation: Mutations::RateCardRates::Update
+
     field :create_role, mutation: Mutations::Roles::Create
     field :destroy_role, mutation: Mutations::Roles::Destroy
     field :update_role, mutation: Mutations::Roles::Update