@pranavraut033/ats-checker 1.1.1 → 1.3.0

package/dist/index.d.mts

@@ -1,262 +1,7 @@
-type ResumeSection = "summary" | "experience" | "skills" | "education" | "projects" | "certifications";
-interface ParsedDateRange {
-    raw?: string;
-    start?: string;
-    end?: string;
-    durationInMonths?: number;
-    /** Numeric year/month of the start and end, for overlap-aware summing. */
-    startYear?: number;
-    startMonth?: number;
-    endYear?: number;
-    endMonth?: number;
-}
-interface ParsedExperienceEntry {
-    title?: string;
-    company?: string;
-    location?: string;
-    dates?: ParsedDateRange;
-    description?: string;
-}
-interface ParsedResume {
-    raw: string;
-    normalizedText: string;
-    detectedSections: ResumeSection[];
-    sectionContent: Partial<Record<ResumeSection, string>>;
-    skills: string[];
-    jobTitles: string[];
-    actionVerbs: string[];
-    educationEntries: string[];
-    experience: ParsedExperienceEntry[];
-    totalExperienceYears: number;
-    keywords: string[];
-    warnings: string[];
-}
-interface ParsedJobDescription {
-    raw: string;
-    normalizedText: string;
-    requiredSkills: string[];
-    preferredSkills: string[];
-    roleKeywords: string[];
-    keywords: string[];
-    minExperienceYears?: number;
-    educationRequirements: string[];
-}
-
-interface ATSWeights {
-    skills: number;
-    experience: number;
-    keywords: number;
-    education: number;
-}
-type SkillAliases = Record<string, string[]>;
-interface ATSProfile {
-    name: string;
-    mandatorySkills: string[];
-    optionalSkills: string[];
-    minExperience?: number;
-}
-interface KeywordDensityConfig {
-    /** Minimum density before a keyword is considered underused (informational only). */
-    min: number;
-    /** Maximum density before a keyword is considered stuffed. */
-    max: number;
-    /** Penalty applied when density exceeds max. */
-    overusePenalty: number;
-}
-interface SectionPenaltyConfig {
-    missingSummary?: number;
-    missingExperience?: number;
-    missingSkills?: number;
-    missingEducation?: number;
-}
-interface ATSRule {
-    id: string;
-    description?: string;
-    penalty: number;
-    warning?: string;
-    condition: (context: RuleContext) => boolean;
-}
-interface ATSConfig {
-    weights?: Partial<ATSWeights>;
-    skillAliases?: SkillAliases;
-    profile?: ATSProfile;
-    rules?: ATSRule[];
-    keywordDensity?: KeywordDensityConfig;
-    sectionPenalties?: SectionPenaltyConfig;
-    allowPartialMatches?: boolean;
-    /**
-     * ISO date string (e.g. "2024-06-01") used as the "today" reference when
-     * computing duration for open-ended date ranges ("Present"/"Current"/"Now").
-     * Omit to use the actual current date (live/production behaviour).
-     * Set to a fixed value in tests or batch processing to guarantee determinism.
-     */
-    referenceDate?: string;
-}
-interface NormalizedWeights extends ATSWeights {
-    /** Weights normalized so they sum to 1. */
-    normalizedTotal: number;
-}
-interface ResolvedATSConfig {
-    weights: NormalizedWeights;
-    skillAliases: SkillAliases;
-    profile?: ATSProfile;
-    rules: ATSRule[];
-    keywordDensity: KeywordDensityConfig;
-    sectionPenalties: Required<SectionPenaltyConfig>;
-    allowPartialMatches: boolean;
-    /** Resolved reference date for "Present" duration calculations. */
-    referenceDate?: Date;
-}
-interface RuleContext {
-    resume: ParsedResume;
-    job: ParsedJobDescription;
-    weights: NormalizedWeights;
-    keywordDensity: KeywordDensityConfig;
-    breakdown?: ATSBreakdown;
-    matchedKeywords?: string[];
-    overusedKeywords?: string[];
-}
-
-/**
- * LLM v2 Support Types - Optional, Backward Compatible
- */
-
-/**
- * JSON Schema for response validation
- */
-interface JSONSchema {
-    type: string;
-    properties?: Record<string, unknown>;
-    required?: string[];
-    items?: unknown;
-    [key: string]: unknown;
-}
-/**
- * LLM Client abstraction - user provides their own implementation
- * This allows flexibility with different LLM providers without direct dependencies
- */
-interface LLMClient {
-    /**
-     * Create a structured completion from the LLM
-     * Must validate and return only valid JSON matching the schema
-     */
-    createCompletion(input: {
-        model: string;
-        messages: {
-            role: "system" | "user";
-            content: string;
-        }[];
-        max_tokens: number;
-        response_format: JSONSchema;
-    }): Promise<{
-        content: unknown;
-        usage?: {
-            prompt_tokens?: number;
-            completion_tokens?: number;
-            total_tokens?: number;
-        };
-    }>;
-}
-/**
- * LLM budget configuration - prevents runaway spending
- */
-interface LLMBudget {
-    maxCalls: number;
-    maxTokensPerCall: number;
-    maxTotalTokens: number;
-}
-/**
- * Feature toggles for LLM capabilities
- */
-interface LLMFeatures {
-    skillNormalization?: boolean;
-    sectionClassification?: boolean;
-    suggestions?: boolean;
-}
-/**
- * Complete LLM configuration
- */
-interface LLMConfig {
-    /** User-provided LLM client (e.g., OpenAI wrapper) */
-    client: LLMClient;
-    /** Model identifiers */
-    models?: {
-        /** Default model for fast, structured output (e.g., "gpt-4o-mini") */
-        default: string;
-        /** Optional thinking model for complex reasoning (e.g., "o4-mini") */
-        thinking?: string;
-    };
-    /** Budget constraints */
-    limits: LLMBudget;
-    /** Which LLM features to enable */
-    enable?: LLMFeatures;
-    /** Request timeout in milliseconds */
-    timeoutMs?: number;
-}
-/**
- * Updated AnalyzeResumeInput with optional LLM support
- */
-interface AnalyzeResumeInputV2 {
-    resumeText: string;
-    jobDescription: string;
-    config?: ATSConfig;
-    llm?: LLMConfig;
-}
-/**
- * LLM usage tracking for debugging
- */
-interface LLMUsageStats {
-    totalCalls: number;
-    totalTokensUsed: number;
-    callsRemaining: number;
-    tokensRemaining: number;
-    features: Partial<Record<keyof LLMFeatures, boolean>>;
-}
-/**
- * Result of an LLM operation (with fallback info)
- */
-interface LLMResult<T> {
-    success: boolean;
-    data?: T;
-    fallback: boolean;
-    error?: string;
-    tokensUsed?: number;
-}
-
-interface ATSBreakdown {
-    skills: number;
-    experience: number;
-    keywords: number;
-    education: number;
-}
-interface AnalyzeResumeInput {
-    resumeText: string;
-    jobDescription: string;
-    config?: ATSConfig;
-    llm?: LLMConfig;
-}
-interface ATSAnalysisResult {
-    score: number;
-    breakdown: ATSBreakdown;
-    /** Skills found in the resume that satisfy JD + profile requirements. */
-    matchedSkills: string[];
-    /** Required skills absent from the resume. */
-    missingSkills: string[];
-    matchedKeywords: string[];
-    missingKeywords: string[];
-    overusedKeywords: string[];
-    suggestions: string[];
-    warnings: string[];
-    /** Years below the JD's minimum experience requirement; 0 when the requirement is met. */
-    experienceGap: number;
-    /** Resume sections the parser successfully detected (e.g. "summary", "skills"). */
-    detectedSections: string[];
-    /** Total years of experience parsed from the resume's date ranges. */
-    parsedExperienceYears: number;
-    /** Parsed experience entries from the resume, with titles and date ranges. */
-    experienceEntries: ParsedExperienceEntry[];
-}
+import { A as ATSProfile, S as SkillAliases, K as KeywordRegistry, L as LLMConfig, J as JSONSchema, a as LLMResult, b as LLMBudget, c as AnalyzeResumeInput, d as ATSAnalysisResult } from './scoring-BCShrnki.mjs';
+export { s as ATSBreakdown, k as ATSConfig, j as ATSRule, e as ATSWeights, w as AnalyzeResumeInputV2, f as KeywordCategory, h as KeywordDensityConfig, g as KeywordEntry, t as KeywordWeight, u as LLMClient, v as LLMFeatures, x as LLMUsageStats, N as NormalizedWeights, o as ParsedAchievement, P as ParsedDateRange, n as ParsedExperienceEntry, r as ParsedJobDescription, p as ParsedLanguage, q as ParsedResume, R as ResolvedATSConfig, m as ResumeSection, l as RuleContext, i as SectionPenaltyConfig } from './scoring-BCShrnki.mjs';
 
