import { validateRealtimeEvent, type RealtimeEvent } from "./events.js"; export type RealtimeSseSerializeOptions = { retry?: number; }; export function serializeRealtimeComment(comment: string): string { const sanitizedComment = sanitizeSseLine(comment, "comment"); return `: ${sanitizedComment}\n\n`; } export function serializeRealtimeEvent(input: unknown, options: RealtimeSseSerializeOptions = {}): string { const event = validateRealtimeEvent(input); const retryLine = serializeRetry(options.retry); const data = JSON.stringify(toSerializableRealtimeEvent(event)); return `${retryLine}id: ${sanitizeSseLine(event.cursor, "cursor")}\nevent: ${event.event}\ndata: ${data}\n\n`; } function serializeRetry(retry: number | undefined): string { if (retry === undefined) { return ""; } if (!Number.isInteger(retry) || retry < 0) { throw new Error("retry must be a non-negative integer"); } return `retry: ${retry}\n`; } function sanitizeSseLine(value: string, label: string): string { if (value.includes("\n") || value.includes("\r")) { throw new Error(`${label} must not contain newline characters`); } return value; } function toSerializableRealtimeEvent(event: RealtimeEvent): RealtimeEvent { return event; }