@learnorama/mozaik-sdk 0.1.0 → 0.5.0-staging.22.1

package/dist/chunks/connection.js

@@ -0,0 +1,141 @@
+
+import { t as ApiError } from "./client.js";
+import { MessageKind } from "../models.js";
+import { mintChatTicket } from "../api/tutoring-chat.js";
+//#region src/chat/connection.ts
+const positiveId = (value) => Number.isSafeInteger(value) && value > 0;
+function parseMessage(value, requestId) {
+	if (!value || typeof value !== "object") throw new Error("Invalid chat message");
+	const frame = value;
+	if (!positiveId(frame.id) || frame.requestId !== requestId || !Object.values(MessageKind).includes(frame.kind) || frame.senderId != null && !positiveId(frame.senderId) || frame.body != null && typeof frame.body !== "string" || typeof frame.createdAt !== "string" || !Number.isFinite(Date.parse(frame.createdAt))) throw new Error("Invalid chat message");
+	return {
+		id: frame.id,
+		requestId,
+		kind: frame.kind,
+		senderId: frame.senderId,
+		body: frame.body,
+		createdAt: frame.createdAt
+	};
+}
+const terminal = (error) => error instanceof ApiError && [
+	401,
+	403,
+	404
+].includes(error.status);
+const asError = (error) => error instanceof Error ? error : /* @__PURE__ */ new Error("Chat connection failed");
+/** Open an authenticated live feed. Use generated REST methods to send and read history. */
+function connectTutoringChat(options) {
+	if (!positiveId(options.requestId)) throw new TypeError("requestId must be a positive safe integer");
+	const makeSocket = options.webSocketFactory ?? ((url) => new WebSocket(url));
+	const timeoutMs = options.connectTimeoutMs ?? 15e3;
+	if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) throw new TypeError("connectTimeoutMs must be positive");
+	let stopped = false;
+	let attempt = 0;
+	let retryTimer;
+	let disposeAttempt;
+	async function connect() {
+		if (stopped) return;
+		const abort = new AbortController();
+		let socket;
+		let ready = false;
+		const buffered = [];
+		const timer = setTimeout(() => fail(/* @__PURE__ */ new Error("Chat connection timed out")), timeoutMs);
+		const active = () => !stopped && !abort.signal.aborted;
+		function dispose() {
+			clearTimeout(timer);
+			abort.abort();
+			if (socket) {
+				socket.removeEventListener("open", opened);
+				socket.removeEventListener("message", received);
+				socket.removeEventListener("close", closed);
+				socket.removeEventListener("error", errored);
+				if (socket.readyState < 2) socket.close();
+			}
+			buffered.length = 0;
+		}
+		function fail(error, permanent = false) {
+			if (!active()) return;
+			dispose();
+			options.onError?.(error);
+			if (permanent) {
+				stopped = true;
+				options.onStatusChange?.("error");
+				return;
+			}
+			options.onStatusChange?.("reconnecting");
+			const delay = options.retryDelay?.(attempt) ?? Math.min(3e4, 1e3 * 2 ** Math.min(attempt, 5)) * (.5 + Math.random() * .5);
+			attempt++;
+			retryTimer = setTimeout(() => {
+				connect();
+			}, Math.max(0, delay));
+		}
+		function opened() {
+			clearTimeout(timer);
+			options.onStatusChange?.("syncing");
+			(async () => {
+				try {
+					await options.onConnect?.(abort.signal);
+					if (!active()) return;
+					for (const message of buffered) options.onMessage(message);
+					buffered.length = 0;
+					ready = true;
+					attempt = 0;
+					options.onStatusChange?.("connected");
+				} catch (error) {
+					fail(asError(error), terminal(error));
+				}
+			})();
+		}
+		function received(event) {
+			if (!active()) return;
+			try {
+				if (typeof event.data !== "string") throw new Error("Expected a text chat frame");
+				const message = parseMessage(JSON.parse(event.data), options.requestId);
+				if (ready) options.onMessage(message);
+				else {
+					if (buffered.length >= 1e3) throw new Error("Chat recovery buffer exceeded");
+					buffered.push(message);
+				}
+			} catch (error) {
+				fail(asError(error));
+			}
+		}
+		function closed(event) {
+			fail(/* @__PURE__ */ new Error(`Chat connection closed (${event.code})`), event.code === 1008);
+		}
+		function errored() {
+			fail(/* @__PURE__ */ new Error("Chat connection failed"));
+		}
+		disposeAttempt = dispose;
+		options.onStatusChange?.(attempt === 0 ? "connecting" : "reconnecting");
+		try {
+			const { ticket } = await mintChatTicket(options.requestId, {
+				client: options.client,
+				signal: abort.signal
+			});
+			if (!active()) return;
+			const url = new URL(`/tutoring/requests/${options.requestId}/chat`, options.client.baseUrl);
+			url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+			url.searchParams.set("ticket", ticket);
+			socket = makeSocket(url.href);
+			socket.addEventListener("open", opened);
+			socket.addEventListener("message", received);
+			socket.addEventListener("close", closed);
+			socket.addEventListener("error", errored);
+		} catch (error) {
+			fail(asError(error), terminal(error));
+		}
+	}
+	connect();
+	return { close() {
+		if (stopped) return;
+		stopped = true;
+		clearTimeout(retryTimer);
+		disposeAttempt?.();
+		options.onStatusChange?.("closed");
+	} };
+}
+//#endregion
+export { parseMessage as n, connectTutoringChat as t };
+
+//# sourceMappingURL=connection.js.map

