Struct FichubClient 

pub struct FichubClient { /* private fields */ }

A client for the FicHub REST API.

Implementations

impl FichubClient

pub fn new(config: Arc<BotConfig>) -> Result<Self>

Build a new client from a config.

pub fn with_client(config: Arc<BotConfig>, http: Client) -> Self

Build a client with a custom reqwest::Client (used in tests with a mock).

pub fn http(&self) -> &Client

Access the underlying reqwest::Client (shared with intent/LLM callers).

pub async fn fetch_export(&self, url: &str) -> Result<ExportResponse>

GET /api/epub?q=<url> — export metadata + download URLs.

pub async fn lazy_convert( &self, url: &str, format: &str, ) -> Result<ConvertResponse>

GET /api/epub/convert?q=<url>&format=mobi|pdf|azw3 — lazy conversion.

pub async fn fetch_meta(&self, url: &str) -> Result<ExportResponse>

GET /api/meta?q=<url> — metadata only (no download URLs).

pub async fn recommendations( &self, url: &str, n: i32, ) -> Result<RecommendationsResponse>

GET /api/recommendations?q=&n= — similar works to a seed URL.

pub async fn personal_recommendations( &self, token: &str, ) -> Result<PersonalRecommendationsResponse>

GET /api/recommendations/personal — personalized recs (auth).

pub async fn strategies(&self) -> Result<Value>

GET /api/recommendations/strategies — list available strategies.

pub async fn search(&self, params: &SearchParams) -> Result<SearchResponse>

GET /api/search?q=&page=&per_page= — advanced search.

pub async fn ask(&self, q: &str) -> Result<AskResponse>

POST /api/search/ask — LLM-assisted natural-language search.

pub async fn body_search( &self, q: &str, page: usize, per_page: usize, ) -> Result<BodySearchResponse>

GET /api/search/body?q=&page=&per_page= — full-text body search.

pub async fn feed(&self, token: &str, page: i64) -> Result<FeedResponse>

GET /api/v1/feed?page= — new chapters from followed works (auth).

pub async fn add_bookmark(&self, token: &str, url_id: &str) -> Result<Value>

POST /api/bookmarks — bookmark a fic (auth).

pub async fn remove_bookmark(&self, token: &str, work_id: i64) -> Result<Value>

DELETE /api/bookmarks/{work_id} — remove a bookmark (auth).

pub async fn rate(&self, token: &str, url_id: &str, stars: i32) -> Result<Value>

POST /api/ratings — rate a fic (auth).

pub async fn add_block(&self, token: &str, url_id: &str) -> Result<Value>

POST /api/blocks — block/hide a fic from recommendations (auth).

pub async fn remove_block(&self, token: &str, url_id: &str) -> Result<Value>

DELETE /api/blocks/{url_id} — unblock a fic (auth).

pub async fn kudos(&self, work_id: i64) -> Result<Value>

GET /api/kudos/{work_id} — kudos counts for a work.

pub async fn list_requests( &self, status: &str, page: i64, ) -> Result<RequestsResponse>

GET /api/requests?status=&page= — list requests.

pub async fn create_request( &self, token: &str, title: &str, body: &str, ) -> Result<Value>

POST /api/requests — create a request (auth).

pub async fn consensus(&self) -> Result<ConsensusResponse>

GET /api/roadmap/consensus — public leaderboard + controversy.

pub async fn login( &self, username: &str, password: &str, ) -> Result<AuthResponse>

POST /api/auth/login — exchange username/password for a JWT.

pub async fn me(&self, token: &str) -> Result<MeResponse>

GET /api/auth/me — verify a token, get the current user.

pub async fn docs_ask(&self, q: &str, n: usize) -> Result<Vec<Value>>

GET /api/docs/ask?q=...&n=... — Ask-the-Docs RAG (grounded help). Returns the top matching doc sections (with anchors) as JSON values.

pub async fn forum_categories( &self, token: &str, ) -> Result<ForumCategoriesResponse>

GET /api/forum/categories — visible categories + topic counts (auth).

pub async fn forum_topics( &self, token: &str, category: Option<&str>, cursor: Option<i64>, limit: u32, ) -> Result<ForumTopicList>

GET /api/forum/topics?category=&cursor=&limit= — cursor-paginated topic list for a category (auth). cursor is the last topic id seen (from next_cursor); omit for the first page.

pub async fn forum_topic( &self, token: &str, topic_id: i64, after: Option<i64>, ) -> Result<ForumTopicDetail>

GET /api/forum/topics/{id}?after= — topic detail + posts (auth). after is the last post id seen (from next_cursor); omit for the first page (OP + newest posts, default limit 25).

pub async fn forum_topic_by_slug( &self, token: &str, slug: &str, ) -> Result<ForumTopicDetail>

GET /api/forum/topics/by-slug/{slug} — topic detail resolved by the canonical slug (same shape as forum_topic, auth).

pub async fn forum_create_topic( &self, token: &str, title: &str, category_slug: &str, body: &str, payload: Option<Value>, ) -> Result<ForumCreateTopicResponse>

POST /api/forum/topics — create a topic + OP post (auth).

pub async fn forum_reply( &self, token: &str, topic_id: i64, body: &str, quote_of: Option<i64>, ) -> Result<ForumPostCreated>

POST /api/forum/topics/{id}/posts — reply to a topic (auth).

pub async fn forum_follow( &self, token: &str, topic_id: i64, ) -> Result<ForumFollowState>

POST /api/forum/topics/{id}/follow — toggle follow (auth).

pub async fn forum_follow_state( &self, token: &str, topic_id: i64, ) -> Result<ForumFollowState>

GET /api/forum/topics/{id}/follow — my follow state + follower count (auth).

pub async fn forum_mark_read( &self, token: &str, topic_id: i64, last_read_post_id: Option<i64>, ) -> Result<ForumMarkRead>

POST /api/forum/topics/{id}/read — mark a topic read (auth). last_read_post_id defaults to the topic’s newest post when None.

pub async fn forum_search( &self, token: &str, q: &str, category: Option<&str>, ) -> Result<ForumSearchResponse>

GET /api/forum/search?q=&category= — FTS over topics + posts (auth).

pub async fn forum_moderation_status( &self, token: &str, ) -> Result<ForumModerationStatus>

GET /api/forum/moderation/status — my points + eligibility (auth).

pub async fn forum_moderation_queue( &self, token: &str, ) -> Result<ForumModerationQueue>

GET /api/forum/moderation/queue — posts needing moderation (auth).

pub async fn forum_moderate( &self, token: &str, post_id: i64, reason: &str, ) -> Result<ForumModerateResponse>

POST /api/forum/posts/{id}/moderate — spend 1 point on a post (auth).

pub async fn forum_metamod_queue( &self, token: &str, ) -> Result<ForumMetamodQueue>

GET /api/forum/metamod/queue — anonymized actions to rate (auth).

pub async fn forum_metamod_vote( &self, token: &str, action_id: i64, verdict: &str, ) -> Result<ForumMetamodVoteResponse>

POST /api/forum/metamod/{action_id}/vote — rate a mod action (auth). verdict is one of fair | unfair | unsure.

Trait Implementations

impl Clone for FichubClient

fn clone(&self) -> FichubClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FichubClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.