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

package io.ktor.server.http

import io.ktor.http.*
import io.ktor.server.application.*
import io.ktor.server.response.*
import io.ktor.util.*
import io.ktor.utils.io.*

/**
 * Produces HTTP/2 push from server to client or sets HTTP/1.x hint header
 * or does nothing.
 * Exact behaviour is up to engine implementation.
 *
 * [Report a problem](https://ktor.io/feedback/?fqname=io.ktor.server.http.push)
 */
@UseHttp2Push
public fun ApplicationCall.push(pathAndQuery: String) {
    val (path, query) = pathAndQuery.chomp("?") { pathAndQuery to "" }
    push(path, parseQueryString(query, decode = false))
}

/**
 * Produces HTTP/2 push from server to client or sets HTTP/1.x hint header
 * or does nothing.
 * Exact behaviour is up to engine implementation.
 *
 * [Report a problem](https://ktor.io/feedback/?fqname=io.ktor.server.http.push)
 */
@UseHttp2Push
public fun ApplicationCall.push(encodedPath: String, encodedParameters: Parameters) {
    push {
        url.encodedPath = encodedPath
        url.encodedParameters.clear()
        url.encodedParameters.appendAll(encodedParameters)
    }
}

/**
 * Produces HTTP/2 push from server to client or sets HTTP/1.x hint header
 * or does nothing (may call or not call [block]).
 * Exact behaviour is up to engine implementation.
 *
 * [Report a problem](https://ktor.io/feedback/?fqname=io.ktor.server.http.push)
 */
@OptIn(InternalAPI::class)
@UseHttp2Push
public fun ApplicationCall.push(block: ResponsePushBuilder.() -> Unit) {
    response.push(DefaultResponsePushBuilder(this).apply(block))
}
