/*
 * Copyright 2014-2019 JetBrains s.r.o and contributors. Use of this source code is governed by the Apache 2.0 license.
 */

package io.ktor.sessions

/**
 * Represents a session cookie transformation. Useful for such things like signing and encryption
 */
public interface SessionTransportTransformer {
    /**
     * Un-apply a transformation for [transportValue] representing a transformed session.
     * Returns null if it fails.
     *
     * @return Untransformed value or null
     */
    public fun transformRead(transportValue: String): String?

    /**
     * Apply a transformation for [transportValue] representing a session.
     *
     * @return Transformed value
     */
    public fun transformWrite(transportValue: String): String
}

/**
 * Un-applies a list of session transformations to a [cookieValue] representing a transformed session string.
 * If any of the unapplication of transformations fail returning a null, this function also returns null.
 *
 * @return A string representing the original session contents.
 */
public fun List<SessionTransportTransformer>.transformRead(cookieValue: String?): String? {
    val value = cookieValue ?: return null
    return this.asReversed().fold(value) { v, t -> t.transformRead(v) ?: return null }
}

/**
 * Applies a list of session transformations to a [value] representing session string.
 *
 * @return A string containing all the transformations applied.
 */
public fun List<SessionTransportTransformer>.transformWrite(value: String): String {
    return fold(value) { it, transformer -> transformer.transformWrite(it) }
}
