Quick Start Guide - Kotlin SDK

dependencies {
    implementation("com.bosbase:bosbase-kotlin-sdk:0.1.0")
}

dependencies {
    implementation 'com.bosbase:bosbase-kotlin-sdk:0.1.0'
}

<dependency>
    <groupId>com.bosbase</groupId>
    <artifactId>bosbase-kotlin-sdk</artifactId>
    <version>0.1.0</version>
</dependency>

import com.bosbase.sdk.BosBase

val pb = BosBase("http://127.0.0.1:8090")

// Authenticate with email and password
val authData = pb.collection("users").authWithPassword(
    identity = "test@example.com",
    password = "123456"
)

println("Authenticated: ${authData["token"]?.jsonPrimitive?.contentOrNull}")

val newPost = pb.collection("posts").create(
    body = mapOf(
        "title" to "Hello Kotlin!",
        "content" to "This is my first post"
    )
)

println("Created post ID: ${newPost["id"]?.jsonPrimitive?.contentOrNull}")

val result = pb.collection("posts").getList(page = 1, perPage = 10)

result.items.forEach { post ->
    println("Title: ${post["title"]?.jsonPrimitive?.contentOrNull}")
}

val updated = pb.collection("posts").update(
    id = "RECORD_ID",
    body = mapOf("title" to "Updated Title")
)

pb.collection("posts").delete("RECORD_ID")

import com.bosbase.sdk.BosBase
import com.bosbase.sdk.ClientResponseError
import kotlinx.serialization.json.jsonPrimitive
import kotlinx.serialization.json.contentOrNull

fun main() {
    val pb = BosBase("http://127.0.0.1:8090")
    
    try {
        // 1. Authenticate
        val authData = pb.collection("users").authWithPassword(
            identity = "test@example.com",
            password = "123456"
        )
        println("✅ Authenticated")
        
        // 2. Create a record
        val newPost = pb.collection("posts").create(
            body = mapOf(
                "title" to "My First Post",
                "content" to "This is the content of my post",
                "status" to "published"
            )
        )
        val postId = newPost["id"]?.jsonPrimitive?.contentOrNull
        println("✅ Created post: $postId")
        
        // 3. Get the record
        val post = pb.collection("posts").getOne(postId ?: "")
        println("✅ Retrieved post: ${post["title"]?.jsonPrimitive?.contentOrNull}")
        
        // 4. Update the record
        val updated = pb.collection("posts").update(
            id = postId ?: "",
            body = mapOf("title" to "Updated Title")
        )
        println("✅ Updated post")
        
        // 5. List records with filter
        val results = pb.collection("posts").getList(
            page = 1,
            perPage = 10,
            filter = "status = 'published'",
            sort = "-created"
        )
        println("✅ Found ${results.totalItems} published posts")
        
        // 6. Delete the record
        pb.collection("posts").delete(postId ?: "")
        println("✅ Deleted post")
        
    } catch (e: ClientResponseError) {
        println("❌ Error: ${e.status} - ${e.response}")
    }
}

import kotlinx.coroutines.runBlocking
import com.bosbase.sdk.BosBase

fun main() = runBlocking {
    val pb = BosBase("http://127.0.0.1:8090")
    
    // All SDK methods are synchronous but can be called from coroutines
    val posts = pb.collection("posts").getList(page = 1, perPage = 10)
    
    posts.items.forEach { post ->
        println(post["title"]?.jsonPrimitive?.contentOrNull)
    }
}

import com.bosbase.sdk.ClientResponseError

try {
    val record = pb.collection("posts").getOne("INVALID_ID")
} catch (e: ClientResponseError) {
    when (e.status) {
        404 -> println("Record not found")
        403 -> println("Access forbidden")
        400 -> println("Bad request: ${e.response}")
        else -> println("Error: ${e.status}")
    }
}

// Safe parameter binding
val searchTerm = "user's post"
val filter = pb.filter(
    "title ~ {:term} && views > {:minViews}",
    mapOf(
        "term" to searchTerm,
        "minViews" to 100
    )
)

val results = pb.collection("posts").getList(
    page = 1,
    perPage = 50,
    filter = filter
)

import com.bosbase.sdk.FileAttachment
import java.io.File

val file = File("path/to/image.jpg")
val attachment = FileAttachment.fromFile(file)

val record = pb.collection("posts").create(
    body = mapOf("title" to "Post with Image"),
    files = mapOf("image" to listOf(attachment))
)

val unsubscribe = pb.collection("posts").subscribe("*") { event ->
    val action = event["action"]?.toString()
    val record = event["record"]
    println("$action: $record")
}

// Later...
unsubscribe()