Skip to content

Job application tracker and AI-powered job search assistant. Helps job seekers manage their search journey with AI resume review, job matching, task logging, and application analytics, all while keeping your data private.

feat(cover-letter): add client stream util

Khuram Niaz4e109b148e62
diff --git a/__tests__/streamCoverLetter.utils.spec.ts b/__tests__/streamCoverLetter.utils.spec.ts
new file mode 100644
index 0000000..c878fbe
--- /dev/null
+++ b/__tests__/streamCoverLetter.utils.spec.ts
@@ -0,0 +1,104 @@
+import { streamCoverLetter } from "@/utils/streamCoverLetter.utils";
+import { defaultModel } from "@/models/ai.model";
+
+const encoder = new TextEncoder();
+
+const streamOf = (chunks: string[]) => ({
+ getReader: () => {
+ let i = 0;
+ return {
+ read: async () =>
+ i < chunks.length
+ ? { done: false, value: encoder.encode(chunks[i++]) }
+ : { done: true, value: undefined },
+ };
+ },
+});
+
+describe("streamCoverLetter", () => {
+ beforeEach(() => {
+ vi.restoreAllMocks();
+ });
+
+ it("accumulates chunks and returns the full letter", async () => {
+ global.fetch = vi.fn().mockResolvedValue({
+ ok: true,
+ body: streamOf(["Dear Hiring ", "Manager,\n\nI build."]),
+ }) as any;
+
+ const updates: string[] = [];
+ const result = await streamCoverLetter({
+ jobId: "job-1",
+ selectedModel: defaultModel,
+ onUpdate: (text) => updates.push(text),
+ });
+
+ expect(result).toBe("Dear Hiring Manager,\n\nI build.");
+ expect(updates.length).toBeGreaterThan(1);
+ });
+
+ it("strips <think> blocks", async () => {
+ global.fetch = vi.fn().mockResolvedValue({
+ ok: true,
+ body: streamOf(["<think>plan</think>Dear Hiring Manager,"]),
+ }) as any;
+
+ const result = await streamCoverLetter({
+ jobId: "job-1",
+ selectedModel: defaultModel,
+ });
+
+ expect(result).not.toContain("plan");
+ expect(result).toContain("Dear Hiring Manager,");
+ });
+
+ it("throws the server error message on a non-OK response", async () => {
+ global.fetch = vi.fn().mockResolvedValue({
+ ok: false,
+ body: null,
+ json: async () => ({ error: "Rate limit exceeded." }),
+ }) as any;
+
+ await expect(
+ streamCoverLetter({ jobId: "job-1", selectedModel: defaultModel }),
+ ).rejects.toThrow("Rate limit exceeded.");
+ });
+
+ it("throws when the stream produces nothing", async () => {
+ global.fetch = vi
+ .fn()
+ .mockResolvedValue({ ok: true, body: streamOf([]) }) as any;
+
+ await expect(
+ streamCoverLetter({ jobId: "job-1", selectedModel: defaultModel }),
+ ).rejects.toThrow();
+ });
+
+ it("posts only ids, never content", async () => {
+ const fetchMock = vi
+ .fn()
+ .mockResolvedValue({ ok: true, body: streamOf(["Dear Hiring Manager,"]) });
+ global.fetch = fetchMock as any;
+
+ await streamCoverLetter({ jobId: "job-1", selectedModel: defaultModel });
+
+ const body = JSON.parse(fetchMock.mock.calls[0][1].body);
+ expect(Object.keys(body).sort()).toEqual(["jobId", "selectedModel"]);
+ });
+
+ it("forwards an explicit resumeId", async () => {
+ const fetchMock = vi
+ .fn()
+ .mockResolvedValue({ ok: true, body: streamOf(["Dear Hiring Manager,"]) });
+ global.fetch = fetchMock as any;
+
+ await streamCoverLetter({
+ jobId: "job-1",
+ resumeId: "resume-9",
+ selectedModel: defaultModel,
+ });
+
+ const body = JSON.parse(fetchMock.mock.calls[0][1].body);
+ expect(body.resumeId).toBe("resume-9");
+ });
+});
diff --git a/src/utils/streamCoverLetter.utils.ts b/src/utils/streamCoverLetter.utils.ts
new file mode 100644
index 0000000..2e101c6
--- /dev/null
+++ b/src/utils/streamCoverLetter.utils.ts
@@ -0,0 +1,70 @@
+import { AiModel } from "@/models/ai.model";
+import { stripThinking } from "@/lib/ai/stripThinking";
+
+type StreamCoverLetterArgs = {
+ jobId: string;
+ // Omitted when the caller wants the server-side resolution chain.
+ resumeId?: string;
+ selectedModel: AiModel;
+ // Called on each chunk with the cleaned text so far, for progressive render.
+ onUpdate?: (markdown: string) => void;
+ signal?: AbortSignal;
+};
+
+// Consumes the plain-text stream from /api/ai/cover-letter. Unlike job match
+// there is nothing to parse — the whole response is the letter.
+export async function streamCoverLetter({
+ jobId,
+ resumeId,
+ selectedModel,
+ onUpdate,
+ signal,
+}: StreamCoverLetterArgs): Promise<string> {
+ const res = await fetch("/api/ai/cover-letter", {
+ method: "POST",
+ headers: { "Content-Type": "application/json" },
+ body: JSON.stringify({
+ jobId,
+ selectedModel,
+ ...(resumeId && { resumeId }),
+ }),
+ signal,
+ });
+
+ // Pre-generation failures (auth, rate limit, preprocessing) return JSON.
+ if (!res.ok || !res.body) {
+ let message = "Failed to generate cover letter.";
+ try {
+ const err = await res.json();
+ if (err?.error) message = err.error;
+ } catch {
+ // Non-JSON error body — keep the default message.
+ }
+ throw new Error(message);
+ }
+
+ const reader = res.body.getReader();
+ const decoder = new TextDecoder();
+ let raw = "";
+
+ try {
+ while (true) {
+ const { done, value } = await reader.read();
+ if (done) break;
+ raw += decoder.decode(value, { stream: true });
+ onUpdate?.(stripThinking(raw).trim());
+ }
+ } catch (err) {
+ // Abnormal end (abort / incomplete chunked encoding): keep what we have.
+ if (!raw) throw err;
+ }
+
+ const final = stripThinking(raw).trim();
+ if (!final) {
+ throw new Error(
+ "The AI service returned no data. Please ensure it is running and try again.",
+ );
+ }
+ onUpdate?.(final);
+ return final;
+}