+declare const defaultKeywordRegistry: KeywordRegistry;
 declare const defaultSkillAliases: SkillAliases;
 declare const defaultProfiles: ATSProfile[];
 
@@ -506,4 +251,4 @@ declare function analyzeResume(input: AnalyzeResumeInput): ATSAnalysisResult;
  */
 declare function analyzeResumeAsync(input: AnalyzeResumeInput): Promise<ATSAnalysisResult>;
 
-export { type ATSAnalysisResult, type ATSBreakdown, type ATSConfig, type ATSProfile, type ATSRule, type ATSWeights, type AnalyzeResumeInput, type AnalyzeResumeInputV2, type JSONSchema, type KeywordDensityConfig, type LLMBudget, LLMBudgetManager, type LLMClient, type LLMConfig, type LLMFeatures, LLMManager, LLMPrompts, type LLMResult, LLMSchemas, type LLMUsageStats, type NormalizedWeights, type ParsedDateRange, type ParsedExperienceEntry, type ParsedJobDescription, type ParsedResume, type ResolvedATSConfig, type ResumeSection, type RuleContext, type SectionPenaltyConfig, type SkillAliases, adaptJdClarificationResponse, adaptSectionClassificationResponse, adaptSkillNormalizationResponse, adaptSuggestionEnhancementResponse, analyzeResume, analyzeResumeAsync, createPrompt, defaultProfiles, defaultSkillAliases, safeExtractArray, safeExtractNumber, safeExtractString };
+export { ATSAnalysisResult, ATSProfile, AnalyzeResumeInput, JSONSchema, KeywordRegistry, LLMBudget, LLMBudgetManager, LLMConfig, LLMManager, LLMPrompts, LLMResult, LLMSchemas, SkillAliases, adaptJdClarificationResponse, adaptSectionClassificationResponse, adaptSkillNormalizationResponse, adaptSuggestionEnhancementResponse, analyzeResume, analyzeResumeAsync, createPrompt, defaultKeywordRegistry, defaultProfiles, defaultSkillAliases, safeExtractArray, safeExtractNumber, safeExtractString };

