SPB Git

Repository Public

sse.ts 5.9 KB 149 lines typescript

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
Files main
Menu

Theme