CHANGELOG.md

@@ -1,97 +1,3 @@
-# [1.6.0](https://github.com/ReVanced/revanced-api/compare/v1.5.0...v1.6.0) (2025-02-04)
-
-
-### Features
-
-* Add status page link to about ([8a957cd](https://github.com/ReVanced/revanced-api/commit/8a957cd797e7e42f43670baaed60ac0d3543342f))
-* Add support for prereleases ([c25bc8b](https://github.com/ReVanced/revanced-api/commit/c25bc8b4ba2bd4bf1708f19dc8bc228a7f54d548))
-* Allow setting `Announcement.createdAt` when creating an announcement ([7f6e29d](https://github.com/ReVanced/revanced-api/commit/7f6e29de5205f63ac4aaea490c844b58e14000c8))
-* Make some announcements schema fields nullable ([db22874](https://github.com/ReVanced/revanced-api/commit/db22874f063bae0c9e7f0c99a20cdf1b16addd89))
-
-# [1.6.0-dev.3](https://github.com/ReVanced/revanced-api/compare/v1.6.0-dev.2...v1.6.0-dev.3) (2024-12-25)
-
-
-### Features
-
-* Add status page link to about ([8a957cd](https://github.com/ReVanced/revanced-api/commit/8a957cd797e7e42f43670baaed60ac0d3543342f))
-* Add support for prereleases ([c25bc8b](https://github.com/ReVanced/revanced-api/commit/c25bc8b4ba2bd4bf1708f19dc8bc228a7f54d548))
-
-# [1.6.0-dev.2](https://github.com/ReVanced/revanced-api/compare/v1.6.0-dev.1...v1.6.0-dev.2) (2024-12-20)
-
-
-### Features
-
-* Make some announcements schema fields nullable ([db22874](https://github.com/ReVanced/revanced-api/commit/db22874f063bae0c9e7f0c99a20cdf1b16addd89))
-
-# [1.6.0-dev.1](https://github.com/ReVanced/revanced-api/compare/v1.5.0...v1.6.0-dev.1) (2024-11-23)
-
-
-### Features
-
-* Allow setting `Announcement.createdAt` when creating an announcement ([7f6e29d](https://github.com/ReVanced/revanced-api/commit/7f6e29de5205f63ac4aaea490c844b58e14000c8))
-
-# [1.5.0](https://github.com/ReVanced/revanced-api/compare/v1.4.0...v1.5.0) (2024-11-06)
-
-
-### Features
-
-* Allow updating `createdAt` field for announcements ([58ba4cb](https://github.com/ReVanced/revanced-api/commit/58ba4cb11c789507826cd70ac548943a94da4223))
-* Move spec url to versioned path ([e871b23](https://github.com/ReVanced/revanced-api/commit/e871b23210798723c34bce93c7567d8fbcf4e060))
-* Simplify log pattern ([d5d9e04](https://github.com/ReVanced/revanced-api/commit/d5d9e04325fa93540be0438e7b51243e2aeeab3d))
-
-# [1.5.0-dev.2](https://github.com/ReVanced/revanced-api/compare/v1.5.0-dev.1...v1.5.0-dev.2) (2024-11-06)
-
-
-### Features
-
-* Allow updating `createdAt` field for announcements ([58ba4cb](https://github.com/ReVanced/revanced-api/commit/58ba4cb11c789507826cd70ac548943a94da4223))
-* Simplify log pattern ([d5d9e04](https://github.com/ReVanced/revanced-api/commit/d5d9e04325fa93540be0438e7b51243e2aeeab3d))
-
-# [1.5.0-dev.1](https://github.com/ReVanced/revanced-api/compare/v1.4.0...v1.5.0-dev.1) (2024-11-06)
-
-
-### Features
-
-* Move spec url to versioned path ([e871b23](https://github.com/ReVanced/revanced-api/commit/e871b23210798723c34bce93c7567d8fbcf4e060))
-* Simplify log pattern ([d5d9e04](https://github.com/ReVanced/revanced-api/commit/d5d9e04325fa93540be0438e7b51243e2aeeab3d))
-
-# [1.5.0-dev.1](https://github.com/ReVanced/revanced-api/compare/v1.4.0...v1.5.0-dev.1) (2024-11-06)
-
-
-### Features
-
-* Move spec url to versioned path ([e871b23](https://github.com/ReVanced/revanced-api/commit/e871b23210798723c34bce93c7567d8fbcf4e060))
-
-# [1.4.0](https://github.com/ReVanced/revanced-api/compare/v1.3.0...v1.4.0) (2024-11-06)
-
-
-### Bug Fixes
-
-* Add missing logging level environment variable to .env.example ([3b62120](https://github.com/ReVanced/revanced-api/commit/3b6212065a5cfb95c303b6d0551747ba1eb317f6))
-* Use new patches file extension ([d42a3a3](https://github.com/ReVanced/revanced-api/commit/d42a3a393396a0f4e9085cda46e0af2c12b63cb1))
-
-
-### Features
-
-* Add URL and use friendly name for `APIContributable` ([a5498ab](https://github.com/ReVanced/revanced-api/commit/a5498aba2b99db89c28a65738cc58cc4c852c327))
-* Allow versioning by arbitrary path string ([814d3c9](https://github.com/ReVanced/revanced-api/commit/814d3c946e31068e12e3886aa8beb3238ef126ae))
-* Improve announcements API ([#192](https://github.com/ReVanced/revanced-api/issues/192)) ([56a00dd](https://github.com/ReVanced/revanced-api/commit/56a00ddb85f302d441f0b222a9902ea2c1c18897))
-* Make backend configurable ([f91f3a6](https://github.com/ReVanced/revanced-api/commit/f91f3a65c5e07b5b58ccbff1d4b0a5ba9b15fc50))
-* Remove "archived" query parameter ([8ad614e](https://github.com/ReVanced/revanced-api/commit/8ad614ef4fdaf45af87a3316ef4db7e7236fd64a))
-* Remove deprecated routes and old API ([eca40a6](https://github.com/ReVanced/revanced-api/commit/eca40a69799240f7803aa8851eb3ee961937e4d6))
-* Remove ReVanced Integrations ([f1c1092](https://github.com/ReVanced/revanced-api/commit/f1c10928ae3be1c6b1d675819755b3046fad70d8))
-* Use tag name directly instead of ID ([fc40427](https://github.com/ReVanced/revanced-api/commit/fc40427fbaafb523045eb6f5285d90949b206b8b))
-
-# [1.4.0-dev.6](https://github.com/ReVanced/revanced-api/compare/v1.4.0-dev.5...v1.4.0-dev.6) (2024-11-06)
-
-
-### Features
-
-* Allow versioning by arbitrary path string ([814d3c9](https://github.com/ReVanced/revanced-api/commit/814d3c946e31068e12e3886aa8beb3238ef126ae))
-* Remove deprecated routes and old API ([eca40a6](https://github.com/ReVanced/revanced-api/commit/eca40a69799240f7803aa8851eb3ee961937e4d6))
-
-# [1.4.0-dev.5](https://github.com/ReVanced/revanced-api/compare/v1.4.0-dev.4...v1.4.0-dev.5) (2024-11-05)
-
 # [1.4.0-dev.4](https://github.com/ReVanced/revanced-api/compare/v1.4.0-dev.3...v1.4.0-dev.4) (2024-11-01)
 
 

README.md

@@ -81,6 +81,7 @@ Some of the features ReVanced API include:
   and links of the hoster of ReVanced API
 - 🧩 **Patches**: Get the latest updates of ReVanced Patches, directly from ReVanced API
 - 👥 **Contributors**: List all contributors involved in the project
+- 🔄 **Backwards compatibility**: Proxy an old API for migration purposes and backwards compatibility
 
 ## 🚀 How to get started
 

about.example.json

@@ -5,7 +5,6 @@
   "branding": {
     "logo": "https://raw.githubusercontent.com/ReVanced/revanced-branding/main/assets/revanced-logo/revanced-logo.svg"
   },
-  "status": "https://status.revanced.app",
   "contact": {
     "email": "contact@revanced.app"
   },

configuration.example.toml

@@ -1,9 +1,10 @@
-api-version = "v1"
+api-version = 1
 cors-allowed-hosts = [
     "revanced.app",
     "*.revanced.app"
 ]
 endpoint = "https://api.revanced.app"
+old-api-endpoint = "https://old-api.revanced.app"
 static-files-path = "static/root"
 versioned-static-files-path = "static/versioned"
 backend-service-name = "GitHub"

gradle.properties

@@ -1,4 +1,4 @@
 org.gradle.parallel = true
 org.gradle.caching = true
 kotlin.code.style = official
-version = 1.6.0
+version = 1.4.0-dev.4

gradle/libs.versions.toml

@@ -1,6 +1,6 @@
 [versions]
 kompendium-core = "3.14.4"
-kotlin = "2.0.20"
+kotlin = "2.0.0"
 logback = "1.5.6"
 exposed = "0.52.0"
 h2 = "2.2.224"
@@ -10,8 +10,8 @@ ktor = "2.3.7"
 ktoml = "0.5.2"
 picocli = "4.7.6"
 datetime = "0.6.0"
-revanced-patcher = "21.0.0"
+revanced-patcher = "20.0.0"
-revanced-library = "3.0.2"
+revanced-library = "3.0.1-dev.1"
 caffeine = "3.1.8"
 bouncy-castle = "1.78.1"
 

src/main/kotlin/app/revanced/api/configuration/Dependencies.kt

@@ -51,6 +51,7 @@ fun Application.configureDependencies(
 
             AuthenticationService(issuer, validityInMin, jwtSecret, authSHA256DigestString)
         }
+        singleOf(::OldApiService)
         singleOf(::AnnouncementService)
         singleOf(::SignatureService)
         singleOf(::PatchesService)

src/main/kotlin/app/revanced/api/configuration/HTTP.kt

@@ -11,7 +11,7 @@ import org.koin.ktor.ext.get
 import kotlin.time.Duration.Companion.minutes
 
 fun Application.configureHTTP() {
-    val configuration = get<ConfigurationRepository>()
+    val configurationRepository = get<ConfigurationRepository>()
 
     install(CORS) {
         HttpMethod.DefaultMethods.minus(HttpMethod.Options).forEach(::allowMethod)
@@ -22,7 +22,7 @@ fun Application.configureHTTP() {
 
         allowCredentials = true
 
-        configuration.corsAllowedHosts.forEach { host ->
+        configurationRepository.corsAllowedHosts.forEach { host ->
             allowHost(host = host, schemes = listOf("https"))
         }
     }

src/main/kotlin/app/revanced/api/configuration/OpenAPI.kt

@@ -2,7 +2,6 @@ package app.revanced.api.configuration
 
 import app.revanced.api.command.applicationVersion
 import app.revanced.api.configuration.repository.ConfigurationRepository
-import io.bkbn.kompendium.core.attribute.KompendiumAttributes
 import io.bkbn.kompendium.core.plugin.NotarizedApplication
 import io.bkbn.kompendium.json.schema.KotlinXSchemaConfigurator
 import io.bkbn.kompendium.oas.OpenApiSpec
@@ -13,22 +12,13 @@ import io.bkbn.kompendium.oas.info.License
 import io.bkbn.kompendium.oas.security.BearerAuth
 import io.bkbn.kompendium.oas.server.Server
 import io.ktor.server.application.*
-import io.ktor.server.response.*
+import org.koin.ktor.ext.get
-import io.ktor.server.routing.*
 import java.net.URI
-import org.koin.ktor.ext.get as koinGet
 
 internal fun Application.configureOpenAPI() {
-    val configuration = koinGet<ConfigurationRepository>()
+    val configurationRepository = get<ConfigurationRepository>()
 
     install(NotarizedApplication()) {
-        openApiJson = {
-            route("/${configuration.apiVersion}/openapi.json") {
-                get {
-                    call.respond(application.attributes[KompendiumAttributes.openApiSpec])
-                }
-            }
-        }
         spec = OpenApiSpec(
             info = Info(
                 title = "ReVanced API",
@@ -51,7 +41,7 @@ internal fun Application.configureOpenAPI() {
             ),
         ).apply {
             servers += Server(
-                url = URI(configuration.endpoint),
+                url = URI(configurationRepository.endpoint),
                 description = "ReVanced API server",
             )
         }

src/main/kotlin/app/revanced/api/configuration/Routing.kt

@@ -4,6 +4,7 @@ import app.revanced.api.configuration.repository.ConfigurationRepository
 import app.revanced.api.configuration.routes.*
 import app.revanced.api.configuration.routes.announcementsRoute
 import app.revanced.api.configuration.routes.apiRoute
+import app.revanced.api.configuration.routes.oldApiRoute
 import app.revanced.api.configuration.routes.patchesRoute
 import io.bkbn.kompendium.core.routes.redoc
 import io.bkbn.kompendium.core.routes.swagger
@@ -18,7 +19,7 @@ internal fun Application.configureRouting() = routing {
 
     installCache(5.minutes)
 
-    route("/${configuration.apiVersion}") {
+    route("/v${configuration.apiVersion}") {
         announcementsRoute()
         patchesRoute()
         managerRoute()
@@ -52,7 +53,9 @@ internal fun Application.configureRouting() = routing {
         extensions("json", "asc")
     }
 
-    val specUrl = "/${configuration.apiVersion}/openapi.json"
+    swagger(pageTitle = "ReVanced API", path = "/")
-    swagger(pageTitle = "ReVanced API", path = "/", specUrl = specUrl)
+    redoc(pageTitle = "ReVanced API", path = "/redoc")
-    redoc(pageTitle = "ReVanced API", path = "/redoc", specUrl = specUrl)
+
+    // TODO: Remove, once migration period from v2 API is over (In 1-2 years).
+    oldApiRoute()
 }

src/main/kotlin/app/revanced/api/configuration/repository/AnnouncementRepository.kt

@@ -1,9 +1,9 @@
 package app.revanced.api.configuration.repository
 
-import app.revanced.api.configuration.ApiAnnouncement
+import app.revanced.api.configuration.schema.ApiAnnouncement
-import app.revanced.api.configuration.ApiAnnouncementTag
+import app.revanced.api.configuration.schema.ApiAnnouncementTag
-import app.revanced.api.configuration.ApiResponseAnnouncement
+import app.revanced.api.configuration.schema.ApiResponseAnnouncement
-import app.revanced.api.configuration.ApiResponseAnnouncementId
+import app.revanced.api.configuration.schema.ApiResponseAnnouncementId
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.runBlocking
 import org.jetbrains.exposed.dao.IntEntity
@@ -69,7 +69,8 @@ internal class AnnouncementRepository(private val database: Database) {
 
     fun latestId() = latestAnnouncement?.id?.value.toApiResponseAnnouncementId()
 
-    fun latestId(tags: Set<String>) = tags.map { tag -> latestAnnouncementByTag[tag]?.id?.value }.toApiResponseAnnouncementId()
+    fun latestId(tags: Set<String>) =
+        tags.map { tag -> latestAnnouncementByTag[tag]?.id?.value }.toApiResponseAnnouncementId()
 
     suspend fun paged(cursor: Int, count: Int, tags: Set<String>?) = transaction {
         Announcement.find {
@@ -99,16 +100,13 @@ internal class AnnouncementRepository(private val database: Database) {
             author = new.author
             title = new.title
             content = new.content
-            createdAt = new.createdAt
             archivedAt = new.archivedAt
             level = new.level
-            if (new.tags != null) {
+            tags = SizedCollection(
-                tags = SizedCollection(
+                new.tags.map { tag -> Tag.find { Tags.name eq tag }.firstOrNull() ?: Tag.new { name = tag } },
-                    new.tags.map { tag -> Tag.find { Tags.name eq tag }.firstOrNull() ?: Tag.new { name = tag } },
+            )
-                )
-            }
         }.apply {
-            new.attachments?.map { attachmentUrl ->
+            new.attachments.map { attachmentUrl ->
                 Attachment.new {
                     url = attachmentUrl
                     announcement = this@apply
@@ -122,32 +120,27 @@ internal class AnnouncementRepository(private val database: Database) {
             it.author = new.author
             it.title = new.title
             it.content = new.content
-            it.createdAt = new.createdAt
             it.archivedAt = new.archivedAt
             it.level = new.level
 
-            if (new.tags != null) {
+            // Get the old tags, create new tags if they don't exist,
-                // Get the old tags, create new tags if they don't exist,
+            // and delete tags that are not in the new tags, after updating the announcement.
-                // and delete tags that are not in the new tags, after updating the announcement.
+            val oldTags = it.tags.toList()
-                val oldTags = it.tags.toList()
+            val updatedTags = new.tags.map { name ->
-                val updatedTags = new.tags.map { name ->
+                Tag.find { Tags.name eq name }.firstOrNull() ?: Tag.new { this.name = name }
-                    Tag.find { Tags.name eq name }.firstOrNull() ?: Tag.new { this.name = name }
+            }
-                }
+            it.tags = SizedCollection(updatedTags)
-                it.tags = SizedCollection(updatedTags)
+            oldTags.forEach { tag ->
-                oldTags.forEach { tag ->
+                if (tag in updatedTags || !tag.announcements.empty()) return@forEach
-                    if (tag in updatedTags || !tag.announcements.empty()) return@forEach
+                tag.delete()
-                    tag.delete()
-                }
             }
 
             // Delete old attachments and create new attachments.
-            if (new.attachments != null) {
+            it.attachments.forEach { attachment -> attachment.delete() }
-                it.attachments.forEach { attachment -> attachment.delete() }
+            new.attachments.map { attachment ->
-                new.attachments.map { attachment ->
+                Attachment.new {
-                    Attachment.new {
+                    url = attachment
-                        url = attachment
+                    announcement = it
-                        announcement = it
-                    }
                 }
             }
         }?.let(::updateLatestAnnouncement) ?: Unit
@@ -180,7 +173,8 @@ internal class AnnouncementRepository(private val database: Database) {
         Tag.all().toList().toApiTag()
     }
 
-    private suspend fun <T> transaction(statement: suspend Transaction.() -> T) = newSuspendedTransaction(Dispatchers.IO, database, statement = statement)
+    private suspend fun <T> transaction(statement: suspend Transaction.() -> T) =
+        newSuspendedTransaction(Dispatchers.IO, database, statement = statement)
 
     private object Announcements : IntIdTable() {
         val author = varchar("author", 32).nullable()

src/main/kotlin/app/revanced/api/configuration/repository/BackendRepository.kt

@@ -135,14 +135,12 @@ abstract class BackendRepository internal constructor(
              * @property tag The tag of the release.
              * @property assets The assets of the release.
              * @property createdAt The date and time the release was created.
-             * @property prerelease Whether the release is a prerelease.
              * @property releaseNote The release note of the release.
              */
             class BackendRelease(
                 val tag: String,
                 val releaseNote: String,
                 val createdAt: LocalDateTime,
-                val prerelease: Boolean,
                 // Using a list instead of a set because set semantics are unnecessary here.
                 val assets: List<BackendAsset>,
             ) {
@@ -182,13 +180,13 @@ abstract class BackendRepository internal constructor(
      *
      * @param owner The owner of the repository.
      * @param repository The name of the repository.
-     * @param prerelease Whether to get a prerelease.
+     * @param tag The tag of the release. If null, the latest release is returned.
      * @return The release.
      */
     abstract suspend fun release(
         owner: String,
         repository: String,
-        prerelease: Boolean,
+        tag: String? = null,
     ): BackendOrganization.BackendRepository.BackendRelease
 
     /**

src/main/kotlin/app/revanced/api/configuration/repository/ConfigurationRepository.kt

@@ -1,6 +1,6 @@
 package app.revanced.api.configuration.repository
 
-import app.revanced.api.configuration.APIAbout
+import app.revanced.api.configuration.schema.APIAbout
 import app.revanced.api.configuration.services.ManagerService
 import app.revanced.api.configuration.services.PatchesService
 import kotlinx.serialization.ExperimentalSerializationApi
@@ -30,6 +30,7 @@ import kotlin.io.path.createDirectories
  * @property apiVersion The version to use for the API.
  * @property corsAllowedHosts The hosts allowed to make requests to the API.
  * @property endpoint The endpoint of the API.
+ * @property oldApiEndpoint The endpoint of the old API to proxy requests to.
  * @property staticFilesPath The path to the static files to be served under the root path.
  * @property versionedStaticFilesPath The path to the static files to be served under a versioned path.
  * @property about The path to the json file deserialized to [APIAbout]
@@ -45,10 +46,12 @@ internal class ConfigurationRepository(
     @SerialName("backend-service-name")
     val backendServiceName: String,
     @SerialName("api-version")
-    val apiVersion: String = "v1",
+    val apiVersion: Int = 1,
     @SerialName("cors-allowed-hosts")
     val corsAllowedHosts: Set<String>,
     val endpoint: String,
+    @SerialName("old-api-endpoint")
+    val oldApiEndpoint: String,
     @Serializable(with = PathSerializer::class)
     @SerialName("static-files-path")
     val staticFilesPath: Path,

src/main/kotlin/app/revanced/api/configuration/repository/GitHubBackendRepository.kt

@@ -24,10 +24,10 @@ class GitHubBackendRepository : BackendRepository("https://api.github.com", "htt
     override suspend fun release(
         owner: String,
         repository: String,
-        prerelease: Boolean,
+        tag: String?,
     ): BackendRelease {
-        val release: GitHubRelease = if (prerelease) {
+        val release: GitHubRelease = if (tag != null) {
-            client.get(Releases(owner, repository)).body<List<GitHubRelease>>().first { it.prerelease }
+            client.get(Releases.Tag(owner, repository, tag)).body()
         } else {
             client.get(Releases.Latest(owner, repository)).body()
         }
@@ -36,7 +36,6 @@ class GitHubBackendRepository : BackendRepository("https://api.github.com", "htt
             tag = release.tagName,
             releaseNote = release.body,
             createdAt = release.createdAt.toLocalDateTime(TimeZone.UTC),
-            prerelease = release.prerelease,
             assets = release.assets.map {
                 BackendAsset(
                     name = it.name,
@@ -164,7 +163,6 @@ class GitHubOrganization {
             // Using a list instead of a set because set semantics are unnecessary here.
             val assets: List<GitHubAsset>,
             val createdAt: Instant,
-            val prerelease: Boolean,
             val body: String,
         ) {
             @Serializable
@@ -202,8 +200,10 @@ class Organization {
         @Resource("/repos/{owner}/{repo}/contributors")
         class Contributors(val owner: String, val repo: String, @SerialName("per_page") val perPage: Int = 100)
 
-        @Resource("/repos/{owner}/{repo}/releases")
+        class Releases {
-        class Releases(val owner: String, val repo: String) {
+            @Resource("/repos/{owner}/{repo}/releases/tags/{tag}")
+            class Tag(val owner: String, val repo: String, val tag: String)
+
             @Resource("/repos/{owner}/{repo}/releases/latest")
             class Latest(val owner: String, val repo: String)
         }

src/main/kotlin/app/revanced/api/configuration/routes/Announcements.kt

@@ -1,12 +1,12 @@
 package app.revanced.api.configuration.routes
 
-import app.revanced.api.configuration.ApiAnnouncement
-import app.revanced.api.configuration.ApiResponseAnnouncement
-import app.revanced.api.configuration.ApiResponseAnnouncementId
 import app.revanced.api.configuration.canRespondUnauthorized
 import app.revanced.api.configuration.installCache
 import app.revanced.api.configuration.installNotarizedRoute
 import app.revanced.api.configuration.respondOrNotFound
+import app.revanced.api.configuration.schema.ApiAnnouncement
+import app.revanced.api.configuration.schema.ApiResponseAnnouncement
+import app.revanced.api.configuration.schema.ApiResponseAnnouncementId
 import app.revanced.api.configuration.services.AnnouncementService
 import io.bkbn.kompendium.core.metadata.DeleteInfo
 import io.bkbn.kompendium.core.metadata.GetInfo

src/main/kotlin/app/revanced/api/configuration/routes/ApiRoute.kt

@@ -6,6 +6,7 @@ import app.revanced.api.configuration.installNoCache
 import app.revanced.api.configuration.installNotarizedRoute
 import app.revanced.api.configuration.repository.ConfigurationRepository
 import app.revanced.api.configuration.respondOrNotFound
+import app.revanced.api.configuration.schema.*
 import app.revanced.api.configuration.services.ApiService
 import app.revanced.api.configuration.services.AuthenticationService
 import io.bkbn.kompendium.core.metadata.*
@@ -183,7 +184,7 @@ private fun Route.installTokenRouteDocumentation() = installNotarizedRoute {
                             "username=\"ReVanced\", " +
                             "realm=\"ReVanced\", " +
                             "nonce=\"abc123\", " +
-                            "uri=\"/${configuration.apiVersion}/token\", " +
+                            "uri=\"/v${configuration.apiVersion}/token\", " +
                             "algorithm=SHA-256, " +
                             "response=\"yxz456\"",
                     ),

src/main/kotlin/app/revanced/api/configuration/routes/ManagerRoute.kt

@@ -1,12 +1,10 @@
 package app.revanced.api.configuration.routes
 
-import app.revanced.api.configuration.ApiRelease
-import app.revanced.api.configuration.ApiReleaseVersion
 import app.revanced.api.configuration.installNotarizedRoute
+import app.revanced.api.configuration.schema.ApiRelease
+import app.revanced.api.configuration.schema.ApiReleaseVersion
 import app.revanced.api.configuration.services.ManagerService
 import io.bkbn.kompendium.core.metadata.GetInfo
-import io.bkbn.kompendium.json.schema.definition.TypeDefinition
-import io.bkbn.kompendium.oas.payload.Parameter
 import io.ktor.http.*
 import io.ktor.server.application.*
 import io.ktor.server.plugins.ratelimit.*
@@ -15,44 +13,41 @@ import io.ktor.server.routing.*
 import org.koin.ktor.ext.get as koinGet
 
 internal fun Route.managerRoute() = route("manager") {
+    configure()
+
+    // TODO: Remove this deprecated route eventually.
+    route("latest") {
+        configure(deprecated = true)
+    }
+}
+
+private fun Route.configure(deprecated: Boolean = false) {
     val managerService = koinGet<ManagerService>()
 
-    installManagerRouteDocumentation()
+    installManagerRouteDocumentation(deprecated)
 
     rateLimit(RateLimitName("weak")) {
         get {
-            val prerelease = call.parameters["prerelease"]?.toBoolean() ?: false
+            call.respond(managerService.latestRelease())
-
-            call.respond(managerService.latestRelease(prerelease))
         }
 
         route("version") {
-            installManagerVersionRouteDocumentation()
+            installManagerVersionRouteDocumentation(deprecated)
 
             get {
-                val prerelease = call.parameters["prerelease"]?.toBoolean() ?: false
+                call.respond(managerService.latestVersion())
-
-                call.respond(managerService.latestVersion(prerelease))
             }
         }
     }
 }
 
-private val prereleaseParameter = Parameter(
+private fun Route.installManagerRouteDocumentation(deprecated: Boolean) = installNotarizedRoute {
-    name = "prerelease",
-    `in` = Parameter.Location.query,
-    schema = TypeDefinition.STRING,
-    description = "Whether to get the current manager prerelease",
-    required = false,
-)
-
-private fun Route.installManagerRouteDocumentation() = installNotarizedRoute {
     tags = setOf("Manager")
 
     get = GetInfo.builder {
+        if (deprecated) isDeprecated()
         description("Get the current manager release")
         summary("Get current manager release")
-        parameters(prereleaseParameter)
         response {
             description("The latest manager release")
             mediaTypes("application/json")
@@ -62,13 +57,13 @@ private fun Route.installManagerRouteDocumentation() = installNotarizedRoute {
     }
 }
 
-private fun Route.installManagerVersionRouteDocumentation() = installNotarizedRoute {
+private fun Route.installManagerVersionRouteDocumentation(deprecated: Boolean) = installNotarizedRoute {
     tags = setOf("Manager")
 
     get = GetInfo.builder {
+        if (deprecated) isDeprecated()
         description("Get the current manager release version")
         summary("Get current manager release version")
-        parameters(prereleaseParameter)
         response {
             description("The current manager release version")
             mediaTypes("application/json")

src/main/kotlin/app/revanced/api/configuration/routes/OldApi.kt

@@ -0,0 +1,19 @@
+package app.revanced.api.configuration.routes
+
+import app.revanced.api.configuration.services.OldApiService
+import io.ktor.server.application.*
+import io.ktor.server.plugins.ratelimit.*
+import io.ktor.server.routing.*
+import org.koin.ktor.ext.get
+
+internal fun Route.oldApiRoute() {
+    val oldApiService = get<OldApiService>()
+
+    rateLimit(RateLimitName("weak")) {
+        route(Regex("/(v2|tools|contributors).*")) {
+            handle {
+                oldApiService.proxy(call)
+            }
+        }
+    }
+}

src/main/kotlin/app/revanced/api/configuration/routes/PatchesRoute.kt

@@ -1,14 +1,12 @@
 package app.revanced.api.configuration.routes
 
-import app.revanced.api.configuration.ApiAssetPublicKey
-import app.revanced.api.configuration.ApiRelease
-import app.revanced.api.configuration.ApiReleaseVersion
 import app.revanced.api.configuration.installCache
 import app.revanced.api.configuration.installNotarizedRoute
+import app.revanced.api.configuration.schema.ApiAssetPublicKey
+import app.revanced.api.configuration.schema.ApiRelease
+import app.revanced.api.configuration.schema.ApiReleaseVersion
 import app.revanced.api.configuration.services.PatchesService
 import io.bkbn.kompendium.core.metadata.GetInfo
-import io.bkbn.kompendium.json.schema.definition.TypeDefinition
-import io.bkbn.kompendium.oas.payload.Parameter
 import io.ktor.http.*
 import io.ktor.server.application.*
 import io.ktor.server.plugins.ratelimit.*
@@ -18,36 +16,39 @@ import kotlin.time.Duration.Companion.days
 import org.koin.ktor.ext.get as koinGet
 
 internal fun Route.patchesRoute() = route("patches") {
+    configure()
+
+    // TODO: Remove this deprecated route eventually.
+    route("latest") {
+        configure(deprecated = true)
+    }
+}
+
+private fun Route.configure(deprecated: Boolean = false) {
     val patchesService = koinGet<PatchesService>()
 
-    installPatchesRouteDocumentation()
+    installPatchesRouteDocumentation(deprecated)
 
     rateLimit(RateLimitName("weak")) {
         get {
-            val prerelease = call.parameters["prerelease"]?.toBoolean() ?: false
+            call.respond(patchesService.latestRelease())
-
-            call.respond(patchesService.latestRelease(prerelease))
         }
 
         route("version") {
-            installPatchesVersionRouteDocumentation()
+            installPatchesVersionRouteDocumentation(deprecated)
 
             get {
-                val prerelease = call.parameters["prerelease"]?.toBoolean() ?: false
+                call.respond(patchesService.latestVersion())
-
-                call.respond(patchesService.latestVersion(prerelease))
             }
         }
     }
 
     rateLimit(RateLimitName("strong")) {
         route("list") {
-            installPatchesListRouteDocumentation()
+            installPatchesListRouteDocumentation(deprecated)
 
             get {
-                val prerelease = call.parameters["prerelease"]?.toBoolean() ?: false
+                call.respondBytes(ContentType.Application.Json) { patchesService.list() }
-
-                call.respondBytes(ContentType.Application.Json) { patchesService.list(prerelease) }
             }
         }
     }
@@ -56,7 +57,7 @@ internal fun Route.patchesRoute() = route("patches") {
         route("keys") {
             installCache(356.days)
 
-            installPatchesPublicKeyRouteDocumentation()
+            installPatchesPublicKeyRouteDocumentation(deprecated)
 
             get {
                 call.respond(patchesService.publicKey())
@@ -65,21 +66,13 @@ internal fun Route.patchesRoute() = route("patches") {
     }
 }
 
-private val prereleaseParameter = Parameter(
+private fun Route.installPatchesRouteDocumentation(deprecated: Boolean) = installNotarizedRoute {
-    name = "prerelease",
-    `in` = Parameter.Location.query,
-    schema = TypeDefinition.STRING,
-    description = "Whether to get the current patches prerelease",
-    required = false,
-)
-
-private fun Route.installPatchesRouteDocumentation() = installNotarizedRoute {
     tags = setOf("Patches")
 
     get = GetInfo.builder {
+        if (deprecated) isDeprecated()
         description("Get the current patches release")
         summary("Get current patches release")
-        parameters(prereleaseParameter)
         response {
             description("The current patches release")
             mediaTypes("application/json")
@@ -89,13 +82,13 @@ private fun Route.installPatchesRouteDocumentation() = installNotarizedRoute {
     }
 }
 
-private fun Route.installPatchesVersionRouteDocumentation() = installNotarizedRoute {
+private fun Route.installPatchesVersionRouteDocumentation(deprecated: Boolean) = installNotarizedRoute {
     tags = setOf("Patches")
 
     get = GetInfo.builder {
+        if (deprecated) isDeprecated()
         description("Get the current patches release version")
         summary("Get current patches release version")
-        parameters(prereleaseParameter)
         response {
             description("The current patches release version")
             mediaTypes("application/json")
@@ -105,13 +98,13 @@ private fun Route.installPatchesVersionRouteDocumentation() = installNotarizedRo
     }
 }
 
-private fun Route.installPatchesListRouteDocumentation() = installNotarizedRoute {
+private fun Route.installPatchesListRouteDocumentation(deprecated: Boolean) = installNotarizedRoute {
     tags = setOf("Patches")
 
     get = GetInfo.builder {
+        if (deprecated) isDeprecated()
         description("Get the list of patches from the current patches release")
         summary("Get list of patches from current patches release")
-        parameters(prereleaseParameter)
         response {
             description("The list of patches")
             mediaTypes("application/json")
@@ -121,10 +114,11 @@ private fun Route.installPatchesListRouteDocumentation() = installNotarizedRoute
     }
 }
 
-private fun Route.installPatchesPublicKeyRouteDocumentation() = installNotarizedRoute {
+private fun Route.installPatchesPublicKeyRouteDocumentation(deprecated: Boolean) = installNotarizedRoute {
     tags = setOf("Patches")
 
     get = GetInfo.builder {
+        if (deprecated) isDeprecated()
         description("Get the public keys for verifying patches assets")
         summary("Get patches public keys")
         response {

src/main/kotlin/app/revanced/api/configuration/schema/APISchema.kt

@@ -1,9 +1,6 @@
-package app.revanced.api.configuration
+package app.revanced.api.configuration.schema
 
-import kotlinx.datetime.Clock
 import kotlinx.datetime.LocalDateTime
-import kotlinx.datetime.TimeZone
-import kotlinx.datetime.toLocalDateTime
 import kotlinx.serialization.Serializable
 
 interface ApiUser {
@@ -63,10 +60,9 @@ class ApiAnnouncement(
     val title: String,
     val content: String? = null,
     // Using a list instead of a set because set semantics are unnecessary here.
-    val attachments: List<String>? = null,
+    val attachments: List<String> = emptyList(),
     // Using a list instead of a set because set semantics are unnecessary here.
-    val tags: List<String>? = null,
+    val tags: List<String> = emptyList(),
-    val createdAt: LocalDateTime = Clock.System.now().toLocalDateTime(TimeZone.currentSystemDefault()),
     val archivedAt: LocalDateTime? = null,
     val level: Int = 0,
 )
@@ -78,9 +74,9 @@ class ApiResponseAnnouncement(
     val title: String,
     val content: String? = null,
     // Using a list instead of a set because set semantics are unnecessary here.
-    val attachments: List<String>? = null,
+    val attachments: List<String> = emptyList(),
     // Using a list instead of a set because set semantics are unnecessary here.
-    val tags: List<String>? = null,
+    val tags: List<String> = emptyList(),
     val createdAt: LocalDateTime,
     val archivedAt: LocalDateTime? = null,
     val level: Int = 0,
@@ -123,7 +119,6 @@ class APIAbout(
     // Using a list instead of a set because set semantics are unnecessary here.
     val socials: List<Social>?,
     val donations: Donations?,
-    val status: String,
 ) {
     @Serializable
     class Branding(

src/main/kotlin/app/revanced/api/configuration/services/AnnouncementService.kt

@@ -1,7 +1,7 @@
 package app.revanced.api.configuration.services
 
-import app.revanced.api.configuration.ApiAnnouncement
 import app.revanced.api.configuration.repository.AnnouncementRepository
+import app.revanced.api.configuration.schema.ApiAnnouncement
 
 internal class AnnouncementService(
     private val announcementRepository: AnnouncementRepository,

src/main/kotlin/app/revanced/api/configuration/services/ApiService.kt

@@ -1,8 +1,8 @@
 package app.revanced.api.configuration.services
 
-import app.revanced.api.configuration.*
 import app.revanced.api.configuration.repository.BackendRepository
 import app.revanced.api.configuration.repository.ConfigurationRepository
+import app.revanced.api.configuration.schema.*
 import io.ktor.http.*
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.async

src/main/kotlin/app/revanced/api/configuration/services/AuthenticationService.kt

@@ -1,6 +1,6 @@
 package app.revanced.api.configuration.services
 
-import app.revanced.api.configuration.ApiToken
+import app.revanced.api.configuration.schema.ApiToken
 import com.auth0.jwt.JWT
 import com.auth0.jwt.algorithms.Algorithm
 import io.ktor.server.auth.*

src/main/kotlin/app/revanced/api/configuration/services/ManagerService.kt

@@ -1,20 +1,19 @@
 package app.revanced.api.configuration.services
 
-import app.revanced.api.configuration.ApiRelease
-import app.revanced.api.configuration.ApiReleaseVersion
 import app.revanced.api.configuration.repository.BackendRepository
 import app.revanced.api.configuration.repository.BackendRepository.BackendOrganization.BackendRepository.BackendRelease.Companion.first
 import app.revanced.api.configuration.repository.ConfigurationRepository
+import app.revanced.api.configuration.schema.ApiRelease
+import app.revanced.api.configuration.schema.ApiReleaseVersion
 
 internal class ManagerService(
     private val backendRepository: BackendRepository,
     private val configurationRepository: ConfigurationRepository,
 ) {
-    suspend fun latestRelease(prerelease: Boolean): ApiRelease {
+    suspend fun latestRelease(): ApiRelease {
         val managerRelease = backendRepository.release(
             configurationRepository.organization,
             configurationRepository.manager.repository,
-            prerelease,
         )
 
         return ApiRelease(
@@ -25,11 +24,10 @@ internal class ManagerService(
         )
     }
 
-    suspend fun latestVersion(prerelease: Boolean): ApiReleaseVersion {
+    suspend fun latestVersion(): ApiReleaseVersion {
         val managerRelease = backendRepository.release(
             configurationRepository.organization,
             configurationRepository.manager.repository,
-            prerelease,
         )
 
         return ApiReleaseVersion(managerRelease.tag)

src/main/kotlin/app/revanced/api/configuration/services/OldApiService.kt

@@ -0,0 +1,76 @@
+package app.revanced.api.configuration.services
+
+import app.revanced.api.configuration.repository.ConfigurationRepository
+import io.ktor.client.*
+import io.ktor.client.engine.okhttp.*
+import io.ktor.client.plugins.*
+import io.ktor.client.request.*
+import io.ktor.client.statement.*
+import io.ktor.http.*
+import io.ktor.http.content.*
+import io.ktor.server.application.*
+import io.ktor.server.request.*
+import io.ktor.server.response.*
+import io.ktor.util.*
+import io.ktor.utils.io.*
+
+internal class OldApiService(configurationRepository: ConfigurationRepository) {
+    private val client = HttpClient(OkHttp) {
+        defaultRequest { url(configurationRepository.oldApiEndpoint) }
+    }
+
+    @OptIn(InternalAPI::class)
+    suspend fun proxy(call: ApplicationCall) {
+        val channel = call.request.receiveChannel()
+        val size = channel.availableForRead
+        val byteArray = ByteArray(size)
+        channel.readFully(byteArray)
+
+        val response: HttpResponse = client.request(call.request.uri) {
+            method = call.request.httpMethod
+
+            headers {
+                appendAll(
+                    call.request.headers.filter { key, _ ->
+                        !(
+                            key.equals(HttpHeaders.ContentType, ignoreCase = true) ||
+                                key.equals(HttpHeaders.ContentLength, ignoreCase = true) ||
+                                key.equals(HttpHeaders.Host, ignoreCase = true)
+                            )
+                    },
+                )
+            }
+
+            when (call.request.httpMethod) {
+                HttpMethod.Post,
+                HttpMethod.Put,
+                HttpMethod.Patch,
+                HttpMethod.Delete,
+                -> body = ByteArrayContent(byteArray, call.request.contentType())
+            }
+        }
+
+        val headers = response.headers
+
+        call.respond(object : OutgoingContent.WriteChannelContent() {
+            override val contentLength: Long? = headers[HttpHeaders.ContentLength]?.toLong()
+            override val contentType = headers[HttpHeaders.ContentType]?.let { ContentType.parse(it) }
+            override val headers: Headers = Headers.build {
+                appendAll(
+                    headers.filter { key, _ ->
+                        !key.equals(
+                            HttpHeaders.ContentType,
+                            ignoreCase = true,
+                        ) &&
+                            !key.equals(HttpHeaders.ContentLength, ignoreCase = true)
+                    },
+                )
+            }
+            override val status = response.status
+
+            override suspend fun writeTo(channel: ByteWriteChannel) {
+                response.content.copyAndClose(channel)
+            }
+        })
+    }
+}

src/main/kotlin/app/revanced/api/configuration/services/PatchesService.kt

@@ -1,11 +1,11 @@
 package app.revanced.api.configuration.services
 
-import app.revanced.api.configuration.ApiAssetPublicKey
-import app.revanced.api.configuration.ApiRelease
-import app.revanced.api.configuration.ApiReleaseVersion
 import app.revanced.api.configuration.repository.BackendRepository
 import app.revanced.api.configuration.repository.BackendRepository.BackendOrganization.BackendRepository.BackendRelease.Companion.first
 import app.revanced.api.configuration.repository.ConfigurationRepository
+import app.revanced.api.configuration.schema.ApiAssetPublicKey
+import app.revanced.api.configuration.schema.ApiRelease
+import app.revanced.api.configuration.schema.ApiReleaseVersion
 import app.revanced.library.serializeTo
 import app.revanced.patcher.patch.loadPatchesFromJar
 import com.github.benmanes.caffeine.cache.Caffeine
@@ -19,11 +19,10 @@ internal class PatchesService(
     private val backendRepository: BackendRepository,
     private val configurationRepository: ConfigurationRepository,
 ) {
-    suspend fun latestRelease(prerelease: Boolean): ApiRelease {
+    suspend fun latestRelease(): ApiRelease {
         val patchesRelease = backendRepository.release(
             configurationRepository.organization,
             configurationRepository.patches.repository,
-            prerelease,
         )
 
         return ApiRelease(
@@ -35,11 +34,10 @@ internal class PatchesService(
         )
     }
 
-    suspend fun latestVersion(prerelease: Boolean): ApiReleaseVersion {
+    suspend fun latestVersion(): ApiReleaseVersion {
         val patchesRelease = backendRepository.release(
             configurationRepository.organization,
             configurationRepository.patches.repository,
-            prerelease,
         )
 
         return ApiReleaseVersion(patchesRelease.tag)
@@ -50,11 +48,10 @@ internal class PatchesService(
         .maximumSize(1)
         .build<String, ByteArray>()
 
-    suspend fun list(prerelease: Boolean): ByteArray {
+    suspend fun list(): ByteArray {
         val patchesRelease = backendRepository.release(
             configurationRepository.organization,
             configurationRepository.patches.repository,
-            prerelease,
         )
 
         return withContext(Dispatchers.IO) {

src/main/kotlin/app/revanced/api/configuration/services/SignatureService.kt

@@ -12,7 +12,7 @@ import java.security.MessageDigest
 internal class SignatureService {
     private val signatureCache = Caffeine
         .newBuilder()
-        .maximumSize(2) // 2 because currently only the latest release and prerelease patches are needed.
+        .maximumSize(1) // 1 because currently only the latest patches is needed.
         .build<ByteArray, Boolean>() // Hash -> Verified.
 
     fun verify(

src/main/resources/logback.xml

@@ -1,7 +1,7 @@
 <configuration>
     <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
         <encoder>
-            <pattern>%d{YYYY-MM-dd HH:mm:ss.SSS} %-5level %msg%n</pattern>
+            <pattern>%d{YYYY-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
         </encoder>
     </appender>
     <root level="\${LOG_LEVEL:-INFO}">

src/test/kotlin/app/revanced/api/configuration/services/AnnouncementServiceTest.kt

@@ -1,7 +1,7 @@
 package app.revanced.api.configuration.services
 
-import app.revanced.api.configuration.ApiAnnouncement
 import app.revanced.api.configuration.repository.AnnouncementRepository
+import app.revanced.api.configuration.schema.ApiAnnouncement
 import kotlinx.coroutines.runBlocking
 import kotlinx.datetime.toKotlinLocalDateTime
 import org.jetbrains.exposed.sql.Database
@@ -135,7 +135,7 @@ private object AnnouncementServiceTest {
         val latestAnnouncement = announcementService.latest()!!
         val latestId = latestAnnouncement.id
 
-        val attachments = latestAnnouncement.attachments!!
+        val attachments = latestAnnouncement.attachments
         assertEquals(2, attachments.size)
         assert(attachments.any { it == "attachment1" })
         assert(attachments.any { it == "attachment2" })
@@ -144,7 +144,7 @@ private object AnnouncementServiceTest {
             latestId,
             ApiAnnouncement(title = "title", attachments = listOf("attachment1", "attachment3")),
         )
-        assert(announcementService.get(latestId)!!.attachments!!.any { it == "attachment3" })
+        assert(announcementService.get(latestId)!!.attachments.any { it == "attachment3" })
     }
 
     @Test