package/dist/chunks/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","names":[],"sources":["../../src/chat/connection.ts"],"sourcesContent":["// Handwritten transport. Orval owns src/api, src/react and src/models only.\nimport { ApiError, type Client } from '../client';\nimport { mintChatTicket } from '../api/tutoring-chat/tutoring-chat';\nimport { MessageKind, type MessageRead } from '../models';\n\nexport type ChatStatus = 'connecting' | 'syncing' | 'connected' | 'reconnecting' | 'error' | 'closed';\n\nexport interface ChatConnectionOptions {\n  client: Client;\n  requestId: number;\n  onMessage: (message: MessageRead) => void;\n  /** Runs after subscription readiness, with live messages buffered until it resolves. */\n  onConnect?: (signal: AbortSignal) => Promise<void>;\n  onStatusChange?: (status: ChatStatus) => void;\n  onError?: (error: Error) => void;\n  /** Defaults to the browser's native WebSocket. Also useful for native clients/tests. */\n  webSocketFactory?: (url: string) => WebSocket;\n  /** Attempt starts at zero; the default is exponential backoff with jitter, capped at 30s. */\n  retryDelay?: (attempt: number) => number;\n  connectTimeoutMs?: number;\n}\n\nexport interface ChatConnection {\n  /** Cancels ticket/history requests, reconnect timers and the socket. Safe to call twice. */\n  close(): void;\n}\n\nconst positiveId = (value: unknown): value is number => Number.isSafeInteger(value) && (value as number) > 0;\n\nexport function parseMessage(value: unknown, requestId: number): MessageRead {\n  if (!value || typeof value !== 'object') throw new Error('Invalid chat message');\n  const frame = value as Record<string, unknown>;\n  if (!positiveId(frame.id) || frame.requestId !== requestId ||\n      !(Object.values(MessageKind) as unknown[]).includes(frame.kind) ||\n      (frame.senderId != null && !positiveId(frame.senderId)) ||\n      (frame.body != null && typeof frame.body !== 'string') ||\n      typeof frame.createdAt !== 'string' || !Number.isFinite(Date.parse(frame.createdAt))) {\n    throw new Error('Invalid chat message');\n  }\n  return {\n    id: frame.id, requestId, kind: frame.kind as MessageRead['kind'],\n    senderId: frame.senderId as number | null | undefined,\n    body: frame.body as string | null | undefined, createdAt: frame.createdAt,\n  };\n}\n\nconst terminal = (error: unknown) => error instanceof ApiError && [401, 403, 404].includes(error.status);\nconst asError = (error: unknown) => error instanceof Error ? error : new Error('Chat connection failed');\n\n/** Open an authenticated live feed. Use generated REST methods to send and read history. */\nexport function connectTutoringChat(options: ChatConnectionOptions): ChatConnection {\n  if (!positiveId(options.requestId)) throw new TypeError('requestId must be a positive safe integer');\n  const makeSocket = options.webSocketFactory ?? (url => new WebSocket(url));\n  const timeoutMs = options.connectTimeoutMs ?? 15_000;\n  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) throw new TypeError('connectTimeoutMs must be positive');\n  let stopped = false;\n  let attempt = 0;\n  let retryTimer: ReturnType<typeof setTimeout> | undefined;\n  let disposeAttempt: (() => void) | undefined;\n\n  async function connect(): Promise<void> {\n    if (stopped) return;\n    const abort = new AbortController();\n    let socket: WebSocket | undefined;\n    let ready = false;\n    const buffered: MessageRead[] = [];\n    const timer = setTimeout(() => fail(new Error('Chat connection timed out')), timeoutMs);\n    const active = () => !stopped && !abort.signal.aborted;\n\n    function dispose() {\n      clearTimeout(timer);\n      abort.abort();\n      if (socket) {\n        socket.removeEventListener('open', opened);\n        socket.removeEventListener('message', received);\n        socket.removeEventListener('close', closed);\n        socket.removeEventListener('error', errored);\n        if (socket.readyState < 2) socket.close();\n      }\n      buffered.length = 0;\n    }\n\n    function fail(error: Error, permanent = false) {\n      if (!active()) return;\n      dispose();\n      options.onError?.(error);\n      if (permanent) {\n        stopped = true;\n        options.onStatusChange?.('error');\n        return;\n      }\n      options.onStatusChange?.('reconnecting');\n      const delay = options.retryDelay?.(attempt) ?? Math.min(30_000, 1_000 * 2 ** Math.min(attempt, 5)) * (0.5 + Math.random() * 0.5);\n      attempt++;\n      retryTimer = setTimeout(() => { void connect(); }, Math.max(0, delay));\n    }\n\n    function opened() {\n      clearTimeout(timer);\n      options.onStatusChange?.('syncing');\n      void (async () => {\n        try {\n          await options.onConnect?.(abort.signal);\n          if (!active()) return;\n          for (const message of buffered) options.onMessage(message);\n          buffered.length = 0;\n          ready = true;\n          attempt = 0;\n          options.onStatusChange?.('connected');\n        } catch (error) { fail(asError(error), terminal(error)); }\n      })();\n    }\n\n    function received(event: MessageEvent) {\n      if (!active()) return;\n      try {\n        if (typeof event.data !== 'string') throw new Error('Expected a text chat frame');\n        const message = parseMessage(JSON.parse(event.data), options.requestId);\n        if (ready) options.onMessage(message);\n        else {\n          if (buffered.length >= 1_000) throw new Error('Chat recovery buffer exceeded');\n          buffered.push(message);\n        }\n      } catch (error) { fail(asError(error)); }\n    }\n\n    function closed(event: CloseEvent) {\n      fail(new Error(`Chat connection closed (${event.code})`), event.code === 1008);\n    }\n    function errored() { fail(new Error('Chat connection failed')); }\n\n    disposeAttempt = dispose;\n    options.onStatusChange?.(attempt === 0 ? 'connecting' : 'reconnecting');\n    try {\n      const { ticket } = await mintChatTicket(options.requestId, { client: options.client, signal: abort.signal });\n      if (!active()) return;\n      const url = new URL(`/tutoring/requests/${options.requestId}/chat`, options.client.baseUrl);\n      url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';\n      url.searchParams.set('ticket', ticket);\n      socket = makeSocket(url.href);\n      socket.addEventListener('open', opened);\n      socket.addEventListener('message', received);\n      socket.addEventListener('close', closed);\n      socket.addEventListener('error', errored);\n    } catch (error) { fail(asError(error), terminal(error)); }\n  }\n\n  void connect();\n  return {\n    close() {\n      if (stopped) return;\n      stopped = true;\n      clearTimeout(retryTimer);\n      disposeAttempt?.();\n      options.onStatusChange?.('closed');\n    },\n  };\n}\n"],"mappings":"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"}