feat: add segment IN operator (#72)

feat: add segment `IN` operator

Author: khvn26

src/Engine/Segments/SegmentConditionModel.php

@@ -80,13 +80,14 @@ public function matchesTraitValue($traitValue): bool
     {
         $condition = false;
         $castedValue = $this->value;
+        $traitValueType = gettype($traitValue);
 
-        if ('boolean' === gettype($traitValue)) {
+        if ($traitValueType == 'boolean') {
             $castedValue = filter_var($castedValue, FILTER_VALIDATE_BOOLEAN);
         } elseif ($this->operator === SegmentConditions::MODULO) {
             return $this->matchesModuloTraitValue($traitValue);
         } else {
-            settype($castedValue, gettype($traitValue));
+            settype($castedValue, $traitValueType);
         }
 
         if (is_string($castedValue) && Semver::isSemver($castedValue)) {
@@ -126,6 +127,11 @@ public function matchesTraitValue($traitValue): bool
                 $matchesCount = preg_match_all("/{$castedValue}/", (string) $traitValue);
                 $condition = $matchesCount && $matchesCount > 0;
                 break;
+            case (SegmentConditions::IN):
+                if (in_array($traitValueType, ['string', 'integer'])) {
+                    $condition = in_array((string) $traitValue, explode(',', (string) $this->value));
+                }
+                break;
         }
 
         return $condition;

src/Engine/Segments/SegmentConditions.php

@@ -17,4 +17,5 @@ class SegmentConditions
     public const IS_SET = 'IS_SET';
     public const IS_NOT_SET = 'IS_NOT_SET';
     public const MODULO = 'MODULO';
+    public const IN = 'IN';
 }

tests/Engine/Unit/Segments/SegmentModelsTest.php

@@ -59,6 +59,18 @@ public function conditionParametersTraitValues()
             [SegmentConditions::NOT_CONTAINS, 'bar', 'b', false],
             [SegmentConditions::NOT_CONTAINS, 'bar', 'bar', false],
             [SegmentConditions::NOT_CONTAINS, 'bar', 'baz', true],
+            [SegmentConditions::IN, 'foo', '', false],
+            [SegmentConditions::IN, 'ba', 'foo,bar', false],
+            [SegmentConditions::IN, 'foo', 'foo,bar', true],
+            [SegmentConditions::IN, 'bar', 'foo,bar', true],
+            [SegmentConditions::IN, 'foo', 'foo', true],
+            [SegmentConditions::IN, 1, '1,2,3,4', true],
+            [SegmentConditions::IN, 1, '', false],
+            [SegmentConditions::IN, 1, '1', true],
+            // Flagsmith's engine does not evaluate `IN` condition for floats/doubles and booleans
+            // due to ambiguous serialization across supported platforms.
+            [SegmentConditions::IN, 1.5, '1.5', false],
+            [SegmentConditions::IN, false, 'false', false],
             [SegmentConditions::REGEX, 'foo', '[a-z]+', true],
             [SegmentConditions::REGEX, 'FOO', '[a-z]+', false],
             [SegmentConditions::REGEX, '1.2.3', '\\d', true],