/ktorfit create user endpoint          # Create new API endpoint
/ktorfit debug auth issue              # Debug authentication problems
/ktorfit explain response handling     # Understand response patterns
/ktorfit add retry logic               # Add retry to endpoint

internal interface UserApi {
  @GET("users/{id}")
  suspend fun getUser(
    @Path("id") userId: String,
  ): JellyfinResponse<JsonObject>

  @POST("users")
  suspend fun createUser(
    @Body request: CreateUserRequest,
  ): JellyfinResponse<JsonObject>

  @GET("users")
  suspend fun getUsers(
    @Query("page") page: Int,
    @Query("limit") limit: Int = 20,
  ): JellyfinResponse<JsonArray>
}

// Convert to result
val result = api.getUser(userId).toResult()

// Map success
result.mapSuccessTo { json ->
  User(
    id = json["id"]!!.jsonPrimitive.content,
    name = json["name"]!!.jsonPrimitive.content,
  )
}

// Handle in repository
override suspend fun fetchUser(id: String): JellyfinResult<User> {
  return api.getUser(id)
    .toResult()
    .mapSuccessTo { json -> json.toUser() }
    .andThen { user ->
      localDataSource.saveUser(user)
    }
}

@Serializable
data class CreateUserRequest(
  val name: String,
  val email: String,
)

@GET("users")
suspend fun getUsers(
  @Header("Authorization") token: String,
): JellyfinResponse<JsonArray>

retryJellyfinResult(RetryPolicy.Default) {
  api.getUsers().toResult()
}