Repository Public
1// Lecture d'un flux text/event-stream reçu par fetch (EventSource ne sait pas émettre de POST).2// Analyseur incrémental : tolère les coupures de bloc n'importe où (au milieu d'une ligne, d'un caractère UTF-8 côté appelant,3// entre « \r » et « \n »), les trois fins de ligne (LF, CRLF, CR), les commentaires « : ping » et les champs inconnus.45export interface SseEvent {6 /** nom de l'événement (« message » si le flux n'en donne pas) */7 event: string8 /** lignes `data:` jointes par un saut de ligne */9 data: string10 id?: string11}1213export interface SseParser {14 /** Ajoute un morceau de texte ; rend les événements complets qu'il termine. */15 feed(chunk: string): SseEvent[]16 /** Fin du flux : un événement non terminé par une ligne vide est abandonné (comme le veut la norme). */17 end(): SseEvent[]18 /** nombre de commentaires reçus (battements de cœur) */19 readonly comments: number20}2122export function createSseParser(): SseParser {23 let buffer = ""24 let event = ""25 let data: string[] = []26 let id: string | undefined27 let comments = 028 let first = true2930 const line = (l: string, out: SseEvent[]) => {31 if (l === "") {32 // ligne vide : l'événement en cours est émis s'il porte des données33 if (data.length) out.push({ event: event || "message", data: data.join("\n"), ...(id !== undefined ? { id } : {}) })34 event = ""35 data = []36 return37 }38 if (l.startsWith(":")) {39 comments++40 return41 }42 const colon = l.indexOf(":")43 const field = colon === -1 ? l : l.slice(0, colon)44 let value = colon === -1 ? "" : l.slice(colon + 1)45 if (value.startsWith(" ")) value = value.slice(1)46 if (field === "event") event = value47 else if (field === "data") data.push(value)48 else if (field === "id" && !value.includes("\u0000")) id = value49 // « retry » et les champs inconnus sont ignorés50 }5152 return {53 feed(chunk) {54 const out: SseEvent[] = []55 if (first && chunk) {56 first = false57 if (chunk.charCodeAt(0) === 0xfeff) chunk = chunk.slice(1)58 }59 buffer += chunk60 let start = 061 for (;;) {62 let i = start63 while (i < buffer.length && buffer[i] !== "\n" && buffer[i] !== "\r") i++64 if (i >= buffer.length) break65 // un « \r » en toute fin de tampon peut être la moitié d'un « \r\n » : on attend la suite66 if (buffer[i] === "\r" && i + 1 >= buffer.length) break67 line(buffer.slice(start, i), out)68 start = buffer[i] === "\r" && buffer[i + 1] === "\n" ? i + 2 : i + 169 }70 buffer = buffer.slice(start)71 return out72 },73 end() {74 const out: SseEvent[] = []75 if (buffer.endsWith("\r")) {76 line(buffer.slice(0, -1), out)77 buffer = ""78 }79 buffer = ""80 event = ""81 data = []82 return out83 },84 get comments() {85 return comments86 },87 }88}8990/** Lit un flux d'octets jusqu'au bout et appelle `onEvent` pour chaque événement, dans l'ordre. */91export async function readSseStream(body: ReadableStream<Uint8Array>, onEvent: (e: SseEvent) => void): Promise<void> {92 const parser = createSseParser()93 const decoder = new TextDecoder("utf-8")94 const reader = body.getReader()95 try {96 for (;;) {97 const { done, value } = await reader.read()98 if (done) break99 // stream: true — un caractère coupé entre deux morceaux est recollé par le décodeur100 for (const e of parser.feed(decoder.decode(value, { stream: true }))) onEvent(e)101 }102 for (const e of parser.feed(decoder.decode())) onEvent(e)103 for (const e of parser.end()) onEvent(e)104 } finally {105 reader.releaseLock()106 }107}108109// ---------------------------------------------------------------- événements du générateur de modèles (docs/templates-api.md)110export const GENERATION_ERROR_CODES = ["ai_not_configured", "ai_refused", "ai_rate_limited", "ai_output_truncated", "ai_invalid_output", "ai_unreachable", "ai_error", "cancelled"] as const111export type GenerationErrorCode = (typeof GENERATION_ERROR_CODES)[number] | "rate_limited" | "invalid_request" | "not_found" | "offline" | "unauthorized" | "interrupted"112113export type GenerationEvent<T> =114 | { type: "start"; model: string; revising: boolean }115 | { type: "progress"; chars: number }116 | { type: "done"; template: T; usage: { input_tokens: number; output_tokens: number; model: string; seconds: number } }117 | { type: "error"; code: GenerationErrorCode; message: string }118119/** Traduit un événement brut en événement typé ; `null` pour ce qui est inconnu ou mal formé (ignoré, jamais fatal). */120export function parseGenerationEvent<T>(e: SseEvent): GenerationEvent<T> | null {121 let d: Record<string, unknown>122 try {123 const parsed: unknown = JSON.parse(e.data)124 if (!parsed || typeof parsed !== "object") return null125 d = parsed as Record<string, unknown>126 } catch {127 return null128 }129 switch (e.event) {130 case "start":131 return { type: "start", model: typeof d.model === "string" ? d.model : "", revising: d.revising === true }132 case "progress":133 return typeof d.chars === "number" && Number.isFinite(d.chars) ? { type: "progress", chars: Math.max(0, Math.floor(d.chars)) } : null134 case "done": {135 const tpl = d.template as T | undefined136 if (!tpl || typeof tpl !== "object") return null137 const u = (d.usage ?? {}) as Record<string, unknown>138 const n = (v: unknown) => (typeof v === "number" && Number.isFinite(v) ? v : 0)139 return { type: "done", template: tpl, usage: { input_tokens: n(u.input_tokens), output_tokens: n(u.output_tokens), model: typeof u.model === "string" ? u.model : "", seconds: n(u.seconds) } }140 }141 case "error": {142 const code = typeof d.code === "string" && (GENERATION_ERROR_CODES as readonly string[]).includes(d.code) ? (d.code as GenerationErrorCode) : "ai_error"143 return { type: "error", code, message: typeof d.message === "string" ? d.message : "" }144 }145 default:146 return null147 }148}149