use crate::client::Client;
use crate::error::Error;
use serde::{Deserialize, Serialize};
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "lowercase")]
#[non_exhaustive]
pub enum CollectionVisibility {
Private,
Public,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
#[non_exhaustive]
pub struct Collection {
pub id: i64,
pub name: String,
pub owner: String,
#[serde(default)]
pub description: Option<String>,
#[serde(default)]
pub visibility: Option<CollectionVisibility>,
pub created: i64,
pub updated: i64,
#[serde(default)]
pub documents: Option<i64>,
#[serde(default)]
pub size: Option<i64>,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
#[non_exhaustive]
pub struct Collections {
pub data: Vec<Collection>,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CollectionRequest {
pub name: String,
#[serde(skip_serializing_if = "Option::is_none")]
pub description: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub visibility: Option<CollectionVisibility>,
}
impl CollectionRequest {
pub fn new(name: impl Into<String>) -> Self {
Self {
name: name.into(),
description: None,
visibility: None,
}
}
#[must_use]
pub fn description(mut self, description: impl Into<String>) -> Self {
self.description = Some(description.into());
self
}
#[must_use]
pub fn visibility(mut self, visibility: CollectionVisibility) -> Self {
self.visibility = Some(visibility);
self
}
}
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct CollectionUpdateRequest {
#[serde(skip_serializing_if = "Option::is_none")]
pub name: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub description: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub visibility: Option<CollectionVisibility>,
}
impl CollectionUpdateRequest {
#[must_use]
pub fn new() -> Self {
Self::default()
}
#[must_use]
pub fn name(mut self, name: impl Into<String>) -> Self {
self.name = Some(name.into());
self
}
#[must_use]
pub fn description(mut self, description: impl Into<String>) -> Self {
self.description = Some(description.into());
self
}
#[must_use]
pub fn visibility(mut self, visibility: CollectionVisibility) -> Self {
self.visibility = Some(visibility);
self
}
}
#[derive(Debug, Clone, Default, Serialize)]
pub struct CollectionsQuery {
#[serde(skip_serializing_if = "Option::is_none")]
pub offset: Option<u32>,
#[serde(skip_serializing_if = "Option::is_none")]
pub limit: Option<u32>,
}
impl CollectionsQuery {
#[must_use]
pub fn new() -> Self {
Self::default()
}
#[must_use]
pub fn offset(mut self, offset: u32) -> Self {
self.offset = Some(offset);
self
}
#[must_use]
pub fn limit(mut self, limit: u32) -> Self {
self.limit = Some(limit);
self
}
}
#[derive(Deserialize)]
struct CreatedId {
id: i64,
}
impl Client {
pub async fn create_collection(&self, req: &CollectionRequest) -> Result<i64, Error> {
let url = self.endpoint("/v1/collections")?;
let created: CreatedId = self.post_json(url, req).await?;
Ok(created.id)
}
pub async fn collections(&self, query: &CollectionsQuery) -> Result<Collections, Error> {
let url = self.endpoint("/v1/collections")?;
self.get_json_with_query(url, query).await
}
pub async fn collection(
&self,
collection_id: impl std::fmt::Display,
) -> Result<Collection, Error> {
let url = self.endpoint_with_segment("/v1/collections", &collection_id.to_string())?;
self.get_json(url).await
}
pub async fn update_collection(
&self,
collection_id: impl std::fmt::Display,
update: &CollectionUpdateRequest,
) -> Result<(), Error> {
let url = self.endpoint_with_segment("/v1/collections", &collection_id.to_string())?;
self.patch_no_content(url, update).await
}
pub async fn delete_collection(
&self,
collection_id: impl std::fmt::Display,
) -> Result<(), Error> {
let url = self.endpoint_with_segment("/v1/collections", &collection_id.to_string())?;
self.delete_no_content(url).await
}
}