OptimizelyUserContext for the Android SDK

class OptimizelyUserContext(optimizely: Optimizely,
                            userId: String,
                            attributes: Map<String, Any?>?) {
    val userId: String
    val attributes: MutableMap<String?, Any?>

    // set an attribute for the user
    fun setAttribute(key: String, value: Any?)

    // make a decision about which flag variation the user buckets into for the flag key
    fun decide(key: String,
               options: List<OptimizelyDecideOption?>? = emptyList()): OptimizelyDecision

    // make decisions about which flag variations the user buckets into for flag keys
    fun decideForKeys(keys: List<String?>?,
                      options: List<OptimizelyDecideOption?>? = emptyList()): Map<String, OptimizelyDecision>

    // make decisions about which flag variations the user buckets into for all flags
    fun decideAll(options: List<OptimizelyDecideOption?>? = emptyList()): Map<String, OptimizelyDecision>

    // track user event
    fun trackEvent(eventName: String,
                   eventTags: Map<String?, *>? = emptyMap<String?, Any>())

    // sets a forced decision (variationKey) for a given decision context
    fun setForcedDecision(optimizelyDecisionContext: OptimizelyDecisionContext,
                          optimizelyForcedDecision: OptimizelyForcedDecision): Boolean

    // returns the forced decision (variationKey) for a given decision context
    fun getForcedDecision(optimizelyDecisionContext: OptimizelyDecisionContext): OptimizelyForcedDecision?

    // removes the forced decision (variationKey) for a given decision context
    fun removeForcedDecision(optimizelyDecisionContext: OptimizelyDecisionContext): Boolean

    // removes all the forced decisions (variationKeys) for the user context
    fun removeAllForcedDecisions(): Boolean
  
    //
    // The following methods require Real-Time Audiences for Feature Experimentation enabled. 
    // See note below code sample. 
    //

    // An array of audience names that the user is qualified for. 
    // The result of **fetchQualifiedSegments()** is saved here. 
    // Can be null if not properly updated with fetchQualifiedSegments(). 
    // 
    //  You can read and write directly to the qualified segments list. 
    //  This lets you bypass the remote fetching process from 
    //  Optimizely Data Platform or use your own fetching service.   
    var qualifiedSegments: MutableList<String>?

    // Fetch all qualified segments for the user context. 
    //
    // The segments fetched are saved in **qualifiedSegments** and can be accessed any time.
    // On failure, **qualifiedSegments** is null and one of the following errors are returned:
    // - OptimizelyError.invalidSegmentIdentifier
    // - OptimizelyError.fetchSegmentsFailed(String)
    //
    // Parameters:
    //   - options: A set of options for fetching qualified segments (optional).
    //   - completionHandler: A completion handler to be called with the fetch result. 
    //       - On success, it passes a non-null segments list (can be empty) with a null error. 
    //       - On failure, it passes a non-null error with a null segments list.
    fun fetchQualifiedSegments(options: List<OptimizelySegmentOption> = emptyList(),
                               completionHandler: (List<String>?, OptimizelyError?) -> Unit)


    // Check if the user is qualified for the given segment. 
    // - Parameter segment: the segment name to check qualification for.
    // - Returns: true if qualified.
    fun isQualifiedFor(segment: String): Boolean
}

public class OptimizelyUserContext {
    public String getUserId()
    public Map<String, Object> getAttributes()

    public OptimizelyUserContext(Optimizely optimizely, 
                                 String userId, 
                                 Map<String, Object> attributes)
      
    // set an attribute for the user
    public void setAttribute(String key, Object value)
    
    // make a decision about which flag variation the user buckets into for the flag key
    public OptimizelyDecision decide(String key, 
                                     List<OptimizelyDecideOption> options)
    
    // make decisions about which flag variations the user buckets into for flag keys  
    public Map<String, OptimizelyDecision> decideForKeys(List<String> keys, 
                                      List<OptimizelyDecideOption> options)
    
    // make decisions about which flag variations the user buckets into for all flags  
    public Map<String, OptimizelyDecision> decideAll(List<OptimizelyDecideOption> options)
    
    // track user event  
    public void trackEvent(String eventName, Map<String, ?> eventTags)
  
    // sets a forced decision (variationKey) for a given decision context
    public Boolean setForcedDecision(OptimizelyDecisionContext context, OptimizelyForcedDecision decision)

    // returns the forced decision (variationKey) for a given decision context
    public OptimizelyForcedDecision getForcedDecision(OptimizelyDecisionContext context)

    // removes the forced decision (variationKey) for a given decision context
    public Boolean removeForcedDecision(OptimizelyDecisionContext context)

    // removes all the forced decisions (variationKeys) for the user context
    public Boolean removeAllForcedDecisions()
    
      //
    // The following methods require Real-Time Audiences for Feature Experimentation 
    // integration enabled. See note below code sample. 
    //

    // An array of segment names that the user is qualified for. 
    // The result of **fetchQualifiedSegments()** will be saved here. 
    // Can be null if not properly updated with fetchQualifiedSegments(). 
    // 
    //  You can read and write directly to the qualified segments list. 
    //  This allows for bypassing the remote fetching process from ODP 
    //  or for utilizing your own fetching service.   
    public List<String> qualifiedSegments; 

    // Fetch all qualified segments for the user context. 
    //
    // The segments fetched will be saved in **qualifiedSegments** and can be accessed any time.
    // On failure, **qualifiedSegments** will be null and one of these errors will be returned:
    // - OptimizelyError.invalidSegmentIdentifier
    // - OptimizelyError.fetchSegmentsFailed(String)
    //
    // Parameters:
    //   - options: A set of options for fetching qualified segments (optional).
    //   - completionHandler: A completion handler to be called with the fetch result. On success, it passes a non-null segments list (can be empty) with a null error. On failure, it passes a non-null error with a null segments list.
    public void fetchQualifiedSegments(List<OptimizelySegmentOption> options,
                                       FetchQualifiedSegmentsCallback completionHandler)


    // Check if the user is qualified for the given segment. 
    // - Parameter segment: the segment name to check qualification for.
    // - Returns: true if qualified.
    public boolean isQualifiedFor(String segment)
    
}