From 56203dfb71a85f699f696e3c53efe3ecf9cf8179 Mon Sep 17 00:00:00 2001
From: Chin Yee Wen <chinyeewen13@gmail.com>
Date: Fri, 19 Jun 2026 15:46:05 +0800
Subject: [PATCH] add paging request

---
 build.gradle.kts                              |  2 +-
 core/build.gradle.kts                         |  3 +-
 .../ai/neuon/utility/paging/PagingRequest.kt  | 50 +++++++++++++++++++
 gradle/libs.versions.toml                     | 32 ++++++++++++
 4 files changed, 85 insertions(+), 2 deletions(-)
 create mode 100644 core/src/main/kotlin/ai/neuon/utility/paging/PagingRequest.kt

diff --git a/build.gradle.kts b/build.gradle.kts
index cff4c99..db55e25 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -3,7 +3,7 @@ plugins {
 }
 
 group = "ai.neuon.utility"
-version = "0.1.0"
+version = "0.2.0"
 
 repositories {
     mavenCentral()
diff --git a/core/build.gradle.kts b/core/build.gradle.kts
index 769dca2..d7cb4b2 100644
--- a/core/build.gradle.kts
+++ b/core/build.gradle.kts
@@ -13,7 +13,8 @@ repositories {
 
 dependencies {
     implementation(libs.kotlinx.serialization.json)
-    testImplementation(kotlin("test"))
+    implementation(libs.bundles.ktor.server)
+    implementation(libs.bundles.slf4j)
 }
 
 tasks.test {
diff --git a/core/src/main/kotlin/ai/neuon/utility/paging/PagingRequest.kt b/core/src/main/kotlin/ai/neuon/utility/paging/PagingRequest.kt
new file mode 100644
index 0000000..b1630c8
--- /dev/null
+++ b/core/src/main/kotlin/ai/neuon/utility/paging/PagingRequest.kt
@@ -0,0 +1,50 @@
+package ai.neuon.utility.paging
+
+import io.ktor.server.request.ApplicationRequest
+import kotlin.math.max
+
+sealed class PagingRequest {
+    companion object {
+        fun from(request: ApplicationRequest): PagingRequest {
+            val params = request.queryParameters
+            val pagingType = params["paging"]?.let {
+                Type.from(it)
+            } ?: Type.OFFSET
+
+            return when (pagingType) {
+                Type.NONE -> None
+                Type.OFFSET -> {
+                    val i = params["page"]?.toInt()
+                        ?.let { max(0, it) } ?: 0
+                    val limit = params["pageSize"]?.toInt()
+                        ?.let { max(1, it) } ?: 10
+                    Offset(index = i, limit = limit)
+                }
+            }
+        }
+    }
+
+    data object None : PagingRequest()
+
+    data class Offset(val index: Int, val limit: Int) : PagingRequest() {
+        val skip: Int
+            get() = index * limit
+    }
+
+    enum class Type(val key: String) {
+        NONE(key = "none"), OFFSET(key = "offset");
+
+        companion object {
+            /**
+             * @throws IllegalArgumentException
+             */
+            fun from(type: String): Type {
+                return when (type) {
+                    "none" -> NONE
+                    "offset" -> OFFSET
+                    else -> throw IllegalArgumentException("Unsupported pagination type, $type")
+                }
+            }
+        }
+    }
+}
\ No newline at end of file
diff --git a/gradle/libs.versions.toml b/gradle/libs.versions.toml
index ce79809..3a36e9a 100644
--- a/gradle/libs.versions.toml
+++ b/gradle/libs.versions.toml
@@ -2,12 +2,44 @@
 dokka = "2.0.0"
 kotlin = "2.2.0"
 kotlinx-serialization-json = "1.9.0"
+ktor = "3.4.1"
+logback = "1.5.32"
+slf4j = "2.0.17"
 
 
 [libraries]
 kotlinx-serialization-json = { module = "org.jetbrains.kotlinx:kotlinx-serialization-json", version.ref = "kotlinx-serialization-json" }
 
 
+
+ktor-server-caching-headers = { module = "io.ktor:ktor-server-caching-headers", version.ref = "ktor" }
+ktor-server-cio = { module = "io.ktor:ktor-server-cio", version.ref = "ktor" }
+ktor-server-config-yaml = { module = "io.ktor:ktor-server-config-yaml", version.ref = "ktor" }
+ktor-server-content-negotiation = { module = "io.ktor:ktor-server-content-negotiation", version.ref = "ktor" }
+ktor-server-core = { module = "io.ktor:ktor-server-core-jvm", version.ref = "ktor" }
+ktor-server-di = { module = "io.ktor:ktor-server-di", version.ref = "ktor" }
+ktor-server-status-pages = { module = "io.ktor:ktor-server-status-pages", version.ref = "ktor" }
+
+ktor-serialization-kotlinx-json = { module = "io.ktor:ktor-serialization-kotlinx-json", version.ref = "ktor" }
+
+logback = { module = "ch.qos.logback:logback-classic", version.ref = "logback" }
+slf4j-api = { module = "org.slf4j:slf4j-api", version.ref = "slf4j" }
+
+[bundles]
+ktor-server = [
+    "ktor-server-cio",
+    "ktor-server-caching-headers",
+    "ktor-server-core",
+    "ktor-server-config-yaml",
+    "ktor-server-content-negotiation",
+    "ktor-server-di",
+    "ktor-server-status-pages",
+    "ktor-serialization-kotlinx-json",
+    "logback",
+]
+slf4j = ["slf4j-api", "logback"]
+
+
 [plugins]
 dokka = { id = "org.jetbrains.dokka", version.ref = "dokka" }
 kotlin-jvm = { id = "org.jetbrains.kotlin.jvm", version.ref = "kotlin" }