queries_engine.rb

# frozen_string_literal: true

module Queries
  # The Engine module provides a structure for executing queries against
  # a given model with a defined set of parameters and conditions.
  module Engine
    def self.call(**kwargs)
      new(**kwargs).call
    end

    def initialize(params:, type: :group)
      @params = params.sanitize!
      @type = type
    end

    # Executes the query and handles success or failure.
    #
    # @return [Context] The context containing the result of the query.
    def call
      safely_execute do
        relation = scope!(klass.where(params.conditions).includes(params.includes))
        raise ActiveRecord::RecordNotFound if single? && relation&.empty?

        context.succeed(single? ? relation.first : relation)
      end
    end

    private

    attr_reader :params, :type
  end
end