mirror of https://github.com/LemmyNet/lemmy.git
305 lines
9.4 KiB
Rust
305 lines
9.4 KiB
Rust
use lemmy_db_schema::{
|
|
newtypes::{CommentId, CommunityId, DbUrl, LanguageId, PostId, PostReportId},
|
|
ListingType,
|
|
PostFeatureType,
|
|
SortType,
|
|
};
|
|
use lemmy_db_views::structs::{PaginationCursor, PostReportView, PostView, VoteView};
|
|
use lemmy_db_views_actor::structs::{CommunityModeratorView, CommunityView};
|
|
use serde::{Deserialize, Serialize};
|
|
use serde_with::skip_serializing_none;
|
|
#[cfg(feature = "full")]
|
|
use ts_rs::TS;
|
|
use url::Url;
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Create a post.
|
|
pub struct CreatePost {
|
|
pub name: String,
|
|
pub community_id: CommunityId,
|
|
#[cfg_attr(feature = "full", ts(type = "string"))]
|
|
pub url: Option<Url>,
|
|
/// An optional body for the post in markdown.
|
|
pub body: Option<String>,
|
|
/// An optional alt_text, usable for image posts.
|
|
pub alt_text: Option<String>,
|
|
/// A honeypot to catch bots. Should be None.
|
|
pub honeypot: Option<String>,
|
|
pub nsfw: Option<bool>,
|
|
pub language_id: Option<LanguageId>,
|
|
#[cfg_attr(feature = "full", ts(type = "string"))]
|
|
/// Instead of fetching a thumbnail, use a custom one.
|
|
pub custom_thumbnail: Option<Url>,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
pub struct PostResponse {
|
|
pub post_view: PostView,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Copy, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Get a post. Needs either the post id, or comment_id.
|
|
pub struct GetPost {
|
|
pub id: Option<PostId>,
|
|
pub comment_id: Option<CommentId>,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// The post response.
|
|
pub struct GetPostResponse {
|
|
pub post_view: PostView,
|
|
pub community_view: CommunityView,
|
|
pub moderators: Vec<CommunityModeratorView>,
|
|
/// A list of cross-posts, or other times / communities this link has been posted to.
|
|
pub cross_posts: Vec<PostView>,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Serialize, Deserialize, Debug, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Get a list of posts.
|
|
pub struct GetPosts {
|
|
pub type_: Option<ListingType>,
|
|
pub sort: Option<SortType>,
|
|
/// DEPRECATED, use page_cursor
|
|
pub page: Option<i64>,
|
|
pub limit: Option<i64>,
|
|
pub community_id: Option<CommunityId>,
|
|
pub community_name: Option<String>,
|
|
pub saved_only: Option<bool>,
|
|
pub liked_only: Option<bool>,
|
|
pub disliked_only: Option<bool>,
|
|
pub show_hidden: Option<bool>,
|
|
pub page_cursor: Option<PaginationCursor>,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Serialize, Deserialize, Debug, Clone)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// The post list response.
|
|
pub struct GetPostsResponse {
|
|
pub posts: Vec<PostView>,
|
|
/// the pagination cursor to use to fetch the next page
|
|
pub next_page: Option<PaginationCursor>,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Copy, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Like a post.
|
|
pub struct CreatePostLike {
|
|
pub post_id: PostId,
|
|
/// Score must be -1, 0, or 1.
|
|
pub score: i16,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Edit a post.
|
|
pub struct EditPost {
|
|
pub post_id: PostId,
|
|
pub name: Option<String>,
|
|
#[cfg_attr(feature = "full", ts(type = "string"))]
|
|
pub url: Option<Url>,
|
|
/// An optional body for the post in markdown.
|
|
pub body: Option<String>,
|
|
/// An optional alt_text, usable for image posts.
|
|
pub alt_text: Option<String>,
|
|
pub nsfw: Option<bool>,
|
|
pub language_id: Option<LanguageId>,
|
|
#[cfg_attr(feature = "full", ts(type = "string"))]
|
|
/// Instead of fetching a thumbnail, use a custom one.
|
|
pub custom_thumbnail: Option<Url>,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Copy, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Delete a post.
|
|
pub struct DeletePost {
|
|
pub post_id: PostId,
|
|
pub deleted: bool,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Remove a post (only doable by mods).
|
|
pub struct RemovePost {
|
|
pub post_id: PostId,
|
|
pub removed: bool,
|
|
pub reason: Option<String>,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Mark a post as read.
|
|
pub struct MarkPostAsRead {
|
|
pub post_ids: Vec<PostId>,
|
|
pub read: bool,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Hide a post from list views
|
|
pub struct HidePost {
|
|
pub post_ids: Vec<PostId>,
|
|
pub hide: bool,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Copy, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Lock a post (prevent new comments).
|
|
pub struct LockPost {
|
|
pub post_id: PostId,
|
|
pub locked: bool,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Copy, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Feature a post (stickies / pins to the top).
|
|
pub struct FeaturePost {
|
|
pub post_id: PostId,
|
|
pub featured: bool,
|
|
pub feature_type: PostFeatureType,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Copy, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Save / bookmark a post.
|
|
pub struct SavePost {
|
|
pub post_id: PostId,
|
|
pub save: bool,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Create a post report.
|
|
pub struct CreatePostReport {
|
|
pub post_id: PostId,
|
|
pub reason: String,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// The post report response.
|
|
pub struct PostReportResponse {
|
|
pub post_report_view: PostReportView,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Copy, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Resolve a post report (mods only).
|
|
pub struct ResolvePostReport {
|
|
pub report_id: PostReportId,
|
|
pub resolved: bool,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Copy, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// List post reports.
|
|
pub struct ListPostReports {
|
|
pub page: Option<i64>,
|
|
pub limit: Option<i64>,
|
|
/// Only shows the unresolved reports
|
|
pub unresolved_only: Option<bool>,
|
|
/// if no community is given, it returns reports for all communities moderated by the auth user
|
|
pub community_id: Option<CommunityId>,
|
|
pub post_id: Option<PostId>,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// The post reports response.
|
|
pub struct ListPostReportsResponse {
|
|
pub post_reports: Vec<PostReportView>,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Get metadata for a given site.
|
|
pub struct GetSiteMetadata {
|
|
#[cfg_attr(feature = "full", ts(type = "string"))]
|
|
pub url: Url,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// The site metadata response.
|
|
pub struct GetSiteMetadataResponse {
|
|
pub metadata: LinkMetadata,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Deserialize, Serialize, PartialEq, Eq, Clone, Default, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Site metadata, from its opengraph tags.
|
|
pub struct LinkMetadata {
|
|
#[serde(flatten)]
|
|
pub opengraph_data: OpenGraphData,
|
|
pub content_type: Option<String>,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Deserialize, Serialize, PartialEq, Eq, Clone, Default, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Site metadata, from its opengraph tags.
|
|
pub struct OpenGraphData {
|
|
pub title: Option<String>,
|
|
pub description: Option<String>,
|
|
pub(crate) image: Option<DbUrl>,
|
|
pub embed_video_url: Option<DbUrl>,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Copy, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// List post likes. Admins-only.
|
|
pub struct ListPostLikes {
|
|
pub post_id: PostId,
|
|
pub page: Option<i64>,
|
|
pub limit: Option<i64>,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// The post likes response
|
|
pub struct ListPostLikesResponse {
|
|
pub post_likes: Vec<VoteView>,
|
|
}
|