Pocketbase SDK

A Rust SDK for Pocketbase Clients. Pocketbase is an open source backend for your SaaS & Mobile Applications. The Goal of this project is to create a wrapper around the APIs that Pocketbase exposes to abstract away unnecessary details of implementation, so that you can focus on building your app and not worry about integration with pocketbase.

Pocketbase SDK currently only known to work on x86 targets. So essentially only CLI/Native applications can be built using Pocketbase SDK. But WebAsm support is on the [Roadmap](#roadmap)

Installation

bash $ cargo add pocketbase-sdk or add the following to your Cargo.toml

toml [dependencies] pocketbase-sdk = "0.0.6" tokio = { version = "1", features = ["full"] } serde = { version = "1.0.145", features = ["derive"] }

Usage

```rust use serde::{Serialize, Deserialize} use pocketbasesdk::client::Client; use pocketbasesdk::user::UserTypes; use pocketbase_sdk::records::operations::{ list, view, delete, create };

[derive(Serialize, Deserialize, Debug)]

struct Post { id: String, title: String, content: String, created: String, updated: String, author: String, }

[tokio::main]

async fn main() -> Result<(), Box> { /* new client + authentication / let mut client = Client::new("http://localhost:8090/api/").unwrap(); let auth = client.auth_via_email( String::from("sreedev@icloud.com"), String::from("Admin@123"), UserTypes::User / use UserTypes::Admin for admin Authentication */ ).await; assert!(auth.is_ok())

/* create record */
let record = Post {
  title: "Sample title".to_string(),
  content: "Sample Content".to_string(),
  author: client.user.unwrap().token,
  created: "".to_string,
  updated: "".to_string
};

let repsonse = create::record::<Post>("posts", &post, &client).await.unwrap();
match repsonse {
    create::CreateResponse::SuccessResponse(res) => {
        assert_eq!(res.title, String::from("Sample title"))
    },
    create::CreateResponse::FailureResponse(_err) => panic!("Failed!")
}

/* view record */
let repsonse = view::record::<Post>("posts", "9bbl183t7ioqrea", &client).await.unwrap();
match repsonse {
    view::ViewResponse::SuccessResponse(res) => assert_eq!(res.id, "9bbl183t7ioqrea"),
    view::ViewResponse::ErrorResponse(_err) => panic!("Failed!")
}

/* list paginated records */
let response = list::records::<Post>("posts", &client).await.unwrap();
match response {
  list::ListResponse::SuccessResponse(paginated_record_list) => {
    assert_ne!(paginated_record_list.total_items, 0)
  },
  list::ListResponse::ErrorResponse(_e) => panic!("could not retrieve resource.")
}

/* delete a record */
let response = delete::record("posts", "9bbl183t7ioqrea", &client).await;
assert!(response.is_ok());

Ok(())

}

```

Roadmap

1. WebAsm Support (v0.1.7)
2. Support Record File Attachments Upload #11
3. Admin Tools: Logs
4. Admin Tools: Settings
5. Support Pocketbase Realtime APIs