Files
jiang13-forum/frontend/src/api/client.ts
freefire b24f6c23ea 优化帖子详情与列表展示,并新增问答帖类型与已解决状态。
统一标题锚点定位、编辑底栏固定与操作栏分层,列表徽章前置并区分置顶/问答配色。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-04 00:19:32 +08:00

390 lines
18 KiB
TypeScript

import type { User, UserPublic, UserActivityStats, Board, PostItem, Comment, RecentComment, ForumStats, TagCount, AdminDashboard, AdminSettings, ForumLimits, ForumLimitsPublic, PostDetailResponse, PostRevision, CommentRevision, MailConfig, OIDCConfig, OAuthClient, OAuthClientInput, GiteaProject, GiteaSyncConfig, StorageConfig, MediaListResult, SiteBranding, RegisterConfig, PrivateMessage, MessageConversation, PostReport, ReportReason, ReportStatus } from './types';
const BASE = '';
async function request<T>(url: string, opts: RequestInit = {}): Promise<T> {
const res = await fetch(BASE + url, {
credentials: 'same-origin',
...opts,
headers: {
...(opts.body instanceof FormData ? {} : { 'Content-Type': 'application/json' }),
...opts.headers,
},
});
let data: Record<string, unknown>;
try {
data = await res.json();
} catch {
throw new Error('服务器响应异常');
}
if (!res.ok) throw new Error((data.error as string) || '请求失败');
return data as T;
}
export const api = {
me: () => request<{ user: User | null }>('/api/me'),
stats: () => request<ForumStats>('/api/stats'),
forumLimits: () => request<ForumLimitsPublic>('/api/forum-limits'),
siteBranding: () => request<SiteBranding>('/api/site-branding'),
boards: () => request<{ boards: Board[] }>('/api/boards'),
projects: (params?: { page?: number; limit?: number }) => {
const q = new URLSearchParams();
if (params?.page) q.set('page', String(params.page));
if (params?.limit) q.set('limit', String(params.limit));
const qs = q.toString();
return request<{ projects: GiteaProject[]; total: number; page: number; total_pages: number }>(
`/api/projects${qs ? `?${qs}` : ''}`,
);
},
posts: (params: Record<string, string | number>) => {
const q = new URLSearchParams(params as Record<string, string>).toString();
return request<{ posts: PostItem[]; total: number; page: number; has_more: boolean }>(`/api/posts?${q}`);
},
hotPosts: () => request<{ posts: PostItem[] }>('/api/posts/hot'),
tags: (limit = 40) => request<{ tags: TagCount[] }>(`/api/tags?limit=${limit}`),
post: (id: number, opts?: { skipView?: boolean }) => {
const q = opts?.skipView ? '?skip_view=1' : '';
return request<PostDetailResponse>(`/api/posts/${id}${q}`);
},
comments: (id: number, myIds?: number[]) => {
const q = myIds?.length ? `?my_ids=${myIds.join(',')}` : '';
return request<{ comments: Comment[]; total: number }>(`/api/posts/${id}/comments${q}`);
},
recentComments: () => request<{ comments: RecentComment[] }>('/api/comments/recent'),
favorites: () => request<{ favorites: unknown[]; total: number }>('/api/favorites'),
createBoard: (body: { name: string; description: string; sort_order: number; icon?: string; color_index?: number }) =>
request<{ board: Board }>('/api/admin/boards', { method: 'POST', body: JSON.stringify(body) }),
updateBoard: (id: number, body: { name: string; description: string; sort_order: number; icon?: string; color_index?: number }) =>
request<{ board: Board }>(`/api/admin/boards/${id}`, { method: 'PUT', body: JSON.stringify(body) }),
deleteBoard: (id: number) => request(`/api/admin/boards/${id}`, { method: 'DELETE' }),
// 管理后台 API
adminDashboard: () => request<AdminDashboard>('/api/admin/dashboard'),
adminSettings: () => request<AdminSettings>('/api/admin/settings'),
adminPosts: (params: { page?: number; keyword?: string; status?: string }) => {
const q = new URLSearchParams();
if (params.page) q.set('page', String(params.page));
if (params.keyword) q.set('keyword', params.keyword);
if (params.status) q.set('status', params.status);
const qs = q.toString();
return request<{
posts: PostItem[];
total: number;
page: number;
total_pages: number;
pending_count?: number;
status?: string;
}>(`/api/admin/posts${qs ? `?${qs}` : ''}`);
},
adminApprovePost: (id: number) =>
request<{ message: string; status: string }>(`/api/admin/posts/${id}/approve`, { method: 'POST' }),
adminPinPost: (id: number, pinned: boolean) =>
request<{ message: string; pinned: boolean }>(`/api/admin/posts/${id}/pin`, {
method: 'POST', body: JSON.stringify({ pinned }),
}),
adminFeaturePost: (id: number, featured: boolean) =>
request<{ message: string; featured: boolean }>(`/api/admin/posts/${id}/feature`, {
method: 'POST', body: JSON.stringify({ featured }),
}),
adminLockPost: (id: number, locked: boolean) =>
request<{ message: string; edit_locked: boolean }>(`/api/admin/posts/${id}/lock`, {
method: 'POST', body: JSON.stringify({ locked }),
}),
adminRejectPost: (id: number, reason: string) =>
request<{ message: string; notified: boolean }>(`/api/admin/posts/${id}/reject`, {
method: 'POST', body: JSON.stringify({ reason }),
}),
adminReports: (params?: { page?: number; status?: ReportStatus | 'all' | string }) => {
const q = new URLSearchParams();
if (params?.page) q.set('page', String(params.page));
if (params?.status) q.set('status', params.status);
const qs = q.toString();
return request<{
reports: PostReport[];
total: number;
page: number;
pending_count: number;
status: string;
}>(`/api/admin/reports${qs ? `?${qs}` : ''}`);
},
adminHandleReport: (id: number, body: {
action: 'dismiss' | 'resolve' | 'reject_post';
handle_note?: string;
reject_reason?: string;
}) =>
request<{ message: string; report: PostReport }>(`/api/admin/reports/${id}/handle`, {
method: 'POST', body: JSON.stringify(body),
}),
adminUpdateForumSettings: (body: ForumLimits) =>
request<{ message: string; limits: ForumLimits }>('/api/admin/settings/forum', {
method: 'PUT', body: JSON.stringify(body),
}),
adminUpdateMailSettings: (body: MailConfig) =>
request<{ message: string; mail: MailConfig }>('/api/admin/settings/mail', {
method: 'PUT', body: JSON.stringify(body),
}),
adminUpdateOIDCSettings: (body: OIDCConfig) =>
request<{ message: string; oidc: OIDCConfig }>('/api/admin/settings/oidc', {
method: 'PUT', body: JSON.stringify(body),
}),
adminUpdateGiteaSettings: (body: GiteaSyncConfig) =>
request<{ message: string; gitea: GiteaSyncConfig }>('/api/admin/settings/gitea', {
method: 'PUT', body: JSON.stringify(body),
}),
adminSyncGitea: () =>
request<{ message: string; count: number; gitea: GiteaSyncConfig }>('/api/admin/settings/gitea/sync', {
method: 'POST',
}),
adminUpdateStorageSettings: (body: StorageConfig) =>
request<{ message: string; storage: StorageConfig }>('/api/admin/settings/storage', {
method: 'PUT', body: JSON.stringify(body),
}),
adminUpdateBranding: (body: SiteBranding) =>
request<{ message: string; branding: SiteBranding }>('/api/admin/settings/branding', {
method: 'PUT', body: JSON.stringify(body),
}),
adminUploadBrandingAsset: (kind: 'logo' | 'favicon' | 'og_image', file: File) => {
const fd = new FormData();
fd.append('kind', kind);
fd.append('file', file);
return request<{ message: string; url: string; branding: SiteBranding }>(
'/api/admin/settings/branding/upload',
{ method: 'POST', body: fd, headers: {} },
);
},
adminClearBrandingAsset: (kind: 'logo' | 'favicon' | 'og_image') =>
request<{ message: string; branding: SiteBranding }>('/api/admin/settings/branding/clear', {
method: 'POST', body: JSON.stringify({ kind }),
}),
adminListOAuthClients: () =>
request<{ clients: OAuthClient[] }>('/api/admin/oauth/clients'),
adminCreateOAuthClient: (body: OAuthClientInput) =>
request<{ message: string; client: OAuthClient; oidc: OIDCConfig }>('/api/admin/oauth/clients', {
method: 'POST', body: JSON.stringify(body),
}),
adminUpdateOAuthClient: (id: number, body: OAuthClientInput) =>
request<{ message: string; client: OAuthClient; oidc: OIDCConfig }>(`/api/admin/oauth/clients/${id}`, {
method: 'PUT', body: JSON.stringify(body),
}),
adminDeleteOAuthClient: (id: number) =>
request<{ message: string; oidc: OIDCConfig }>(`/api/admin/oauth/clients/${id}`, {
method: 'DELETE',
}),
adminTestMail: (to: string) =>
request<{ message: string }>('/api/admin/settings/mail/test', {
method: 'POST', body: JSON.stringify({ to }),
}),
adminUpdateFilterWords: (content: string) =>
request<{ message: string; word_count: number }>('/api/admin/settings/filter-words', {
method: 'PUT', body: JSON.stringify({ content }),
}),
postRevisions: (id: number) =>
request<{ revisions: PostRevision[] }>(`/api/posts/${id}/revisions`),
postRevision: (id: number, revId: number) =>
request<{ revision: PostRevision }>(`/api/posts/${id}/revisions/${revId}`),
adminDeletePost: (id: number) => request(`/api/admin/posts/${id}`, { method: 'DELETE' }),
adminTrashPosts: (params: { page?: number; keyword?: string }) => {
const q = new URLSearchParams();
if (params.page) q.set('page', String(params.page));
if (params.keyword) q.set('keyword', params.keyword);
const qs = q.toString();
return request<{ posts: (PostItem & { deleted_at: string })[]; total: number; page: number; total_pages: number }>(
`/api/admin/posts/trash${qs ? `?${qs}` : ''}`,
);
},
adminRestorePost: (id: number) =>
request<{ message: string }>(`/api/admin/posts/${id}/restore`, { method: 'POST' }),
adminPurgePost: (id: number) =>
request<{ message: string }>(`/api/admin/posts/${id}/purge`, { method: 'DELETE' }),
adminComments: (params?: { page?: number; status?: string }) => {
const q = new URLSearchParams();
if (params?.page) q.set('page', String(params.page));
if (params?.status) q.set('status', params.status);
const qs = q.toString();
return request<{
comments: Comment[];
total: number;
page: number;
total_pages: number;
pending_count?: number;
}>(`/api/admin/comments${qs ? `?${qs}` : ''}`);
},
adminApproveComment: (id: number) =>
request<{ message: string; status: string }>(`/api/admin/comments/${id}/approve`, { method: 'POST' }),
adminRejectComment: (id: number, reason?: string) =>
request<{ message: string; status: string }>(`/api/admin/comments/${id}/reject`, {
method: 'POST', body: JSON.stringify({ reason: reason || '' }),
}),
adminDeleteComment: (id: number) => request(`/api/admin/comments/${id}`, { method: 'DELETE' }),
adminCommentRevisions: (id: number) =>
request<{ revisions: CommentRevision[] }>(`/api/admin/comments/${id}/revisions`),
adminUsers: (page = 1) =>
request<{ users: User[]; total: number; page: number; total_pages: number }>(
`/api/admin/users?page=${page}`,
),
adminBanUser: (id: number, banned: boolean) =>
request<{ message: string; banned: boolean }>(`/api/admin/users/${id}/ban`, {
method: 'POST', body: JSON.stringify({ banned }),
}),
adminMedia: (params?: { category?: string; page?: number; size?: number; q?: string }) => {
const sp = new URLSearchParams();
if (params?.category) sp.set('category', params.category);
if (params?.page) sp.set('page', String(params.page));
if (params?.size) sp.set('size', String(params.size));
if (params?.q) sp.set('q', params.q);
const qs = sp.toString();
return request<MediaListResult>(`/api/admin/media${qs ? `?${qs}` : ''}`);
},
adminDeleteMedia: (urls: string[]) =>
request<{ message: string; deleted: number }>('/api/admin/media/delete', {
method: 'POST', body: JSON.stringify({ urls }),
}),
adminBackup: () =>
request<{ message: string; filename: string; download: string }>('/api/admin/backup', { method: 'POST' }),
profileStats: () => request<{ stats: UserActivityStats }>('/api/profile/stats'),
userProfile: (id: number) =>
request<{ user: UserPublic; stats: UserActivityStats }>(`/api/users/${id}`),
updateNickname: (nickname: string) => {
const fd = new FormData();
fd.append('nickname', nickname);
return request('/api/profile/nickname', { method: 'POST', body: fd, headers: {} });
},
updateSignature: (signature: string) => {
const fd = new FormData();
fd.append('signature', signature);
return request<{ message: string; user: User }>('/api/profile/signature', {
method: 'POST', body: fd, headers: {},
});
},
updatePassword: (oldPassword: string, newPassword: string) => {
const fd = new FormData();
fd.append('old_password', oldPassword);
fd.append('new_password', newPassword);
return request('/api/profile/password', { method: 'POST', body: fd, headers: {} });
},
uploadAvatar: (file: File) => {
const fd = new FormData();
fd.append('avatar', file);
return request<{ avatar: string }>('/api/profile/avatar', { method: 'POST', body: fd, headers: {} });
},
uploadPostImage: (file: File) => {
const fd = new FormData();
fd.append('image', file);
return request<{ url: string }>('/api/uploads/image', { method: 'POST', body: fd, headers: {} });
},
createPost: (data: { board_id: string; title: string; content: string; tags?: string; post_type?: string }) => {
const fd = new FormData();
fd.append('board_id', data.board_id);
fd.append('title', data.title);
fd.append('content', data.content);
fd.append('tags', data.tags || '');
fd.append('post_type', data.post_type || 'normal');
return request<{ post_id: number; message?: string; status?: string }>('/api/posts', { method: 'POST', body: fd, headers: {} });
},
updatePost: (id: number, data: { title: string; content: string; tags?: string; board_id?: string | number; post_type?: string }) => {
const fd = new FormData();
fd.append('title', data.title);
fd.append('content', data.content);
fd.append('tags', data.tags || '');
if (data.board_id != null && data.board_id !== '') {
fd.append('board_id', String(data.board_id));
}
if (data.post_type) {
fd.append('post_type', data.post_type);
}
return request<{ message: string }>(`/api/posts/${id}`, { method: 'PUT', body: fd, headers: {} });
},
setQuestionResolved: (id: number, resolved: boolean) => {
const fd = new FormData();
fd.append('resolved', resolved ? '1' : '0');
return request<{ message: string; question_resolved: boolean }>(`/api/posts/${id}/resolve`, {
method: 'POST',
body: fd,
headers: {},
});
},
deletePost: (id: number) => request<{ message: string }>(`/api/posts/${id}`, { method: 'DELETE' }),
login: (username: string, password: string) => {
const fd = new FormData();
fd.append('username', username);
fd.append('password', password);
return request('/api/login', { method: 'POST', body: fd, headers: {} });
},
register: (data: {
username: string;
password: string;
nickname: string;
email: string;
emailCode?: string;
}) => {
const fd = new FormData();
fd.append('username', data.username);
fd.append('password', data.password);
fd.append('nickname', data.nickname);
fd.append('email', data.email);
if (data.emailCode) fd.append('email_code', data.emailCode);
return request('/api/register', { method: 'POST', body: fd, headers: {} });
},
registerConfig: () => request<RegisterConfig>('/api/register/config'),
sendRegisterEmailCode: (email: string) =>
request<{ message: string }>('/api/register/email-code', {
method: 'POST',
body: JSON.stringify({ email }),
}),
captcha: () => request<{ id: string; image: string }>('/api/captcha'),
logout: () => request('/api/logout', { method: 'POST' }),
like: (id: number) => request<{ liked: boolean; like_count: number }>(`/api/posts/${id}/like`, { method: 'POST' }),
favorite: (id: number) => request<{ favorited: boolean }>(`/api/posts/${id}/favorite`, { method: 'POST' }),
reportPost: (id: number, body: { reason: ReportReason; detail?: string }) =>
request<{ message: string; report: PostReport }>(`/api/posts/${id}/report`, {
method: 'POST', body: JSON.stringify(body),
}),
messageConversations: (params?: { page?: number; size?: number }) => {
const q = new URLSearchParams();
if (params?.page) q.set('page', String(params.page));
if (params?.size) q.set('size', String(params.size));
const qs = q.toString();
return request<{ conversations: MessageConversation[]; total: number; page: number }>(
`/api/messages/conversations${qs ? `?${qs}` : ''}`,
);
},
conversationMessages: (peerId: number, params?: { size?: number; before?: number }) => {
const q = new URLSearchParams();
if (params?.size) q.set('size', String(params.size));
if (params?.before) q.set('before', String(params.before));
const qs = q.toString();
return request<{
messages: PrivateMessage[];
total: number;
peer_user_id: number;
peer_user?: User;
is_system: boolean;
}>(`/api/messages/conversations/${peerId}${qs ? `?${qs}` : ''}`);
},
markConversationRead: (peerId: number) =>
request<{ message: string }>(`/api/messages/conversations/${peerId}/read`, { method: 'POST' }),
messageUnreadCount: () => request<{ count: number }>('/api/messages/unread-count'),
sendMessage: (body: { to_user_id: number; subject?: string; content: string }) =>
request<{ message: PrivateMessage }>('/api/messages', {
method: 'POST', body: JSON.stringify(body),
}),
markAllMessagesRead: () =>
request<{ message: string }>('/api/messages/read-all', { method: 'POST' }),
addComment: (postId: number, data: {
content: string;
replyTo?: number;
isPrivate?: boolean;
}) => {
const fd = new FormData();
fd.append('content', data.content);
if (data.replyTo) fd.append('reply_to', String(data.replyTo));
if (data.isPrivate) fd.append('is_private', '1');
return request<{ message: string; floor: number; id: number; status?: string }>(`/api/posts/${postId}/comments`, { method: 'POST', body: fd, headers: {} });
},
updateComment: (id: number, content: string) => {
const fd = new FormData();
fd.append('content', content);
return request<{ message: string; content: string; status?: string }>(`/api/comments/${id}`, { method: 'PUT', body: fd, headers: {} });
},
deleteComment: (id: number) => request<{ message: string }>(`/api/comments/${id}`, { method: 'DELETE' }),
};