chore: release v0.5.0

Author: DevNico

build.sbt

@@ -30,7 +30,7 @@ ThisBuild / makePomConfiguration := makePomConfiguration.value.withConfiguration
 )
 
 // Version and Scala settings
-val slickSeekerVersion = "0.4.0"
+val slickSeekerVersion = "0.5.0"
 
 val scala3Version   = "3.3.5"
 val scala213Version = "2.13.16"

slick-seeker/src/main/scala/io/github/devnico/slickseeker/pagination/Seeker.scala

@@ -0,0 +1,45 @@
+package io.github.devnico.slickseeker.pagination
+
+import io.github.devnico.slickseeker.cursor.CursorEnvironment
+import slick.jdbc.JdbcProfile
+
+import scala.concurrent.ExecutionContext
+
+/** Common base trait for all seeker implementations.
+  *
+  * Provides a unified interface for cursor-based pagination across different seeker variants.
+  *
+  * @tparam U
+  *   The unpacked type of query results
+  * @tparam CVE
+  *   The cursor value encoding type
+  */
+trait Seeker[U, CVE] {
+
+  /** Execute a paginated query with cursor-based navigation.
+    *
+    * @param limit
+    *   Maximum number of items to return
+    * @param cursor
+    *   Optional cursor for pagination navigation
+    * @param maxLimit
+    *   Maximum allowed limit
+    * @param profile
+    *   JDBC profile for database operations
+    * @param cursorEnvironment
+    *   Environment for encoding/decoding cursors
+    * @param ec
+    *   Execution context for async operations
+    * @return
+    *   Database action that returns a paginated result
+    */
+  def page[Profile <: JdbcProfile](
+      limit: Int,
+      cursor: Option[String],
+      maxLimit: Int
+  )(implicit
+      profile: Profile,
+      cursorEnvironment: CursorEnvironment[CVE],
+      ec: ExecutionContext
+  ): profile.api.DBIOAction[PaginatedResult[U], profile.api.NoStream, profile.api.Effect.Read]
+}

slick-seeker/src/main/scala/io/github/devnico/slickseeker/pagination/SlickPgTupleSeeker.scala

@@ -29,7 +29,7 @@ final case class SlickPgTupleSeeker[E, U, CVE, C, CU, D <: Ordering.Direction](
     columns: Vector[PgTupleSeekColumn[E, U, CVE]],
     qwc: QueryWithCursor[E, U, C, CU, CVE],
     direction: D
-)(implicit shape: lifted.Shape[lifted.FlatShapeLevel, E, U, E]) {
+)(implicit shape: lifted.Shape[lifted.FlatShapeLevel, E, U, E]) extends Seeker[U, CVE] {
 
   import SlickSeeker._
 

slick-seeker/src/main/scala/io/github/devnico/slickseeker/pagination/SlickSeeker.scala

@@ -22,7 +22,7 @@ final case class SlickSeeker[E, U, CVE, C, CU](
     baseQuery: lifted.Query[E, U, Seq],
     columns: Vector[SeekColumn[E, U, CVE]],
     qwc: QueryWithCursor[E, U, C, CU, CVE]
-)(implicit shape: lifted.Shape[lifted.FlatShapeLevel, E, U, E]) {
+)(implicit shape: lifted.Shape[lifted.FlatShapeLevel, E, U, E]) extends Seeker[U, CVE] {
   import ColumnSeekFilterTypes._
   import SlickSeeker._