feat: add phone number extraction to resume parser [ GSSOC'26 ] (JhaSourav07#2986)

## Description

Adds `extractPhone()` to the resume parser that matches common phone
number formats including international prefixes, dashes, dots, spaces,
and parentheses. The extracted value is included as a `phone` field
in the `ParsedResume` return value.

Fixes JhaSourav07#2985 

## Pillar
- [x] 🛠️ Other (Bug fix, refactoring, docs)

## Visual Preview
N/A — parsing utility, no visual output.

## Checklist before requesting a review:
- [x] I have read the `CONTRIBUTING.md` file.
- [x] I have tested these changes locally.
- [x] I have run `npm run format` and `npm run lint` locally and
resolved all errors.
- [x] My commits follow the Conventional Commits format.
- [x] I have updated `README.md` if I added a new theme or URL
parameter.
- [x] I have starred the repo.
- [x] I have made sure that I have only one commit to merge in this PR.
- [ ] The SVG output matches the CommitPulse "premium quality" aesthetic
standard.
- [ ] (Recommended) I joined the CommitPulse Discord community.

Author: rudra3007-pro

lib/resume-parser.ts

@@ -118,12 +118,30 @@ function extractTextFromBuffer(buffer: Buffer, _mimeType: string): string {
   return printable;
 }
 
+/**
+ * Extracts a phone number from raw resume text.
+ *
+ * Matches common formats including international prefixes,
+ * dashes, dots, spaces, and parentheses.
+ *
+ * @param text - Raw resume text.
+ * @returns The first phone number found, or an empty string.
+ *
+ * @example
+ * const phone = extractPhone(rawText);
+ */
+function extractPhone(text: string): string {
+  const match = text.match(/(\+?\d{1,3}[\s.-]?)?(\(?\d{3}\)?[\s.-]?)(\d{3}[\s.-]?\d{4})/);
+  return match ? match[0].trim() : '';
+}
+
 export async function parseResume(buffer: Buffer, mimeType: string): Promise<ParsedResume> {
   const rawText = extractTextFromBuffer(buffer, mimeType);
 
   return {
     name: extractName(rawText),
     email: extractEmail(rawText),
+    phone: extractPhone(rawText),
     skills: extractSkills(rawText),
     education: extractEducation(rawText),
     experience: extractExperience(rawText),

types/student.test.ts

@@ -29,6 +29,7 @@ describe('types/student', () => {
     const parsedResume: ParsedResume = {
       name: 'Sonal Mittal',
       email: 'sonal@example.com',
+      phone: '',
       skills: ['TypeScript', 'React'],
       education: [education],
       experience: [experience],
@@ -77,6 +78,7 @@ describe('types/student', () => {
       data: {
         name: 'Sonal Mittal',
         email: 'sonal@example.com',
+        phone: '',
         skills: ['React'],
         education: [education],
         experience: [experience],

types/student.ts

@@ -1,6 +1,7 @@
 export interface ParsedResume {
   name: string;
   email: string;
+  phone: string;
   skills: string[];
   education: Education[];
   experience: Experience[];