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 generation sheet

Khuram Niaz445a8d7904b8
diff --git a/__tests__/GenerateCoverLetterSection.spec.tsx b/__tests__/GenerateCoverLetterSection.spec.tsx
new file mode 100644
index 0000000..ac6cdaa
--- /dev/null
+++ b/__tests__/GenerateCoverLetterSection.spec.tsx
@@ -0,0 +1,184 @@
+import React from "react";
+import { render, screen, waitFor } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { GenerateCoverLetterSection } from "@/components/myjobs/GenerateCoverLetterSection";
+import { streamCoverLetter } from "@/utils/streamCoverLetter.utils";
+import { generateCoverLetterForJob } from "@/actions/coverLetter.actions";
+import { getDefaultResumeId, getResumeList } from "@/actions/profile.actions";
+
+vi.mock("@/utils/streamCoverLetter.utils", () => ({
+ streamCoverLetter: vi.fn(),
+}));
+vi.mock("@/actions/coverLetter.actions", () => ({
+ generateCoverLetterForJob: vi.fn(),
+}));
+vi.mock("@/lib/toast", () => ({
+ toastSuccess: vi.fn(),
+ toastError: vi.fn(),
+}));
+vi.mock("@/actions/userSettings.actions", () => ({
+ getUserSettings: vi
+ .fn()
+ .mockResolvedValue({ success: true, data: { settings: { ai: {} } } }),
+}));
+vi.mock("@/utils/ai.utils", () => ({
+ checkOllamaConnection: vi.fn().mockResolvedValue({ isConnected: true }),
+}));
+vi.mock("@/actions/profile.actions", () => ({
+ getDefaultResumeId: vi.fn(),
+ getResumeList: vi.fn(),
+}));
+
+// Radix portals don't render into the testing container; render inline.
+vi.mock("@/components/ui/sheet", () => ({
+ Sheet: ({ children, open }: any) => (open ? <div>{children}</div> : null),
+ SheetPortal: ({ children }: any) => <div>{children}</div>,
+ SheetContent: ({ children }: any) => <div>{children}</div>,
+ SheetTitle: ({ children }: any) => <div>{children}</div>,
+ SheetClose: ({ children }: any) => <div>{children}</div>,
+}));
+
+// Radix Select needs pointer APIs jsdom lacks — swap items for buttons.
+const SelectCtx = React.createContext<((value: string) => void) | undefined>(
+ undefined,
+);
+vi.mock("@/components/ui/select", () => ({
+ Select: ({ children, onValueChange }: any) => (
+ <SelectCtx.Provider value={onValueChange}>
+ <div>{children}</div>
+ </SelectCtx.Provider>
+ ),
+ SelectContent: ({ children }: any) => <div>{children}</div>,
+ SelectGroup: ({ children }: any) => <div>{children}</div>,
+ SelectItem: ({ children, value }: any) => {
+ const onValueChange = React.useContext(SelectCtx);
+ return <button onClick={() => onValueChange?.(value)}>{children}</button>;
+ },
+ SelectTrigger: ({ children }: any) => <div>{children}</div>,
+ SelectValue: () => null,
+}));
+
+vi.mock("@/components/TipTapContentViewer", () => ({
+ TipTapContentViewer: ({ content }: { content: string }) => (
+ <div dangerouslySetInnerHTML={{ __html: content }} />
+ ),
+}));
+
+vi.mock("@/components/Loading", () => ({
+ __esModule: true,
+ default: () => <div data-testid="loading" />,
+}));
+
+const letter = "Dear Hiring Manager,\n\nI build platforms.\n\nSincerely,";
+
+const renderSheet = (props: Partial<any> = {}) =>
+ render(
+ <GenerateCoverLetterSection
+ open
+ triggerChange={vi.fn()}
+ jobId="job-1"
+ jobResumeId="resume-1"
+ onSaved={vi.fn()}
+ {...props}
+ />,
+ );
+
+describe("GenerateCoverLetterSection", () => {
+ beforeEach(() => {
+ vi.clearAllMocks();
+ (streamCoverLetter as any).mockResolvedValue(letter);
+ (generateCoverLetterForJob as any).mockResolvedValue({
+ success: true,
+ data: { id: "cl-1", title: "Senior Engineer - Acme" },
+ });
+ (getDefaultResumeId as any).mockResolvedValue(null);
+ (getResumeList as any).mockResolvedValue({
+ success: true,
+ data: [{ id: "resume-1", title: "Backend Resume" }],
+ });
+ });
+
+ it("generates with the job's linked resume when there is one", async () => {
+ renderSheet();
+ await waitFor(() =>
+ expect(streamCoverLetter).toHaveBeenCalledWith(
+ expect.objectContaining({ jobId: "job-1", resumeId: "resume-1" }),
+ ),
+ );
+ });
+
+ it("falls back to the default resume when the job has none", async () => {
+ (getDefaultResumeId as any).mockResolvedValue("resume-1");
+ renderSheet({ jobResumeId: null });
+ await waitFor(() =>
+ expect(streamCoverLetter).toHaveBeenCalledWith(
+ expect.objectContaining({ resumeId: "resume-1" }),
+ ),
+ );
+ });
+
+ it("ignores a default resume that is not in the eligible list", async () => {
+ (getDefaultResumeId as any).mockResolvedValue("resume-thin");
+ renderSheet({ jobResumeId: null });
+ await waitFor(() => expect(getResumeList).toHaveBeenCalled());
+ expect(streamCoverLetter).not.toHaveBeenCalled();
+ });
+
+ it("shows a picker and generates on selection when nothing resolves", async () => {
+ renderSheet({ jobResumeId: null });
+ await userEvent.click(await screen.findByText("Backend Resume"));
+ await waitFor(() =>
+ expect(streamCoverLetter).toHaveBeenCalledWith(
+ expect.objectContaining({ resumeId: "resume-1" }),
+ ),
+ );
+ });
+
+ it("prompts to create a resume when there are none eligible", async () => {
+ (getResumeList as any).mockResolvedValue({ success: true, data: [] });
+ renderSheet({ jobResumeId: null });
+ expect(await screen.findByText(/create a resume/i)).toBeInTheDocument();
+ expect(streamCoverLetter).not.toHaveBeenCalled();
+ });
+
+ it("renders the streamed letter", async () => {
+ renderSheet();
+ expect(await screen.findByText(/I build platforms/)).toBeInTheDocument();
+ });
+
+ it("saves the letter after a successful stream", async () => {
+ const onSaved = vi.fn();
+ renderSheet({ onSaved });
+ await waitFor(() =>
+ expect(generateCoverLetterForJob).toHaveBeenCalledWith("job-1", letter),
+ );
+ await waitFor(() =>
+ expect(onSaved).toHaveBeenCalledWith("cl-1", "Senior Engineer - Acme"),
+ );
+ });
+
+ it("shows the saved title with a link to the profile", async () => {
+ renderSheet();
+ expect(
+ await screen.findByText(/Senior Engineer - Acme/),
+ ).toBeInTheDocument();
+ await waitFor(() =>
+ expect(screen.getByRole("link")).toHaveAttribute(
+ "href",
+ "/dashboard/profile",
+ ),
+ );
+ });
+
+ it("does not save when the stream fails", async () => {
+ (streamCoverLetter as any).mockRejectedValue(new Error("boom"));
+ renderSheet();
+ await waitFor(() => expect(streamCoverLetter).toHaveBeenCalled());
+ expect(generateCoverLetterForJob).not.toHaveBeenCalled();
+ });
+
+ it("does not generate while closed", () => {
+ renderSheet({ open: false });
+ expect(streamCoverLetter).not.toHaveBeenCalled();
+ });
+});
diff --git a/src/components/myjobs/GenerateCoverLetterSection.tsx b/src/components/myjobs/GenerateCoverLetterSection.tsx
new file mode 100644
index 0000000..4d4e239
--- /dev/null
+++ b/src/components/myjobs/GenerateCoverLetterSection.tsx
@@ -0,0 +1,347 @@
+"use client";
+
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import Link from "next/link";
+import MarkdownIt from "markdown-it";
+import { CheckCircle, XCircle, Loader2, Sparkles, X } from "lucide-react";
+import {
+ Sheet,
+ SheetClose,
+ SheetContent,
+ SheetPortal,
+ SheetTitle,
+} from "../ui/sheet";
+import { Button } from "../ui/button";
+import Loading from "../Loading";
+import { TipTapContentViewer } from "../TipTapContentViewer";
+import { SlowResponseWarning } from "../common/SlowResponseWarning";
+import { toastSuccess, toastError } from "@/lib/toast";
+import { APP_CONSTANTS } from "@/lib/constants";
+import { AiModel, defaultModel } from "@/models/ai.model";
+import { useSheetAutoScroll } from "@/hooks/useSheetAutoScroll";
+import { useResizablePanel } from "@/hooks/useResizablePanel";
+import { useSlowResponseWarning } from "@/hooks/useSlowResponseWarning";
+import { checkOllamaConnection } from "@/utils/ai.utils";
+import { getUserSettings } from "@/actions/userSettings.actions";
+import { getDefaultResumeId, getResumeList } from "@/actions/profile.actions";
+import { Resume } from "@/models/profile.model";
+import {
+ Select,
+ SelectContent,
+ SelectGroup,
+ SelectItem,
+ SelectTrigger,
+ SelectValue,
+} from "../ui/select";
+import { streamCoverLetter } from "@/utils/streamCoverLetter.utils";
+import { generateCoverLetterForJob } from "@/actions/coverLetter.actions";
+
+// html:false escapes raw HTML from the model; TipTapContentViewer strips
+// anything left over.
+const md = new MarkdownIt({ html: false, linkify: false, breaks: true });
+
+interface GenerateCoverLetterSectionProps {
+ open: boolean;
+ triggerChange: (openState: boolean) => void;
+ jobId: string;
+ jobResumeId?: string | null;
+ onSaved?: (coverLetterId: string, title: string) => void;
+}
+
+export const GenerateCoverLetterSection = ({
+ open,
+ triggerChange,
+ jobId,
+ jobResumeId,
+ onSaved,
+}: GenerateCoverLetterSectionProps) => {
+ const [selectedModel, setSelectedModel] = useState<AiModel>(defaultModel);
+ const [ollamaConnected, setOllamaConnected] = useState<boolean | null>(null);
+ const [connectionError, setConnectionError] = useState("");
+ const [resumes, setResumes] = useState<Resume[] | null>(null);
+ const [needsPicker, setNeedsPicker] = useState(false);
+ const [letter, setLetter] = useState("");
+ const [savedTitle, setSavedTitle] = useState<string | null>(null);
+ const [isLoading, setIsLoading] = useState(false);
+ const abortRef = useRef<AbortController | null>(null);
+ const startedRef = useRef(false);
+ const { scrollAnchorRef, handleSheetScroll, resetScroll } =
+ useSheetAutoScroll(isLoading, letter);
+ const { width, handleMouseDown } = useResizablePanel("ai-panel-width");
+
+ useEffect(() => {
+ const fetchSettings = async () => {
+ try {
+ const result = await getUserSettings();
+ if (result.success && result.data?.settings?.ai) {
+ const aiSettings = result.data.settings.ai;
+ setSelectedModel({
+ provider: aiSettings.provider || defaultModel.provider,
+ model: aiSettings.model,
+ });
+ }
+ } catch (error) {
+ console.error("Error fetching AI settings:", error);
+ }
+ };
+ fetchSettings();
+ }, []);
+
+ const generate = useCallback(
+ async (resumeId: string) => {
+ const controller = new AbortController();
+ abortRef.current = controller;
+ resetScroll();
+ setNeedsPicker(false);
+ setLetter("");
+ setSavedTitle(null);
+ setIsLoading(true);
+
+ try {
+ const markdown = await streamCoverLetter({
+ jobId,
+ resumeId,
+ selectedModel,
+ signal: controller.signal,
+ onUpdate: setLetter,
+ });
+ // The stream salvages partial text on abort, so don't save a letter
+ // the user cancelled by closing the sheet.
+ if (controller.signal.aborted) return;
+ setLetter(markdown);
+
+ const res = await generateCoverLetterForJob(jobId, markdown);
+ if (res?.success) {
+ setSavedTitle(res.data.title);
+ onSaved?.(res.data.id, res.data.title);
+ toastSuccess(`Saved as “${res.data.title}”`);
+ } else {
+ toastError(res?.message || "Failed to save cover letter");
+ }
+ } catch (err) {
+ if (controller.signal.aborted) return;
+ toastError(
+ err instanceof Error ? err.message : "Failed to generate cover letter",
+ );
+ } finally {
+ if (abortRef.current === controller) abortRef.current = null;
+ setIsLoading(false);
+ }
+ },
+ [jobId, selectedModel, onSaved, resetScroll],
+ );
+
+ const stop = useCallback(() => {
+ abortRef.current?.abort();
+ abortRef.current = null;
+ setIsLoading(false);
+ }, []);
+
+ const checkConnectionStatus = useCallback(async () => {
+ setOllamaConnected(null);
+ setConnectionError("");
+ const result = await checkOllamaConnection(selectedModel.provider);
+ setOllamaConnected(result.isConnected);
+ if (!result.isConnected) {
+ setConnectionError(result.error || "Ollama is not reachable.");
+ }
+ }, [selectedModel.provider]);
+
+ // Resolve a resume, then generate — once per open. startedRef stops the
+ // settings effect from re-triggering generation mid-stream.
+ useEffect(() => {
+ if (!open) {
+ startedRef.current = false;
+ return;
+ }
+ if (startedRef.current) return;
+ startedRef.current = true;
+
+ if (selectedModel.provider === "ollama") {
+ checkConnectionStatus();
+ }
+
+ const resolveAndGenerate = async () => {
+ const [defaultResumeId, list] = await Promise.all([
+ getDefaultResumeId(),
+ getResumeList(
+ 1,
+ APP_CONSTANTS.RECORDS_PER_PAGE,
+ APP_CONSTANTS.MIN_RESUME_SECTIONS_FOR_SELECTION,
+ ),
+ ]);
+
+ const eligible: Resume[] = list?.data ?? [];
+ setResumes(eligible);
+
+ // A default resume too thin for MIN_RESUME_SECTIONS_FOR_SELECTION would
+ // fail in preprocessResume, so only accept one that survived the filter.
+ const fallback = eligible.some((r) => r.id === defaultResumeId)
+ ? defaultResumeId
+ : null;
+ const resolved = jobResumeId ?? fallback;
+
+ if (resolved) {
+ generate(resolved);
+ } else {
+ setNeedsPicker(eligible.length > 0);
+ }
+ };
+
+ resolveAndGenerate();
+ }, [
+ open,
+ jobResumeId,
+ generate,
+ checkConnectionStatus,
+ selectedModel.provider,
+ ]);
+
+ const onOpenChange = (openState: boolean) => {
+ triggerChange(openState);
+ if (!openState) {
+ if (isLoading) stop();
+ setLetter("");
+ setSavedTitle(null);
+ setNeedsPicker(false);
+ setResumes(null);
+ setOllamaConnected(null);
+ setConnectionError("");
+ }
+ };
+
+ const html = useMemo(() => (letter ? md.render(letter) : ""), [letter]);
+ const showSlowWarning = useSlowResponseWarning(isLoading, !!letter);
+
+ const statusIcon =
+ selectedModel.provider === "ollama" ? (
+ ollamaConnected === null ? (
+ <Loader2 className="h-3.5 w-3.5 shrink-0 animate-spin text-muted-foreground" />
+ ) : ollamaConnected ? (
+ <CheckCircle className="h-3.5 w-3.5 shrink-0 text-green-500" />
+ ) : (
+ <XCircle className="h-3.5 w-3.5 shrink-0 text-destructive" />
+ )
+ ) : (
+ <Sparkles className="h-3.5 w-3.5 shrink-0 text-muted-foreground" />
+ );
+
+ const providerLabel =
+ selectedModel.provider.charAt(0).toUpperCase() +
+ selectedModel.provider.slice(1);
+
+ return (
+ <Sheet open={open} onOpenChange={onOpenChange}>
+ <SheetPortal>
+ <SheetContent
+ className="flex flex-col p-0 overflow-hidden [&>button:last-child]:hidden"
+ style={{
+ width: `${width}px`,
+ maxWidth: `${APP_CONSTANTS.RESIZABLE_PANEL_MAX_WIDTH_RATIO * 100}vw`,
+ }}
+ >
+ <div
+ className="absolute left-0 top-0 h-full w-1 cursor-col-resize z-10 group"
+ onMouseDown={handleMouseDown}
+ >
+ <div className="h-full w-px bg-transparent group-hover:bg-primary/50 transition-colors" />
+ </div>
+ <div className="flex items-center gap-3 px-4 py-2.5 border-b bg-muted/20 shrink-0">
+ <SheetTitle className="text-[11px] font-bold tracking-[0.15em] uppercase text-foreground leading-none shrink-0 m-0">
+ AI COVER LETTER
+ </SheetTitle>
+ <span className="text-muted-foreground/30 text-xs select-none">
+ ···
+ </span>
+ <div className="flex items-center gap-1.5 min-w-0">
+ {statusIcon}
+ <span className="text-xs text-muted-foreground font-mono truncate">
+ {selectedModel.model
+ ? `${providerLabel} / ${selectedModel.model}`
+ : providerLabel}
+ </span>
+ </div>
+ <SheetClose asChild>
+ <Button
+ variant="ghost"
+ size="icon"
+ className="h-6 w-6 ml-auto shrink-0 rounded-sm opacity-70 hover:opacity-100"
+ >
+ <X className="h-3.5 w-3.5" />
+ </Button>
+ </SheetClose>
+ </div>
+
+ <div
+ className="flex-1 overflow-y-auto px-6 pt-4 pb-6"
+ onScroll={handleSheetScroll}
+ >
+ {selectedModel.provider === "ollama" &&
+ ollamaConnected === false &&
+ connectionError && (
+ <p className="text-xs text-red-600">{connectionError}</p>
+ )}
+
+ {needsPicker && (
+ <div className="flex flex-col items-center gap-2 pt-12">
+ <p className="text-sm text-muted-foreground">
+ Which resume should this letter draw on?
+ </p>
+ <Select onValueChange={generate}>
+ <SelectTrigger className="w-[180px]">
+ <SelectValue placeholder="Select a resume" />
+ </SelectTrigger>
+ <SelectContent>
+ <SelectGroup>
+ {(resumes ?? []).map((resume) => (
+ <SelectItem
+ key={resume.id}
+ value={resume.id!}
+ className="capitalize"
+ >
+ {resume.title}
+ </SelectItem>
+ ))}
+ </SelectGroup>
+ </SelectContent>
+ </Select>
+ </div>
+ )}
+
+ {resumes?.length === 0 && (
+ <p className="pt-12 text-center text-sm text-muted-foreground">
+ Create a resume with at least{" "}
+ {APP_CONSTANTS.MIN_RESUME_SECTIONS_FOR_SELECTION} sections to
+ generate a cover letter.
+ </p>
+ )}
+
+ {isLoading && !letter ? (
+ <div className="flex items-center flex-col mt-4">
+ <Loading />
+ <div className="mt-2">Writing your cover letter...</div>
+ {showSlowWarning && <SlowResponseWarning />}
+ </div>
+ ) : (
+ html && (
+ <div className="text-sm leading-relaxed [&_p]:mt-3">
+ <TipTapContentViewer content={html} />
+ </div>
+ )
+ )}
+
+ {savedTitle && (
+ <p className="mt-6 text-xs text-muted-foreground">
+ Saved as “{savedTitle}” —{" "}
+ <Link href="/dashboard/profile" className="underline">
+ edit it in Profile → Documents
+ </Link>
+ </p>
+ )}
+ <div ref={scrollAnchorRef} />
+ </div>
+ </SheetContent>
+ </SheetPortal>
+ </Sheet>
+ );
+};