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.

5.4 KB
Raw Blame
import type { JobBoard, LeverHost } from "@/models/automation.model";
import { CoverLetter, Resume } from "./profile.model";
import type { JobContactLink } from "./contact.model";
// Type-only: jobStage.model.ts imports Tag from here and has a runtime export,
// so a value import back would make a real module cycle.
import type { JobStage } from "./jobStage.model";
import type { SortDir } from "./sort.model";

export interface JobForm {
  id?: string;
  userId?: string;
  source: string;
  title: string;
  type: string;
  company: string;
  location: string;
  status: string;
  dueDate: Date;
  dateApplied?: Date;
  salaryRange?: string;
  jobDescription: string;
  jobUrl?: string;
  applied: boolean;
  workplaceType?: string | null;
}

export interface Tag {
  id: string;
  label: string;
  value: string;
  createdBy: string;
  _count?: {
    jobs: number;
    questions: number;
    skills: number;
  };
}

export interface JobResponse {
  id: string;
  userId: string;
  JobTitle: JobTitle;
  Company: Company;
  Status: JobStatus;
  Location: JobLocation | null;
  JobSource: JobSource | null;
  jobType: string;
  workplaceType?: string | null;
  createdAt: Date;
  appliedDate: Date;
  dueDate: Date;
  salaryRange: string | null;
  description: string;
  jobUrl: string;
  applied: boolean;
  resumeId?: string;
  Resume?: Resume;
  coverLetterId?: string;
  CoverLetter?: CoverLetter;
  matchScore?: number | null;
  matchData?: string | null;
  tags?: Tag[];
  contactLinks?: JobContactLink[];
  stages?: JobStage[];
  createdVia?: string | null;
  discoveryStatus?: string | null;
  descriptionCompleteness?: DescriptionCompleteness | null;
  _count?: { Notes?: number };
}

export type JobsViewMode = "table" | "cards";

// First-click direction per sortable column. The keys are also the server's
// sort whitelist in getJobsList.
export const JOB_SORT_FIELDS = {
  appliedDate: "desc",
  title: "asc",
  company: "asc",
  location: "asc",
  matchScore: "desc",
  source: "asc",
} as const satisfies Record<string, SortDir>;

export type JobSortField = keyof typeof JOB_SORT_FIELDS;

export interface JobTitle {
  id: string;
  label: string;
  value: string;
  createdBy: string;
  _count?: {
    jobs: number;
    jobsTotal?: number;
  };
}

export interface Company {
  id: string;
  label: string;
  value: string;
  createdBy: string;
  logoUrl?: string;
  watched?: boolean;
  watchedAt?: Date | null;
  atsProvider?: JobBoard | null;
  atsToken?: string | null;
  atsHost?: LeverHost | null;
  websiteUrl?: string | null;
  careersUrl?: string | null;
  industry?: string | null;
  linkedinUrl?: string | null;
  size?: string | null;
  notes?: string | null;
  _count?: {
    jobsApplied: number;
    jobsRejected?: number;
    jobsTotal?: number;
    contacts?: number;
  };
}

export interface JobStatus {
  id: string;
  label: string;
  value: string;
}

export interface JobSource {
  id: string;
  label: string;
  value: string;
  createdBy: string;
  _count?: {
    jobsApplied: number;
    jobsTotal?: number;
  };
}

export interface JobLocation {
  id: string;
  label: string;
  value: string;
  stateProv?: string;
  country?: string;
  createdBy: string;
  _count?: {
    jobsApplied: number;
    jobsTotal?: number;
  };
}

export interface Country {
  id: string;
  label: string;
  value: string;
}

export enum JOB_TYPES {
  FT = "Full-time",
  PT = "Part-time",
  C = "Contract",
}

export enum WORKPLACE_TYPES {
  REMOTE = "Remote",
  HYBRID = "Hybrid",
  ONSITE = "Onsite",
}

// Jobs-page popover filters. Values are stored codes (FT, REMOTE) and status
// values; OR within a field, AND across fields.
export type JobFacets = {
  statuses: string[];
  acceptedDiscovered: boolean;
  jobTypes: string[];
  workplaces: string[];
  includeDismissed: boolean;
};

// Deep-link filters from the Library tables, kept separate from the popover.
export type JobListScope = {
  companyValue?: string;
  appliedOnly?: boolean;
  titleValue?: string;
  locationValue?: string;
  sourceValue?: string;
};

export type JobFilterCounts = {
  total: number;
  // Keyed by JobStatus.id.
  statusCounts: Record<string, number>;
  acceptedDiscovered: number;
};

// Matches free-text input against a fixed enum, ignoring case and separators,
// and returns its [key, label] pair. These are closed sets, so — unlike
// canonicalizeEntityValue, which keeps punctuation on purpose so "C++" and
// "C#" cannot collapse — folding separators here is safe. Postings write
// "On-site" far more often than "Onsite", and rejecting the variant used to
// fail the whole save. Lives here rather than in resolve.ts because
// mcp.schema.ts needs it too and cannot import Prisma.
export function matchEnumEntry(
  members: Record<string, string>,
  input: string,
): [string, string] | undefined {
  const fold = (value: string) => value.toLowerCase().replace(/[^a-z0-9]/g, "");
  const folded = fold(input);
  return (Object.entries(members) as [string, string][]).find(
    ([key, label]) => fold(key) === folded || fold(label) === folded,
  );
}

export function getWorkplaceTypeLabel(
  code?: string | null,
  fallback: string = "Not specified",
): string {
  if (!code) return fallback;
  return (WORKPLACE_TYPES as Record<string, string>)[code] ?? fallback;
}

export function getJobTypeLabel(
  code?: string | null,
  fallback: string = "Not specified",
): string {
  if (!code) return fallback;
  return (JOB_TYPES as Record<string, string>)[code] ?? fallback;
}

export type DescriptionCompleteness = "title-only" | "partial" | "full";