pragmarb/pragma-decorator

# frozen_string_literal: true

module Pragma
  module Decorator
    module Association
      # Holds the information about an association.
      #
      # @api private
      class Reflection
        # @!attribute [r] type
        #   @return [Symbol] the type of the association
        #
        # @!attribute [r] name
        #   @return [Symbol] the name of the association property
        #
        # @!attribute [r] attribute
        #   @return [Symbol] the attribute holding the associated object
        #
        # @!attribute [r] options
        #   @return [Hash] additional options for the association
        attr_reader :type, :name, :attribute, :options

        # Initializes the association.
        #
        # @param type [Symbol] the type of the association
        # @param attribute [Symbol] the attribute holding the associated object
        # @param options [Hash] additional options
        #
        # @option options [Class|Proc] :decorator the decorator to use for the associated object
        #   or a callable that will return the decorator class (or +nil+ to skip decoration)
        # @option options [Boolean] :render_nil (`true`) whether to render a +nil+ association
        # @option options [Symbol] :exec_context (`decorated`) whether to call the getter on the
        #   decorator (+decorator+) or the decorated object (+decorated+)
        def initialize(type:, name:, attribute:, **options)
          @type = type
          @name = name
          @attribute = attribute
          @options = options

          normalize_options
          validate_options
        end

        private

        def normalize_options
          @options = {
            render_nil: true,
            exec_context: :decorated
          }.merge(options).tap do |opts|
            opts[:exec_context] = opts[:exec_context].to_sym
          end
        end

        def validate_options
          unless %i[decorator decorated].include?(options[:exec_context])
            fail(
              ArgumentError,
              "'#{options[:exec_context]}' is not a valid value for :exec_context."
            )
          end

          unless options[:decorator]
            fail(
              ArgumentError,
              'The :decorator option is required.'
            )
          end
        end
      end
    end
  end
end