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.
TypeScript ai-agentai-resume-analyzerapplication-trackerapplication-tracking-systematscareerjob-applicationjob-automationjob-huntingjob-searchjob-seeker-toolsjob-trackerjob-trackingjobsearchjobseekersmcpollamaresumeresume-reviewself-hosted
feat(cover-letter): add client stream util
Khuram Niaz4e109b148e62
diff --git a/__tests__/streamCoverLetter.utils.spec.ts b/__tests__/streamCoverLetter.utils.spec.tsnew file mode 100644index 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.tsnew file mode 100644index 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;+}