Filter.h

// Copyright 2026 Stream.IO, Inc. All Rights Reserved.
 
#pragma once
 
#include "CoreMinimal.h"
 
#include "Filter.generated.h"
 
class FJsonValue;
class FJsonObject;
struct FJsonObjectWrapper;
 
enum class EFilterOperator : uint8
{
    None,
 
    Equal,
 
    NotEqual,
 
    Greater,
 
    GreaterOrEqual,
 
    Less,
 
    LessOrEqual,
 
    In,
 
    NotIn,
 
    Query,
 
    Autocomplete,
 
    Exists,
 
    And,
 
    Or,
 
    Nor,
 
    Contains,
};
 
USTRUCT(BlueprintType)
struct STREAMCHAT_API FFilter
{
    GENERATED_BODY()
 
    
    FFilter() = default;
    FJsonObjectWrapper ToJsonObjectWrapper() const;
    FString ToJson() const;
    TSharedRef<FJsonObject> ToJsonObject() const;
 
    static FFilter And(const TArray<FFilter>& Filters);
    static FFilter Or(const TArray<FFilter>& Filters);
    static FFilter Nor(const TArray<FFilter>& Filters);
 
    static FFilter Equal(const FName& Field, int32 Value);
    static FFilter Equal(const FName& Field, float Value);
    static FFilter Equal(const FName& Field, const TCHAR* Value);
    static FFilter Equal(const FName& Field, const FString& Value);
    static FFilter Equal(const FName& Field, bool bValue);
    static FFilter Equal(const FName& Field, TYPE_OF_NULLPTR);
    static FFilter NotEqual(const FName& Field, int32 Value);
    static FFilter NotEqual(const FName& Field, float Value);
    static FFilter NotEqual(const FName& Field, const TCHAR* Value);
    static FFilter NotEqual(const FName& Field, const FString& Value);
    static FFilter NotEqual(const FName& Field, bool bValue);
    static FFilter NotEqual(const FName& Field, TYPE_OF_NULLPTR);
    static FFilter Greater(const FName& Field, int32 Value);
    static FFilter Greater(const FName& Field, float Value);
    static FFilter Greater(const FName& Field, const FString& Value);
    static FFilter GreaterOrEqual(const FName& Field, int32 Value);
    static FFilter GreaterOrEqual(const FName& Field, float Value);
    static FFilter GreaterOrEqual(const FName& Field, const FString& Value);
    static FFilter Less(const FName& Field, int32 Value);
    static FFilter Less(const FName& Field, float Value);
    static FFilter Less(const FName& Field, const FString& Value);
    static FFilter LessOrEqual(const FName& Field, int32 Value);
    static FFilter LessOrEqual(const FName& Field, float Value);
    static FFilter LessOrEqual(const FName& Field, const FString& Value);
 
    static FFilter In(const FName& Field, const TArray<int32>& Values);
    static FFilter In(const FName& Field, const TArray<float>& Values);
    static FFilter In(const FName& Field, const TArray<FString>& Values);
    static FFilter NotIn(const FName& Field, const TArray<int32>& Values);
    static FFilter NotIn(const FName& Field, const TArray<float>& Values);
    static FFilter NotIn(const FName& Field, const TArray<FString>& Values);
 
    static FFilter Exists(const FName& Field, bool bValue);
 
    static FFilter Autocomplete(const FName& Field, const FString& Value);
 
    static FFilter Empty(const FName& Field);
 
    bool IsValid() const;
 
private:
    FFilter(EFilterOperator Operator, const TArray<FFilter>& Filters);
    FFilter(EFilterOperator Operator, const FName& Field, const TSharedPtr<FJsonValue>& Value);
 
    template <class T>
    static FFilter MakeComparison(EFilterOperator Operator, const FName& Field, T Value);
    static FFilter MakeComparison(EFilterOperator Operator, const FName& Field, const TCHAR* Value);
    static FFilter MakeComparison(EFilterOperator Operator, const FName& Field, const FString& Value);
    static FFilter MakeComparison(EFilterOperator Operator, const FName& Field, bool bValue);
    static FFilter MakeComparison(EFilterOperator Operator, const FName& Field, TYPE_OF_NULLPTR);
    template <class T>
    static FFilter MakeArrayComparison(EFilterOperator Operator, const FName& Field, const TArray<T>& Values);
    static FFilter MakeArrayComparison(EFilterOperator Operator, const FName& Field, const TArray<FString>& Values);
 
    EFilterOperator Operator;
    FName Field;
    TSharedPtr<FJsonValue> Value;
    TArray<FFilter> ChildFilters;
};