feat: moved-mappers-to-engine-namespace

Author: Zaimwa9

lib/flagsmith/engine/core.rb

@@ -11,7 +11,7 @@
 require_relative 'segments/evaluator'
 require_relative 'segments/models'
 require_relative 'utils/hash_func'
-require_relative 'evaluation/mappers'
+require_relative 'mappers'
 require_relative 'evaluation/core'
 
 module Flagsmith

lib/flagsmith/engine/environments/models.rb

@@ -8,14 +8,16 @@ class Environment
       attr_accessor :project, :feature_states, :amplitude_config, :segment_config,
                     :mixpanel_config, :heap_config, :identity_overrides
 
-      def initialize(id:, api_key:, name: nil, project:, feature_states: [], identity_overrides: [])
+      # rubocop:disable Metrics/ParameterLists
+      def initialize(id:, api_key:, project:, name: nil, feature_states: [], identity_overrides: [])
         @id = id
         @api_key = api_key
         @name = name
         @project = project
         @feature_states = feature_states
         @identity_overrides = identity_overrides
       end
+      # rubocop:enable Metrics/ParameterLists
 
       class << self
         # rubocop:disable Metrics/MethodLength

lib/flagsmith/engine/evaluation/mappers.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require_relative 'mappers/environment'
+require_relative 'mappers/identity'
+require_relative 'mappers/segments'
+
+module Flagsmith
+  module Engine
+    # Mappers for converting between models and evaluation contexts
+    module Mappers
+      STRONGEST_PRIORITY = Float::INFINITY
+      WEAKEST_PRIORITY = -Float::INFINITY
+
+      # @param environment [Flagsmith::Engine::Environment] The environment model
+      # @param identity [Flagsmith::Engine::Identity, nil] Optional identity model
+      # @param override_traits [Array<Flagsmith::Engine::Identities::Trait>, nil] Optional override traits
+      # @return [Hash] Evaluation context with environment, features, segments, and optionally identity
+      def self.get_evaluation_context(environment, identity = nil, override_traits = nil)
+        context = map_environment_model_to_evaluation_context(environment)
+        context[:identity] = map_identity_model_to_identity_context(identity, override_traits) if identity
+        context
+      end
+
+      # Maps environment model to evaluation context
+      #
+      # @param environment [Flagsmith::Engine::Environment] The environment model
+      # @return [Hash] Context with :environment, :features, and :segments keys
+      def self.map_environment_model_to_evaluation_context(environment)
+        context = {
+          environment: Environment.build_environment_context(environment),
+          features: Environment.build_features_context(environment.feature_states),
+          segments: Segments.build_segments_context(environment.project.segments)
+        }
+
+        context[:segments].merge!(Identity.map_overrides_to_segments(environment.identity_overrides)) if environment.identity_overrides&.any?
+
+        context
+      end
+
+      # Maps identity model to identity context
+      #
+      # @param identity [Flagsmith::Engine::Identity] The identity model
+      # @param override_traits [Array<Flagsmith::Engine::Identities::Trait>, nil] Optional override traits
+      # @return [Hash] Identity context with :identifier, :key, and :traits
+      def self.map_identity_model_to_identity_context(identity, override_traits = nil)
+        Identity.build_environment_context(identity, override_traits)
+      end
+
+      # Maps segment rule model to rule hash
+      #
+      # @param rule [Flagsmith::Engine::Segments::Rule] The segment rule model
+      # @return [Hash] Mapped rule with :type, :conditions, and :rules
+      def self.map_segment_rule_model_to_rule(rule)
+        Segments.map_rule(rule)
+      end
+
+      # Maps identity overrides to segments
+      #
+      # @param identity_overrides [Array<Flagsmith::Engine::Identity>] Array of identity override models
+      # @return [Hash] Segments hash for identity overrides
+      def self.map_identity_overrides_to_segments(identity_overrides)
+        Identity.map_overrides_to_segments(identity_overrides)
+      end
+    end
+  end
+end