44 lines
1.2 KiB
TypeScript
44 lines
1.2 KiB
TypeScript
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;
|
|
}
|