package/dist/index.d.ts

@@ -1,262 +1,7 @@
-type ResumeSection = "summary" | "experience" | "skills" | "education" | "projects" | "certifications";
-interface ParsedDateRange {
-    raw?: string;
-    start?: string;
-    end?: string;
-    durationInMonths?: number;
-    /** Numeric year/month of the start and end, for overlap-aware summing. */
-    startYear?: number;
-    startMonth?: number;
-    endYear?: number;
-    endMonth?: number;
-}
-interface ParsedExperienceEntry {
-    title?: string;
-    company?: string;
-    location?: string;
-    dates?: ParsedDateRange;
-    description?: string;
-}
-interface ParsedResume {
-    raw: string;
-    normalizedText: string;
-    detectedSections: ResumeSection[];
-    sectionContent: Partial<Record<ResumeSection, string>>;
-    skills: string[];
-    jobTitles: string[];
-    actionVerbs: string[];
-    educationEntries: string[];
-    experience: ParsedExperienceEntry[];
-    totalExperienceYears: number;
-    keywords: string[];
-    warnings: string[];
-}
-interface ParsedJobDescription {
-    raw: string;
-    normalizedText: string;
-    requiredSkills: string[];
-    preferredSkills: string[];
-    roleKeywords: string[];
-    keywords: string[];
-    minExperienceYears?: number;
-    educationRequirements: string[];
-}
-
-interface ATSWeights {
-    skills: number;
-    experience: number;
-    keywords: number;
-    education: number;
-}
-type SkillAliases = Record<string, string[]>;
-interface ATSProfile {
-    name: string;
-    mandatorySkills: string[];
-    optionalSkills: string[];
-    minExperience?: number;
-}
-interface KeywordDensityConfig {
-    /** Minimum density before a keyword is considered underused (informational only). */
-    min: number;
-    /** Maximum density before a keyword is considered stuffed. */
-    max: number;
-    /** Penalty applied when density exceeds max. */
-    overusePenalty: number;
-}
-interface SectionPenaltyConfig {
-    missingSummary?: number;
-    missingExperience?: number;
-    missingSkills?: number;
-    missingEducation?: number;
-}
-interface ATSRule {
-    id: string;
-    description?: string;
-    penalty: number;
-    warning?: string;
-    condition: (context: RuleContext) => boolean;
-}
-interface ATSConfig {
-    weights?: Partial<ATSWeights>;
-    skillAliases?: SkillAliases;
-    profile?: ATSProfile;
-    rules?: ATSRule[];
-    keywordDensity?: KeywordDensityConfig;
-    sectionPenalties?: SectionPenaltyConfig;
-    allowPartialMatches?: boolean;
-    /**
-     * ISO date string (e.g. "2024-06-01") used as the "today" reference when
-     * computing duration for open-ended date ranges ("Present"/"Current"/"Now").
-     * Omit to use the actual current date (live/production behaviour).
-     * Set to a fixed value in tests or batch processing to guarantee determinism.
-     */
-    referenceDate?: string;
-}
-interface NormalizedWeights extends ATSWeights {
-    /** Weights normalized so they sum to 1. */
-    normalizedTotal: number;
-}
-interface ResolvedATSConfig {
-    weights: NormalizedWeights;
-    skillAliases: SkillAliases;
-    profile?: ATSProfile;
-    rules: ATSRule[];
-    keywordDensity: KeywordDensityConfig;
-    sectionPenalties: Required<SectionPenaltyConfig>;
-    allowPartialMatches: boolean;
-    /** Resolved reference date for "Present" duration calculations. */
-    referenceDate?: Date;
-}
-interface RuleContext {
-    resume: ParsedResume;
-    job: ParsedJobDescription;
-    weights: NormalizedWeights;
-    keywordDensity: KeywordDensityConfig;
-    breakdown?: ATSBreakdown;
-    matchedKeywords?: string[];
-    overusedKeywords?: string[];
-}
-
-/**
- * LLM v2 Support Types - Optional, Backward Compatible
- */
-
-/**
- * JSON Schema for response validation
- */
-interface JSONSchema {
-    type: string;
-    properties?: Record<string, unknown>;
-    required?: string[];
-    items?: unknown;
-    [key: string]: unknown;
-}
-/**
- * LLM Client abstraction - user provides their own implementation
- * This allows flexibility with different LLM providers without direct dependencies
- */
-interface LLMClient {
-    /**
-     * Create a structured completion from the LLM
-     * Must validate and return only valid JSON matching the schema
-     */
-    createCompletion(input: {
-        model: string;
-        messages: {
-            role: "system" | "user";
-            content: string;
-        }[];
-        max_tokens: number;
-        response_format: JSONSchema;
-    }): Promise<{
-        content: unknown;
-        usage?: {
-            prompt_tokens?: number;
-            completion_tokens?: number;
-            total_tokens?: number;
-        };
-    }>;
-}
-/**
- * LLM budget configuration - prevents runaway spending
- */
-interface LLMBudget {
-    maxCalls: number;
-    maxTokensPerCall: number;
-    maxTotalTokens: number;
-}
-/**
- * Feature toggles for LLM capabilities
- */
-interface LLMFeatures {
-    skillNormalization?: boolean;
-    sectionClassification?: boolean;
-    suggestions?: boolean;
-}
-/**
- * Complete LLM configuration
- */
-interface LLMConfig {
-    /** User-provided LLM client (e.g., OpenAI wrapper) */
-    client: LLMClient;
-    /** Model identifiers */
-    models?: {
-        /** Default model for fast, structured output (e.g., "gpt-4o-mini") */
-        default: string;
-        /** Optional thinking model for complex reasoning (e.g., "o4-mini") */
-        thinking?: string;
-    };
-    /** Budget constraints */
-    limits: LLMBudget;
-    /** Which LLM features to enable */
-    enable?: LLMFeatures;
-    /** Request timeout in milliseconds */
-    timeoutMs?: number;
-}
-/**
- * Updated AnalyzeResumeInput with optional LLM support
- */
-interface AnalyzeResumeInputV2 {
-    resumeText: string;
-    jobDescription: string;
-    config?: ATSConfig;
-    llm?: LLMConfig;
-}
-/**
- * LLM usage tracking for debugging
- */
-interface LLMUsageStats {
-    totalCalls: number;
-    totalTokensUsed: number;
-    callsRemaining: number;
-    tokensRemaining: number;
-    features: Partial<Record<keyof LLMFeatures, boolean>>;
-}
-/**
- * Result of an LLM operation (with fallback info)
- */
-interface LLMResult<T> {
-    success: boolean;
-    data?: T;
-    fallback: boolean;
-    error?: string;
-    tokensUsed?: number;
-}
-
-interface ATSBreakdown {
-    skills: number;
-    experience: number;
-    keywords: number;
-    education: number;
-}
-interface AnalyzeResumeInput {
-    resumeText: string;
-    jobDescription: string;
-    config?: ATSConfig;
-    llm?: LLMConfig;
-}
-interface ATSAnalysisResult {
-    score: number;
-    breakdown: ATSBreakdown;
-    /** Skills found in the resume that satisfy JD + profile requirements. */
-    matchedSkills: string[];
-    /** Required skills absent from the resume. */
-    missingSkills: string[];
-    matchedKeywords: string[];
-    missingKeywords: string[];
-    overusedKeywords: string[];
-    suggestions: string[];
-    warnings: string[];
-    /** Years below the JD's minimum experience requirement; 0 when the requirement is met. */
-    experienceGap: number;
-    /** Resume sections the parser successfully detected (e.g. "summary", "skills"). */
-    detectedSections: string[];
-    /** Total years of experience parsed from the resume's date ranges. */
-    parsedExperienceYears: number;
-    /** Parsed experience entries from the resume, with titles and date ranges. */
-    experienceEntries: ParsedExperienceEntry[];
-}
+import { A as ATSProfile, S as SkillAliases, K as KeywordRegistry, L as LLMConfig, J as JSONSchema, a as LLMResult, b as LLMBudget, c as AnalyzeResumeInput, d as ATSAnalysisResult } from './scoring-BCShrnki.js';
+export { s as ATSBreakdown, k as ATSConfig, j as ATSRule, e as ATSWeights, w as AnalyzeResumeInputV2, f as KeywordCategory, h as KeywordDensityConfig, g as KeywordEntry, t as KeywordWeight, u as LLMClient, v as LLMFeatures, x as LLMUsageStats, N as NormalizedWeights, o as ParsedAchievement, P as ParsedDateRange, n as ParsedExperienceEntry, r as ParsedJobDescription, p as ParsedLanguage, q as ParsedResume, R as ResolvedATSConfig, m as ResumeSection, l as RuleContext, i as SectionPenaltyConfig } from './scoring-BCShrnki.js';
 
