2026-08-02 07:37:07 +08:00
|
|
|
import type { User, AdminUser, AdminOverview, Domain, Mailbox, Alias, MailFolder, Attachment, MailLabel, MailMessage, MailTranslation, DNSRecord, DNSCheckResult, ListResponse, SendPayload, DraftPayload, ScheduleSendPayload, ScheduledSend, SendQueueItem, SendQueueAuditEvent, SendQueueStatus, Contact, MailSignature, MailRule, MailRuleCondition, MailRuleAction, BlockedSender, MailStats, ForwardingSettings, ExternalImapAccount, ExternalImapAccountPayload, ExternalImapFolder, ExternalImapOAuthProvider, ExternalImapOAuthStartPayload, ExternalImapSyncRun, MailboxApplyOptions, MailTemplate, MaildirSyncHealth, SystemSettings, SystemSettingsPayload, PublicSettings, LoginPayload, LoginResponse, RegisterPayload, PermissionGroup, PermissionInfo, PermissionKey, PermissionLimits, APIToken } from "./api-types"
|
2026-06-16 10:10:21 +08:00
|
|
|
export * from "./api-types"
|
2026-06-14 01:07:48 +08:00
|
|
|
|
2026-06-15 17:37:40 +08:00
|
|
|
const REQUEST_TIMEOUT_MS = 15_000
|
2026-06-16 22:28:04 +08:00
|
|
|
const MAIL_DELIVERY_TIMEOUT_MS = 60_000
|
2026-06-15 17:37:40 +08:00
|
|
|
|
2026-08-02 05:55:53 +08:00
|
|
|
export type MailSearchParams = {
|
|
|
|
|
q?: string
|
|
|
|
|
from?: string
|
|
|
|
|
to?: string
|
|
|
|
|
subject?: string
|
|
|
|
|
startDate?: string
|
|
|
|
|
endDate?: string
|
|
|
|
|
attachmentMode?: "all" | "with" | "without"
|
|
|
|
|
minSizeKb?: string
|
|
|
|
|
maxSizeKb?: string
|
|
|
|
|
readStatus?: "all" | "read" | "unread"
|
|
|
|
|
flagStatus?: "all" | "starred" | "unstarred"
|
|
|
|
|
hasAttachments?: boolean
|
|
|
|
|
unread?: boolean
|
|
|
|
|
starred?: boolean
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
function appendMailSearchParams(params: URLSearchParams, search: MailSearchParams | string) {
|
|
|
|
|
if (typeof search === "string") {
|
|
|
|
|
if (search) params.set("q", search)
|
|
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
if (search.q) params.set("q", search.q)
|
|
|
|
|
if (search.from) params.set("from", search.from)
|
|
|
|
|
if (search.to) params.set("to", search.to)
|
|
|
|
|
if (search.subject) params.set("subject", search.subject)
|
|
|
|
|
if (search.startDate) params.set("startDate", search.startDate)
|
|
|
|
|
if (search.endDate) params.set("endDate", search.endDate)
|
|
|
|
|
if (search.attachmentMode && search.attachmentMode !== "all") params.set("attachmentMode", search.attachmentMode)
|
|
|
|
|
else if (search.hasAttachments) params.set("hasAttachments", "1")
|
|
|
|
|
if (search.minSizeKb) params.set("minSizeKb", search.minSizeKb)
|
|
|
|
|
if (search.maxSizeKb) params.set("maxSizeKb", search.maxSizeKb)
|
|
|
|
|
if (search.readStatus && search.readStatus !== "all") params.set("readStatus", search.readStatus)
|
|
|
|
|
else if (search.unread) params.set("unread", "1")
|
|
|
|
|
if (search.flagStatus && search.flagStatus !== "all") params.set("flagStatus", search.flagStatus)
|
|
|
|
|
else if (search.starred) params.set("starred", "1")
|
|
|
|
|
}
|
|
|
|
|
|
2026-06-16 22:28:04 +08:00
|
|
|
async function request<T>(path: string, init: RequestInit & { timeoutMs?: number } = {}): Promise<T> {
|
|
|
|
|
const { timeoutMs, ...requestInit } = init
|
2026-06-15 17:37:40 +08:00
|
|
|
const controller = new AbortController()
|
2026-06-16 22:28:04 +08:00
|
|
|
const timeout = window.setTimeout(() => controller.abort(), timeoutMs || REQUEST_TIMEOUT_MS)
|
|
|
|
|
const externalSignal = requestInit.signal
|
2026-06-15 17:37:40 +08:00
|
|
|
if (externalSignal) {
|
|
|
|
|
if (externalSignal.aborted) controller.abort()
|
|
|
|
|
else externalSignal.addEventListener("abort", () => controller.abort(), { once: true })
|
|
|
|
|
}
|
|
|
|
|
try {
|
2026-06-16 22:28:04 +08:00
|
|
|
const res = await fetch(path, { credentials: "include", headers: { "Content-Type": "application/json", ...(requestInit.headers || {}) }, ...requestInit, signal: controller.signal })
|
2026-06-15 17:37:40 +08:00
|
|
|
if (!res.ok) {
|
|
|
|
|
let message = `${res.status} ${res.statusText}`
|
|
|
|
|
try { const body = await res.json(); message = body.error || message } catch {}
|
|
|
|
|
throw new Error(message)
|
|
|
|
|
}
|
|
|
|
|
return res.json() as Promise<T>
|
|
|
|
|
} catch (error) {
|
|
|
|
|
if (error instanceof DOMException && error.name === "AbortError") {
|
|
|
|
|
throw new Error("请求超时,请检查后端服务是否正常")
|
|
|
|
|
}
|
|
|
|
|
throw error instanceof Error ? error : new Error("网络请求失败")
|
|
|
|
|
} finally {
|
|
|
|
|
window.clearTimeout(timeout)
|
2026-06-14 01:07:48 +08:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
export const api = {
|
2026-06-15 00:37:43 +08:00
|
|
|
publicSettings: () => request<PublicSettings>("/api/public/settings"),
|
2026-06-15 23:57:56 +08:00
|
|
|
register: (payload: RegisterPayload) => request<{ user: User }>("/api/auth/register", { method: "POST", body: JSON.stringify(payload) }),
|
2026-06-15 00:37:43 +08:00
|
|
|
login: (payload: LoginPayload) => request<LoginResponse>("/api/auth/login", { method: "POST", body: JSON.stringify(payload) }),
|
2026-06-14 01:07:48 +08:00
|
|
|
logout: () => request<{ ok: boolean }>("/api/auth/logout", { method: "POST" }),
|
|
|
|
|
me: () => request<{ user: User }>("/api/me"),
|
|
|
|
|
updateProfile: (payload: { displayName: string }) => request<{ user: User }>("/api/me/profile", { method: "POST", body: JSON.stringify(payload) }),
|
|
|
|
|
changePassword: (payload: { currentPassword: string; newPassword: string }) => request<{ ok: boolean }>("/api/me/password", { method: "POST", body: JSON.stringify(payload) }),
|
2026-06-29 15:31:20 +08:00
|
|
|
apiTokens: () => request<ListResponse<APIToken>>("/api/me/api-tokens"),
|
2026-07-10 10:47:58 +08:00
|
|
|
createApiToken: (payload: { name: string; expiresAt?: string; scopes: string[] }) => request<{ token: string; item: APIToken }>("/api/me/api-tokens", { method: "POST", body: JSON.stringify(payload) }),
|
|
|
|
|
updateApiToken: (id: string, payload: { name?: string; expiresAt?: string; disabled?: boolean; scopes?: string[] }) => request<APIToken>(`/api/me/api-tokens/${id}`, { method: "POST", body: JSON.stringify(payload) }),
|
2026-06-29 15:31:20 +08:00
|
|
|
deleteApiToken: (id: string) => request<{ ok: boolean }>(`/api/me/api-tokens/${id}`, { method: "DELETE" }),
|
2026-06-15 00:37:43 +08:00
|
|
|
setupTwoFactor: () => request<{ secret: string; otpauthUrl: string }>("/api/me/2fa/setup", { method: "POST" }),
|
|
|
|
|
enableTwoFactor: (code: string) => request<{ user: User }>("/api/me/2fa/enable", { method: "POST", body: JSON.stringify({ code }) }),
|
|
|
|
|
disableTwoFactor: (code: string) => request<{ user: User }>("/api/me/2fa/disable", { method: "POST", body: JSON.stringify({ code }) }),
|
2026-06-14 01:07:48 +08:00
|
|
|
contacts: () => request<ListResponse<Contact>>("/api/me/contacts"),
|
|
|
|
|
createContact: (payload: { name: string; email: string; note: string }) => request<Contact>("/api/me/contacts", { method: "POST", body: JSON.stringify(payload) }),
|
|
|
|
|
deleteContact: (id: string) => request<{ ok: boolean }>(`/api/me/contacts/${id}`, { method: "DELETE" }),
|
2026-06-16 23:15:35 +08:00
|
|
|
signatures: () => request<ListResponse<MailSignature>>("/api/me/signatures"),
|
|
|
|
|
createSignature: (payload: { mailboxId: string; name: string; content: string; isDefault: boolean }) => request<MailSignature>("/api/me/signatures", { method: "POST", body: JSON.stringify(payload) }),
|
|
|
|
|
updateSignature: (id: string, payload: { mailboxId: string; name: string; content: string; isDefault: boolean }) => request<MailSignature>(`/api/me/signatures/${id}`, { method: "POST", body: JSON.stringify(payload) }),
|
|
|
|
|
setDefaultSignature: (id: string) => request<MailSignature>(`/api/me/signatures/${id}/default`, { method: "POST" }),
|
|
|
|
|
deleteSignature: (id: string) => request<{ ok: boolean }>(`/api/me/signatures/${id}`, { method: "DELETE" }),
|
|
|
|
|
defaultSignature: (mailboxId?: string) => request<{ signature: MailSignature | null }>(`/api/me/signatures/default${mailboxId ? `?mailboxId=${encodeURIComponent(mailboxId)}` : ""}`),
|
2026-06-14 01:07:48 +08:00
|
|
|
rules: () => request<ListResponse<MailRule>>("/api/me/rules"),
|
2026-06-15 21:50:44 +08:00
|
|
|
createRule: (payload: { mailboxId: string; name: string; matchMode: "all" | "any"; conditions: MailRuleCondition[]; actions: MailRuleAction[]; applyToExisting: boolean; stopProcessing: boolean; enabled: boolean }) => request<MailRule>("/api/me/rules", { method: "POST", body: JSON.stringify(payload) }),
|
2026-06-14 01:07:48 +08:00
|
|
|
deleteRule: (id: string) => request<{ ok: boolean }>(`/api/me/rules/${id}`, { method: "DELETE" }),
|
|
|
|
|
blockedSenders: () => request<ListResponse<BlockedSender>>("/api/me/blocked-senders"),
|
|
|
|
|
createBlockedSender: (payload: { mailboxId: string; email: string; reason: string }) => request<BlockedSender>("/api/me/blocked-senders", { method: "POST", body: JSON.stringify(payload) }),
|
|
|
|
|
deleteBlockedSender: (id: string) => request<{ ok: boolean }>(`/api/me/blocked-senders/${id}`, { method: "DELETE" }),
|
|
|
|
|
mailStats: (mailboxId?: string) => request<MailStats>(`/api/me/stats${mailboxId ? `?mailboxId=${encodeURIComponent(mailboxId)}` : ""}`),
|
|
|
|
|
cleanupMail: (payload: { mailboxId: string; target: "empty-trash" | "empty-spam" | "archive-read-inbox" }) => request<{ ok: boolean; affected: number }>("/api/me/cleanup", { method: "POST", body: JSON.stringify(payload) }),
|
2026-06-16 00:51:41 +08:00
|
|
|
mailboxApplyOptions: () => request<MailboxApplyOptions>("/api/me/mailbox-apply-options"),
|
|
|
|
|
applyMailbox: (payload: { domainId: string; localPart: string; displayName: string }) => request<Mailbox>("/api/me/mailboxes/apply", { method: "POST", body: JSON.stringify(payload) }),
|
2026-08-02 07:37:07 +08:00
|
|
|
forwardingSettings: () => request<ForwardingSettings>("/api/me/forwarding"),
|
|
|
|
|
addForwardingVerifiedEmail: (email: string) => request<ForwardingSettings>("/api/me/forwarding/verified-emails", { method: "POST", body: JSON.stringify({ email }) }),
|
|
|
|
|
deleteForwardingVerifiedEmail: (id: string) => request<ForwardingSettings>(`/api/me/forwarding/verified-emails/${id}`, { method: "DELETE" }),
|
|
|
|
|
updateAccountForwarding: (targetEmail: string) => request<ForwardingSettings>("/api/me/forwarding/account", { method: "POST", body: JSON.stringify({ targetEmail }) }),
|
|
|
|
|
updateMailboxForwarding: (mailboxId: string, targetEmail: string) => request<ForwardingSettings>(`/api/me/mailboxes/${mailboxId}/forwarding`, { method: "POST", body: JSON.stringify({ targetEmail }) }),
|
2026-06-25 17:09:46 +08:00
|
|
|
externalImapAccounts: (mailboxId?: string) => request<ListResponse<ExternalImapAccount>>(`/api/me/external-imap-accounts${mailboxId ? `?mailboxId=${encodeURIComponent(mailboxId)}` : ""}`),
|
|
|
|
|
createExternalImapAccount: (payload: ExternalImapAccountPayload) => request<ExternalImapAccount>("/api/me/external-imap-accounts", { method: "POST", body: JSON.stringify(payload) }),
|
|
|
|
|
updateExternalImapAccount: (id: string, payload: ExternalImapAccountPayload) => request<ExternalImapAccount>(`/api/me/external-imap-accounts/${id}`, { method: "POST", body: JSON.stringify(payload) }),
|
|
|
|
|
deleteExternalImapAccount: (id: string) => request<{ ok: boolean }>(`/api/me/external-imap-accounts/${id}`, { method: "DELETE" }),
|
2026-06-25 20:20:37 +08:00
|
|
|
startExternalImapOAuth: (provider: ExternalImapOAuthProvider, payload: ExternalImapOAuthStartPayload) => request<{ url: string }>(`/api/me/external-imap-oauth/${provider}/start`, { method: "POST", body: JSON.stringify(payload) }),
|
2026-06-25 17:09:46 +08:00
|
|
|
testExternalImapAccount: (id: string) => request<{ ok: boolean; folders: number }>(`/api/me/external-imap-accounts/${id}/test`, { method: "POST", timeoutMs: MAIL_DELIVERY_TIMEOUT_MS }),
|
2026-06-25 20:20:37 +08:00
|
|
|
externalImapSyncRuns: (id: string) => request<ListResponse<ExternalImapSyncRun>>(`/api/me/external-imap-accounts/${id}/runs`),
|
2026-06-25 17:09:46 +08:00
|
|
|
syncExternalImapAccount: (id: string) => request<ExternalImapSyncRun>(`/api/me/external-imap-accounts/${id}/sync`, { method: "POST", timeoutMs: MAIL_DELIVERY_TIMEOUT_MS }),
|
2026-06-25 20:20:37 +08:00
|
|
|
syncExternalImapFolder: (id: string, folder: string) => request<ExternalImapSyncRun>(`/api/me/external-imap-accounts/${id}/sync-folder`, { method: "POST", body: JSON.stringify({ folder }), timeoutMs: MAIL_DELIVERY_TIMEOUT_MS }),
|
2026-06-15 00:37:43 +08:00
|
|
|
adminOverview: () => request<AdminOverview>("/api/admin/overview"),
|
|
|
|
|
users: () => request<ListResponse<AdminUser>>("/api/admin/users"),
|
2026-06-22 14:31:10 +08:00
|
|
|
permissionGroups: () => request<ListResponse<PermissionGroup> & { catalog: PermissionInfo[] }>("/api/admin/permission-groups"),
|
2026-06-23 11:09:36 +08:00
|
|
|
createPermissionGroup: (payload: { name: string; description: string; permissions: PermissionKey[]; limits: PermissionLimits }) => request<PermissionGroup>("/api/admin/permission-groups", { method: "POST", body: JSON.stringify(payload) }),
|
|
|
|
|
updatePermissionGroup: (id: string, payload: { name: string; description: string; permissions: PermissionKey[]; limits: PermissionLimits }) => request<PermissionGroup>(`/api/admin/permission-groups/${id}`, { method: "POST", body: JSON.stringify(payload) }),
|
2026-06-23 11:25:38 +08:00
|
|
|
defaultPermissionLimits: () => request<PermissionLimits>("/api/admin/permission-limits/defaults"),
|
2026-06-22 14:31:10 +08:00
|
|
|
deletePermissionGroup: (id: string) => request<{ ok: boolean }>(`/api/admin/permission-groups/${id}`, { method: "DELETE" }),
|
|
|
|
|
createUser: (payload: { email: string; displayName: string; role: "admin" | "user"; password: string; disabled: boolean; permissionGroupIds?: string[] }) => request<AdminUser>("/api/admin/users", { method: "POST", body: JSON.stringify(payload) }),
|
|
|
|
|
updateUser: (id: string, payload: { displayName: string; role: "admin" | "user"; disabled: boolean; permissionGroupIds?: string[] }) => request<AdminUser>(`/api/admin/users/${id}`, { method: "POST", body: JSON.stringify(payload) }),
|
2026-06-15 00:37:43 +08:00
|
|
|
resetUserPassword: (id: string, password: string) => request<{ ok: boolean }>(`/api/admin/users/${id}/password`, { method: "POST", body: JSON.stringify({ password }) }),
|
|
|
|
|
deleteUser: (id: string) => request<{ ok: boolean }>(`/api/admin/users/${id}`, { method: "DELETE" }),
|
2026-06-14 01:07:48 +08:00
|
|
|
domains: () => request<ListResponse<Domain>>("/api/admin/domains"),
|
|
|
|
|
createDomain: (name: string) => request<Domain>("/api/admin/domains", { method: "POST", body: JSON.stringify({ name }) }),
|
2026-06-15 00:37:43 +08:00
|
|
|
updateDomain: (id: string, payload: { status: string }) => request<Domain>(`/api/admin/domains/${id}`, { method: "POST", body: JSON.stringify(payload) }),
|
|
|
|
|
deleteDomain: (id: string) => request<{ ok: boolean }>(`/api/admin/domains/${id}`, { method: "DELETE" }),
|
2026-06-14 01:07:48 +08:00
|
|
|
mailboxes: () => request<ListResponse<Mailbox>>("/api/admin/mailboxes"),
|
2026-06-15 00:37:43 +08:00
|
|
|
createMailbox: (payload: { domainId: string; localPart: string; displayName: string; password: string; quotaMb: number; role: "admin" | "user"; ownerEmail?: string; userId?: string }) => request<Mailbox>("/api/admin/mailboxes", { method: "POST", body: JSON.stringify(payload) }),
|
|
|
|
|
updateMailbox: (id: string, payload: { userId: string; displayName: string; quotaMb: number; status: string }) => request<Mailbox>(`/api/admin/mailboxes/${id}`, { method: "POST", body: JSON.stringify(payload) }),
|
|
|
|
|
deleteMailbox: (id: string) => request<{ ok: boolean }>(`/api/admin/mailboxes/${id}`, { method: "DELETE" }),
|
2026-06-14 01:07:48 +08:00
|
|
|
aliases: () => request<ListResponse<Alias>>("/api/admin/aliases"),
|
|
|
|
|
createAlias: (payload: { domainId: string; source: string; destination: string; enabled: boolean }) => request<Alias>("/api/admin/aliases", { method: "POST", body: JSON.stringify(payload) }),
|
2026-06-15 00:37:43 +08:00
|
|
|
updateAlias: (id: string, payload: { source: string; destination: string; enabled: boolean }) => request<Alias>(`/api/admin/aliases/${id}`, { method: "POST", body: JSON.stringify(payload) }),
|
|
|
|
|
deleteAlias: (id: string) => request<{ ok: boolean }>(`/api/admin/aliases/${id}`, { method: "DELETE" }),
|
|
|
|
|
adminMessages: (params: { mailboxId?: string; folder?: string; q?: string; cursor?: string } = {}) => {
|
|
|
|
|
const query = new URLSearchParams()
|
|
|
|
|
if (params.mailboxId) query.set("mailboxId", params.mailboxId)
|
|
|
|
|
if (params.folder) query.set("folder", params.folder)
|
|
|
|
|
if (params.q) query.set("q", params.q)
|
|
|
|
|
if (params.cursor) query.set("cursor", params.cursor)
|
|
|
|
|
const suffix = query.toString()
|
|
|
|
|
return request<ListResponse<MailMessage>>(`/api/admin/messages${suffix ? `?${suffix}` : ""}`)
|
|
|
|
|
},
|
|
|
|
|
adminMessage: (id: string) => request<MailMessage>(`/api/admin/messages/${id}`),
|
2026-06-24 17:16:01 +08:00
|
|
|
adminSendAudit: (params: { mailboxId?: string; messageId?: string; event?: string; from?: string; to?: string; cursor?: string } = {}) => {
|
|
|
|
|
const query = new URLSearchParams()
|
|
|
|
|
if (params.mailboxId) query.set("mailboxId", params.mailboxId)
|
|
|
|
|
if (params.messageId) query.set("messageId", params.messageId)
|
|
|
|
|
if (params.event) query.set("event", params.event)
|
|
|
|
|
if (params.from) query.set("from", params.from)
|
|
|
|
|
if (params.to) query.set("to", params.to)
|
|
|
|
|
if (params.cursor) query.set("cursor", params.cursor)
|
|
|
|
|
const suffix = query.toString()
|
|
|
|
|
return request<ListResponse<SendQueueAuditEvent>>(`/api/admin/send-audit${suffix ? `?${suffix}` : ""}`)
|
|
|
|
|
},
|
2026-06-15 00:37:43 +08:00
|
|
|
systemSettings: () => request<SystemSettings>("/api/admin/settings"),
|
2026-06-24 16:08:48 +08:00
|
|
|
maildirSyncHealth: () => request<MaildirSyncHealth>("/api/admin/maildir-sync/health"),
|
2026-06-15 00:37:43 +08:00
|
|
|
updateSystemSettings: (payload: SystemSettingsPayload) => request<SystemSettings>("/api/admin/settings", { method: "POST", body: JSON.stringify(payload) }),
|
2026-06-16 22:28:04 +08:00
|
|
|
testSmtp: (to: string) => request<{ ok: boolean }>("/api/admin/settings/test-smtp", { method: "POST", body: JSON.stringify({ to }), timeoutMs: MAIL_DELIVERY_TIMEOUT_MS }),
|
2026-06-15 00:37:43 +08:00
|
|
|
mailTemplates: () => request<ListResponse<MailTemplate>>("/api/admin/mail-templates"),
|
|
|
|
|
updateMailTemplate: (key: string, payload: { subject: string; bodyText: string; bodyHtml: string }) => request<MailTemplate>(`/api/admin/mail-templates/${encodeURIComponent(key)}`, { method: "POST", body: JSON.stringify(payload) }),
|
|
|
|
|
resetMailTemplate: (key: string) => request<MailTemplate>(`/api/admin/mail-templates/${encodeURIComponent(key)}/reset`, { method: "POST" }),
|
2026-06-14 01:07:48 +08:00
|
|
|
dnsRecords: (domainId: string) => request<{ items: DNSRecord[] }>(`/api/admin/domains/${domainId}/dns-records`),
|
|
|
|
|
checkDns: (domainId: string) => request<DNSCheckResult>(`/api/admin/domains/${domainId}/check-dns`, { method: "POST" }),
|
|
|
|
|
myMailboxes: () => request<ListResponse<Mailbox>>("/api/mail/mailboxes"),
|
2026-06-25 17:09:46 +08:00
|
|
|
externalMailAccounts: () => request<ListResponse<ExternalImapAccount>>("/api/mail/external-accounts"),
|
|
|
|
|
externalFolders: (id: string) => request<ListResponse<ExternalImapFolder>>(`/api/mail/external-accounts/${id}/folders`),
|
2026-06-25 20:20:37 +08:00
|
|
|
externalMessages: (id: string, folder: string, cursor = "", q = "") => {
|
|
|
|
|
const params = new URLSearchParams({ folder, cursor, q })
|
2026-06-25 17:09:46 +08:00
|
|
|
return request<ListResponse<MailMessage>>(`/api/mail/external-accounts/${id}/messages?${params.toString()}`)
|
|
|
|
|
},
|
|
|
|
|
externalMessage: (id: string, remoteId: string) => request<MailMessage>(`/api/mail/external-accounts/${id}/messages/${encodeURIComponent(remoteId)}`),
|
|
|
|
|
markExternalRead: (id: string, remoteId: string, read: boolean) => request<{ ok: boolean }>(`/api/mail/external-accounts/${id}/messages/${encodeURIComponent(remoteId)}/mark-read`, { method: "POST", body: JSON.stringify({ read }) }),
|
2026-06-14 01:07:48 +08:00
|
|
|
folders: (mailboxId?: string) => request<ListResponse<MailFolder>>(`/api/mail/folders${mailboxId ? `?mailboxId=${encodeURIComponent(mailboxId)}` : ""}`),
|
2026-06-25 14:11:38 +08:00
|
|
|
createFolder: (payload: { mailboxId?: string; name: string }) => {
|
|
|
|
|
const query = payload.mailboxId ? `?mailboxId=${encodeURIComponent(payload.mailboxId)}` : ""
|
|
|
|
|
return request<MailFolder>(`/api/mail/folders${query}`, { method: "POST", body: JSON.stringify({ name: payload.name }) })
|
|
|
|
|
},
|
2026-06-25 15:42:36 +08:00
|
|
|
reorderFolders: (payload: { mailboxId?: string; folderIds: string[]; folders?: { id: string; sortOrder: number }[] }) => {
|
|
|
|
|
const query = payload.mailboxId ? `?mailboxId=${encodeURIComponent(payload.mailboxId)}` : ""
|
|
|
|
|
return request<{ ok: boolean }>(`/api/mail/folders/reorder${query}`, { method: "POST", body: JSON.stringify(payload.folders ? { folders: payload.folders } : { folderIds: payload.folderIds }) })
|
|
|
|
|
},
|
2026-06-25 15:56:57 +08:00
|
|
|
deleteFolder: (id: string, mailboxId?: string) => request<{ ok: boolean; moved: number }>(`/api/mail/folders/${id}${mailboxId ? `?mailboxId=${encodeURIComponent(mailboxId)}` : ""}`, { method: "DELETE" }),
|
2026-06-15 17:37:40 +08:00
|
|
|
labels: (mailboxId?: string) => request<ListResponse<MailLabel>>(`/api/mail/labels${mailboxId ? `?mailboxId=${encodeURIComponent(mailboxId)}` : ""}`),
|
|
|
|
|
createLabel: (payload: { mailboxId?: string; name: string; color?: string }) => {
|
|
|
|
|
const query = payload.mailboxId ? `?mailboxId=${encodeURIComponent(payload.mailboxId)}` : ""
|
|
|
|
|
return request<MailLabel>(`/api/mail/labels${query}`, { method: "POST", body: JSON.stringify({ name: payload.name, color: payload.color || "" }) })
|
|
|
|
|
},
|
2026-06-22 21:08:11 +08:00
|
|
|
deleteLabel: (id: string, mailboxId?: string) => request<{ labels: MailLabel[] }>(`/api/mail/labels/${id}${mailboxId ? `?mailboxId=${encodeURIComponent(mailboxId)}` : ""}`, { method: "DELETE" }),
|
2026-08-02 05:55:53 +08:00
|
|
|
messages: (folder: string, search: MailSearchParams | string = "", cursor = "", mailboxId?: string) => {
|
|
|
|
|
const params = new URLSearchParams({ folder, cursor })
|
|
|
|
|
appendMailSearchParams(params, search)
|
2026-06-14 01:07:48 +08:00
|
|
|
if (mailboxId) params.set("mailboxId", mailboxId)
|
|
|
|
|
return request<ListResponse<MailMessage>>(`/api/mail/messages?${params.toString()}`)
|
|
|
|
|
},
|
2026-08-02 05:55:53 +08:00
|
|
|
labelMessages: (labelId: string, search: MailSearchParams | string = "", cursor = "", mailboxId?: string) => {
|
|
|
|
|
const params = new URLSearchParams({ labelId, cursor })
|
|
|
|
|
appendMailSearchParams(params, search)
|
2026-06-15 17:37:40 +08:00
|
|
|
if (mailboxId) params.set("mailboxId", mailboxId)
|
|
|
|
|
return request<ListResponse<MailMessage>>(`/api/mail/messages?${params.toString()}`)
|
|
|
|
|
},
|
2026-08-02 05:55:53 +08:00
|
|
|
starredMessages: (search: MailSearchParams | string = "", cursor = "", mailboxId?: string) => {
|
|
|
|
|
const params = new URLSearchParams({ cursor })
|
|
|
|
|
appendMailSearchParams(params, search)
|
2026-06-15 17:37:40 +08:00
|
|
|
if (mailboxId) params.set("mailboxId", mailboxId)
|
|
|
|
|
return request<ListResponse<MailMessage>>(`/api/mail/starred?${params.toString()}`)
|
|
|
|
|
},
|
2026-06-15 21:50:44 +08:00
|
|
|
message: (id: string, options: { markRead?: boolean } = {}) => request<MailMessage>(`/api/mail/messages/${id}${options.markRead === false ? "?markRead=0" : ""}`),
|
2026-06-27 13:22:45 +08:00
|
|
|
translateMessage: (id: string, targetLanguage: string) => request<MailTranslation>(`/api/mail/messages/${id}/translate`, { method: "POST", body: JSON.stringify({ targetLanguage }), timeoutMs: MAIL_DELIVERY_TIMEOUT_MS }),
|
2026-06-27 13:30:31 +08:00
|
|
|
translateExternalMessage: (id: string, remoteId: string, targetLanguage: string) => request<MailTranslation>(`/api/mail/external-accounts/${id}/messages/${encodeURIComponent(remoteId)}/translate`, { method: "POST", body: JSON.stringify({ targetLanguage }), timeoutMs: MAIL_DELIVERY_TIMEOUT_MS }),
|
2026-06-16 22:28:04 +08:00
|
|
|
send: (payload: SendPayload) => request<MailMessage>("/api/mail/send", { method: "POST", body: JSON.stringify(payload), timeoutMs: MAIL_DELIVERY_TIMEOUT_MS }),
|
2026-06-17 13:43:19 +08:00
|
|
|
scheduledSends: (mailboxId?: string) => request<ListResponse<ScheduledSend>>(`/api/mail/scheduled-sends${mailboxId ? `?mailboxId=${encodeURIComponent(mailboxId)}` : ""}`),
|
|
|
|
|
scheduleSend: (payload: ScheduleSendPayload) => request<ScheduledSend>("/api/mail/schedule-send", { method: "POST", body: JSON.stringify(payload), timeoutMs: MAIL_DELIVERY_TIMEOUT_MS }),
|
|
|
|
|
cancelScheduledSend: (id: string) => request<{ ok: boolean }>(`/api/mail/schedule-send/${id}`, { method: "DELETE" }),
|
2026-06-25 16:13:44 +08:00
|
|
|
sendQueue: (params: { mailboxId?: string; status?: SendQueueStatus | "all"; cursor?: string; messageId?: string; recipient?: string; from?: string; to?: string } = {}) => {
|
2026-06-24 16:39:40 +08:00
|
|
|
const query = new URLSearchParams()
|
|
|
|
|
if (params.mailboxId) query.set("mailboxId", params.mailboxId)
|
|
|
|
|
if (params.status && params.status !== "all") query.set("status", params.status)
|
|
|
|
|
if (params.cursor) query.set("cursor", params.cursor)
|
2026-06-25 16:13:44 +08:00
|
|
|
if (params.messageId) query.set("messageId", params.messageId)
|
|
|
|
|
if (params.recipient) query.set("recipient", params.recipient)
|
|
|
|
|
if (params.from) query.set("from", params.from)
|
|
|
|
|
if (params.to) query.set("to", params.to)
|
2026-06-24 16:39:40 +08:00
|
|
|
const suffix = query.toString()
|
|
|
|
|
return request<ListResponse<SendQueueItem>>(`/api/mail/send-queue${suffix ? `?${suffix}` : ""}`)
|
|
|
|
|
},
|
|
|
|
|
sendQueueAudit: (id: string) => request<ListResponse<SendQueueAuditEvent>>(`/api/mail/send-queue/${id}/audit`),
|
|
|
|
|
retrySendQueue: (id: string) => request<SendQueueItem>(`/api/mail/send-queue/${id}/retry`, { method: "POST", timeoutMs: MAIL_DELIVERY_TIMEOUT_MS }),
|
|
|
|
|
cancelSendQueue: (id: string) => request<SendQueueItem>(`/api/mail/send-queue/${id}`, { method: "DELETE" }),
|
2026-06-17 13:43:19 +08:00
|
|
|
saveDraft: (payload: DraftPayload, id?: string) => request<MailMessage>(id ? `/api/mail/drafts/${id}` : "/api/mail/drafts", { method: "POST", body: JSON.stringify(payload), timeoutMs: MAIL_DELIVERY_TIMEOUT_MS }),
|
|
|
|
|
deleteDraft: (id: string) => request<{ ok: boolean }>(`/api/mail/drafts/${id}`, { method: "DELETE" }),
|
2026-06-14 01:07:48 +08:00
|
|
|
markRead: (id: string, read: boolean) => request<{ ok: boolean }>(`/api/mail/messages/${id}/mark-read`, { method: "POST", body: JSON.stringify({ read }) }),
|
|
|
|
|
star: (id: string, starred: boolean) => request<{ ok: boolean }>(`/api/mail/messages/${id}/star`, { method: "POST", body: JSON.stringify({ starred }) }),
|
2026-06-15 17:37:40 +08:00
|
|
|
addLabel: (id: string, payload: { name: string; color?: string }) => request<{ labels: MailLabel[] }>(`/api/mail/messages/${id}/labels`, { method: "POST", body: JSON.stringify(payload) }),
|
|
|
|
|
removeLabel: (id: string, labelID: string) => request<{ labels: MailLabel[] }>(`/api/mail/messages/${id}/labels/${labelID}`, { method: "DELETE" }),
|
2026-06-14 01:07:48 +08:00
|
|
|
move: (id: string, folder: string) => request<{ ok: boolean }>(`/api/mail/messages/${id}/move`, { method: "POST", body: JSON.stringify({ folder }) }),
|
|
|
|
|
delete: (id: string) => request<{ ok: boolean }>(`/api/mail/messages/${id}`, { method: "DELETE" }),
|
|
|
|
|
}
|