// 
// Copyright 2023 New Vector Ltd
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//

import Foundation
import CryptoKit

/// Object encapsulating an experiment with an arbitrary number of variants, and a method to deterministically
/// and uniformly assign a variant to user. Variants do not carry any implicit semantics, they are plain numbers
/// to be interpreted by the caller of the experiment.
struct Experiment {
    let name: String
    let variants: UInt
    
    /// Get the assigned variant from the total number of variants and for a given `userId`
    ///
    /// This variant is chosen deterministically (the same `userId` and experiment `name` will yield the same variant)
    /// and uniformly (multiple users are distributed roughly evenly among the variants).
    func variant(userId: String) -> UInt {
        // Combine user id with experiment name to avoid identical variant
        // for the same user in different experiments
        let data = (userId + name).data(using: .utf8) ?? Data()
        
        // Get the first 8 bytes and map to decimal number (UInt64 = 8 bytes)
        let decimal = digest(for: data)
            .prefix(8)
            .reduce(0) { $0 << 8 | UInt64($1) }
        
        // Compress the decimal into a set number of variants using modulo
        return UInt(decimal % UInt64(variants))
    }
    
    private func digest(for data: Data) -> SHA256.Digest {
        var sha = SHA256()
        sha.update(data: data)
        return sha.finalize()
    }
}