+declare const defaultKeywordRegistry: KeywordRegistry;
 declare const defaultSkillAliases: SkillAliases;
 declare const defaultProfiles: ATSProfile[];
 
@@ -506,4 +251,4 @@ declare function analyzeResume(input: AnalyzeResumeInput): ATSAnalysisResult;
  */
 declare function analyzeResumeAsync(input: AnalyzeResumeInput): Promise<ATSAnalysisResult>;
 
-export { type ATSAnalysisResult, type ATSBreakdown, type ATSConfig, type ATSProfile, type ATSRule, type ATSWeights, type AnalyzeResumeInput, type AnalyzeResumeInputV2, type JSONSchema, type KeywordDensityConfig, type LLMBudget, LLMBudgetManager, type LLMClient, type LLMConfig, type LLMFeatures, LLMManager, LLMPrompts, type LLMResult, LLMSchemas, type LLMUsageStats, type NormalizedWeights, type ParsedDateRange, type ParsedExperienceEntry, type ParsedJobDescription, type ParsedResume, type ResolvedATSConfig, type ResumeSection, type RuleContext, type SectionPenaltyConfig, type SkillAliases, adaptJdClarificationResponse, adaptSectionClassificationResponse, adaptSkillNormalizationResponse, adaptSuggestionEnhancementResponse, analyzeResume, analyzeResumeAsync, createPrompt, defaultProfiles, defaultSkillAliases, safeExtractArray, safeExtractNumber, safeExtractString };
+export { ATSAnalysisResult, ATSProfile, AnalyzeResumeInput, JSONSchema, KeywordRegistry, LLMBudget, LLMBudgetManager, LLMConfig, LLMManager, LLMPrompts, LLMResult, LLMSchemas, SkillAliases, adaptJdClarificationResponse, adaptSectionClassificationResponse, adaptSkillNormalizationResponse, adaptSuggestionEnhancementResponse, analyzeResume, analyzeResumeAsync, createPrompt, defaultKeywordRegistry, defaultProfiles, defaultSkillAliases, safeExtractArray, safeExtractNumber, safeExtractString };