Repository Public
1// Clés d'API : formes rendues par /api/admin/api-keys (docs/API.md §13) et appels. Le jeton complet n'apparaît que dans la2// réponse d'une création ou d'une rotation : il est remis à l'appelant, jamais gardé ici.3import type { ExternalPolicy, KeyLike, KeyPayload, UsageCall } from "../../../admin/scopes"4import { apiDelete, apiGet, apiPatch, apiPost } from "../../../jmap/http"5import type { ApiAddress } from "../../../mail/v1"6import { loadAddresses } from "../kit"7import { asArray, asNumber, asString, isRecord } from "../shared"89export interface ApiKey extends KeyLike {10 id: string11 /** partie publique du jeton : spm_<10 caractères> */12 prefix: string13 scopes: string[]14 address_ids: string[]15 external_send_policy: ExternalPolicy16 allowed_recipient_domains: string[]17 revoked_at: string | null18 last_used_at: string | null19 created_by: string | null20 rotated_from: string | null21 created_at: string22 state: "active" | "revoked" | "expired"23}24export interface Created {25 key: ApiKey26 token: string27}28export interface Rotated extends Created {29 previous: ApiKey30}3132export interface UsageDay {33 day: string34 requests: number35 errors: number36 explorer: number37}38export interface UsageRoute {39 method: string40 route: string41 requests: number42 errors: number43 avgMs: number | null44}45export interface Usage {46 key: ApiKey47 days: number48 byDay: UsageDay[]49 byRoute: UsageRoute[]50 /** envois de la période, par état */51 sends: { status: string; n: number }[]52 /** 200 derniers appels, du plus récent au plus ancien (toutes périodes) */53 recent: UsageCall[]54}5556const BASE = "/api/admin/api-keys"57const one = (id: string) => `${BASE}/${encodeURIComponent(id)}`5859export const listKeys = (signal?: AbortSignal) => apiGet<ApiKey[]>(BASE, signal)60export const createKey = (payload: KeyPayload) => apiPost<Created>(BASE, payload)61export const patchKey = (id: string, patch: Partial<KeyPayload>) => apiPatch<ApiKey>(one(id), patch)62export const rotateKey = (id: string, graceSeconds: number) => apiPost<Rotated>(`${one(id)}/rotate`, { grace_seconds: graceSeconds })63export const revokeKey = (id: string) => apiDelete<{ ok: boolean; key: ApiKey }>(one(id))6465/** Lecture défensive des agrégats : un champ absent ne casse pas l'écran. */66export async function loadUsage(id: string, days: number, signal?: AbortSignal): Promise<Usage> {67 const raw = await apiGet<Record<string, unknown>>(`${one(id)}/usage?days=${days}`, signal)68 const sends = isRecord(raw.sends) ? raw.sends : {}69 return {70 key: raw.key as ApiKey,71 days: asNumber(raw.days) ?? days,72 byDay: asArray(raw.by_day).filter(isRecord).map((d) => ({ day: asString(d.day) ?? "", requests: asNumber(d.requests) ?? 0, errors: asNumber(d.errors) ?? 0, explorer: asNumber(d.explorer) ?? 0 })),73 byRoute: asArray(raw.by_route).filter(isRecord).map((r) => ({ method: asString(r.method) ?? "", route: asString(r.route) ?? "", requests: asNumber(r.requests) ?? 0, errors: asNumber(r.errors) ?? 0, avgMs: asNumber(r.avg_ms) })),74 sends: Object.entries(sends).map(([status, n]) => ({ status, n: asNumber(n) ?? 0 })).sort((a, b) => b.n - a.n),75 recent: asArray(raw.recent).filter(isRecord).map((c) => ({76 at: asString(c.at) ?? "", method: asString(c.method) ?? "", route: asString(c.route) ?? "", status: asNumber(c.status) ?? 0, duration_ms: asNumber(c.duration_ms),77 ip: asString(c.ip), error_code: asString(c.error_code), explorer: c.explorer === true,78 })),79 }80}8182export interface KeysData {83 keys: ApiKey[]84 addresses: ApiAddress[]85}86export async function loadKeysData(signal: AbortSignal): Promise<KeysData> {87 const [keys, addresses] = await Promise.all([listKeys(signal), loadAddresses(signal)])88 return { keys: asArray(keys) as ApiKey[], addresses }89}9091/** Révocation programmée (rotation avec délai de grâce) : la clé marche encore, jusqu'à cette date. */92export const pendingRevocation = (k: ApiKey): string | null => (k.state === "active" && k.revoked_at ? k.revoked_at : null)93