// Typed client for the Parsimony admin REST API (/api/v1). export type PostPolicy = 'members' | 'moderated' export type JoinPolicy = 'open' | 'closed' export type ArchivePolicy = 'public' | 'private' | 'off' export interface List { id: number name: string domain: string title: string address: string post_policy: PostPolicy join_policy: JoinPolicy archive_policy: ArchivePolicy } export interface Member { address: string display_name: string disabled: boolean bounce_count: number } export interface Held { id: number sender: string subject: string size: number created_at: string /** Why the message was held, for the admin. */ reason: string } export interface Message { id: number thread_id: number message_id: string in_reply_to?: string subject: string sender: string date: string size: number body?: string } export interface ImportSummary { imported: number duplicates: number failed: number errors: string[] } export interface ArchivePage { total: number messages: Message[] } export interface QueueItem { id: number recipient: string attempts: number last_error: string next_attempt: string created_at: string } export interface Queue { pending: number retrying: number oldest: string | null items: QueueItem[] } export class ApiError extends Error { readonly status: number constructor(status: number, message: string) { super(message) this.name = 'ApiError' this.status = status } } const TOKEN_KEY = 'parsimony.token' let unauthorizedHandler: (() => void) | null = null /** The bearer token lives in sessionStorage: it dies with the tab. */ export const session = { get: (): string | null => sessionStorage.getItem(TOKEN_KEY), set: (token: string) => sessionStorage.setItem(TOKEN_KEY, token), clear: () => sessionStorage.removeItem(TOKEN_KEY), /** Called after any 401, once the token has been cleared. */ onUnauthorized: (fn: (() => void) | null) => { unauthorizedHandler = fn }, } async function request(method: string, path: string, body?: unknown): Promise { const headers: Record = {} const token = session.get() if (token) headers.Authorization = `Bearer ${token}` // A file is streamed as is; everything else is JSON. const raw = body instanceof Blob if (body !== undefined) headers['Content-Type'] = raw ? 'application/mbox' : 'application/json' let res: Response try { res = await fetch(`/api/v1${path}`, { method, headers, body: body === undefined ? undefined : raw ? body : JSON.stringify(body), }) } catch { throw new ApiError(0, 'Cannot reach the server') } if (res.status === 401) { session.clear() unauthorizedHandler?.() } if (!res.ok) { let message = `Request failed (${res.status})` try { const data = await res.json() if (typeof data?.error === 'string') message = data.error } catch { // not JSON: keep the generic message } throw new ApiError(res.status, message) } if (res.status === 204) return undefined as T return (await res.json()) as T } const enc = encodeURIComponent export const api = { lists: { list: () => request('GET', '/lists'), get: (id: number) => request('GET', `/lists/${id}`), create: (b: { name: string; domain: string; title?: string }) => request('POST', '/lists', b), update: ( id: number, b: Partial>, ) => request('PATCH', `/lists/${id}`, b), remove: (id: number) => request('DELETE', `/lists/${id}`), }, members: { list: (listId: number) => request('GET', `/lists/${listId}/members`), add: (listId: number, b: { address: string; display_name?: string }) => request('POST', `/lists/${listId}/members`, b), remove: (listId: number, address: string) => request('DELETE', `/lists/${listId}/members/${enc(address)}`), }, held: { list: (listId: number) => request('GET', `/lists/${listId}/held`), approve: (id: number) => request('POST', `/held/${id}/approve`), discard: (id: number) => request('DELETE', `/held/${id}`), }, queue: { get: () => request('GET', '/queue'), discard: (id: number) => request('DELETE', `/queue/${id}`), }, archive: { list: (listId: number, p: { q?: string; limit?: number; offset?: number } = {}) => { const qs = new URLSearchParams() if (p.q) qs.set('q', p.q) if (p.limit !== undefined) qs.set('limit', String(p.limit)) if (p.offset !== undefined) qs.set('offset', String(p.offset)) const s = qs.toString() return request('GET', `/lists/${listId}/archive${s ? `?${s}` : ''}`) }, import: (listId: number, file: Blob) => request('POST', `/lists/${listId}/archive/import`, file), get: (id: number) => request('GET', `/archive/${id}`), remove: (id: number) => request('DELETE', `/archive/${id}`), }, }