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
/**
* Job Description Preprocessing Module
* Mirrors the resume preprocessing pattern for consistency
* Normalizes, validates, and extracts metadata from job descriptions
*/
import { JobResponse, WORKPLACE_TYPES } from "@/models/job.model";
import {
removeHtmlTags,
normalizeWhitespace,
normalizeBullets,
normalizeHeadings,
extractMetadata,
validateText,
type TextMetadata,
} from "./text-processing";
// TYPES
export type JobMetadata = TextMetadata;
export interface PreprocessedJob {
normalizedText: string;
metadata: JobMetadata;
isValid: boolean;
}
export type JobPreprocessingResult =
| { success: true; data: PreprocessedJob }
| {
success: false;
error: { code: string; message: string; details?: object };
};
// VALIDATION THRESHOLDS
const MIN_CHAR_COUNT = 200;
const MAX_CHAR_COUNT = 50000;
// JOB DESCRIPTION TO TEXT CONVERSION
export const convertJobToText = (job: JobResponse): Promise<string> => {
return new Promise((resolve) => {
const {
description,
JobTitle: { label: jobTitle },
Company: { label: companyName },
Location,
workplaceType,
} = job;
const workplaceTypeLine =
workplaceType && workplaceType in WORKPLACE_TYPES
? `Workplace Type: ${WORKPLACE_TYPES[workplaceType as keyof typeof WORKPLACE_TYPES]}\n`
: "";
const locationLine = Location ? `Location: ${Location.label}\n` : "";
const jobText = `
Job Title: ${jobTitle}
Company: ${companyName}
${locationLine}${workplaceTypeLine}Description: ${removeHtmlTags(description)}
`;
return resolve(jobText);
});
};
// VALIDATION - Job-specific validation logic
export const validateJob = (
text: string,
metadata: JobMetadata,
): {
isValid: boolean;
error?: { code: string; message: string; details?: object };
} => {
// Use shared generic validation
const genericValidation = validateText(
text,
MIN_CHAR_COUNT,
MAX_CHAR_COUNT,
"Job description",
);
if (!genericValidation.isValid) {
return genericValidation;
}
// Job-specific checks can be added here if needed
// For now, the shared validation is sufficient
return { isValid: true };
};
// MAIN ORCHESTRATOR
/**
* Preprocess a job description
* Normalizes HTML, formatting, and whitespace
* Extracts metadata and validates content
*
* @param job - Job response object to preprocess
* @returns PreprocessingResult with normalized text and metadata, or error details
*/
export const preprocessJob = async (
job: JobResponse,
): Promise<JobPreprocessingResult> => {
try {
// Convert job object to raw text
const rawText = await convertJobToText(job);
// Quick validation - fail fast if obviously invalid
if (!rawText || rawText.trim().length < MIN_CHAR_COUNT) {
const charCount = rawText?.trim().length || 0;
return {
success: false,
error: {
code: charCount === 0 ? "NO_CONTENT" : "TOO_SHORT",
message:
charCount === 0
? "Job description appears to be empty"
: `Job description is too short (${charCount} characters, minimum ${MIN_CHAR_COUNT} required)`,
details: { characterCount: charCount },
},
};
}
// Apply normalization pipeline
let normalizedText = rawText;
normalizedText = normalizeWhitespace(normalizedText);
normalizedText = normalizeBullets(normalizedText);
normalizedText = normalizeHeadings(normalizedText);
// Extract metadata
const metadata = extractMetadata(normalizedText);
// Full validation
const validationResult = validateJob(normalizedText, metadata);
if (!validationResult.isValid) {
return {
success: false,
error: validationResult.error!,
};
}
return {
success: true,
data: {
normalizedText,
metadata,
isValid: true,
},
};
} catch (error) {
const message = error instanceof Error ? error.message : "Unknown error";
return {
success: false,
error: {
code: "PREPROCESSING_ERROR",
message: `Failed to preprocess job description: ${message}`,
},
};
}
};