hirebase-mcp 1.0.0

package/README.md

@@ -0,0 +1,133 @@
+# HireBase
+
+AI-powered CV search engine built as an MCP Server. Stores CVs in LanceDB vector database, extracts structured data with GPT, and finds the best-matching candidates for any job description using semantic search.
+
+## Architecture
+
+**DDD + Clean Architecture** with clear separation of concerns:
+
+```
+src/
+├── domain/           # Entities, Value Objects, Repository Interfaces
+├── application/      # Use Cases, Ports, DTOs
+├── infrastructure/   # LanceDB, OpenAI, PDF/DOCX Parsers
+├── interface/        # MCP Server, Tools, CLI Entry Point
+└── shared/           # Errors, Types, Utilities
+```
+
+**Design Principle:** MCP Server = Data layer (parse, store, search, return). The AI client using the tools handles analysis, ranking strategy, and match explanations.
+
+## Tech Stack
+
+| Technology | Purpose |
+|---|---|
+| TypeScript 5.9 | Language |
+| LanceDB | Vector database (embedded, serverless) |
+| OpenAI `text-embedding-3-large` | 3072-dim embeddings |
+| OpenAI `gpt-5-mini` | Structured CV extraction (Responses API) |
+| MCP SDK | Model Context Protocol server |
+| unpdf | PDF text extraction |
+| mammoth | DOCX text extraction |
+
+## MCP Tools
+
+| Tool | Description |
+|---|---|
+| `add_cv` | Parse CV file (PDF/DOCX), extract structured data, embed, store |
+| `bulk_add_cvs` | Process all CVs in a directory |
+| `update_cv` | Update existing CV, archive old version |
+| `semantic_search` | Vector similarity search with optional section filter |
+| `filter_candidates` | Structured filtering (skills, location, experience, languages, tags) |
+| `get_cv_detail` | Full candidate data |
+| `get_cv_chunks` | CV section chunks |
+| `list_cvs` | Paginated candidate list |
+| `delete_cv` | Delete candidate and all related data |
+| `manage_tags` | Add/remove/list tags |
+| `get_cv_versions` | Version history |
+| `get_stats` | Database statistics |
+| `export_results` | Export as JSON or CSV |
+
+## How It Works
+
+```
+CV File (PDF/DOCX)
+    │
+    ▼
+[1] Parse text (unpdf / mammoth)
+    │
+    ▼
+[2] Extract structured data (GPT-5 mini)
+    │  name, experience, education, skills, languages...
+    ▼
+[3] Chunk into sections
+    │  summary, each experience, education, skills, projects, certifications, full text
+    ▼
+[4] Generate embeddings (text-embedding-3-large, 3072d)
+    │
+    ▼
+[5] Store in LanceDB (candidates + cv_chunks + cv_versions tables)
+```
+
+**Search flow (driven by AI client):**
+1. AI analyzes job description
+2. Calls `filter_candidates` for hard requirements
+3. Calls `semantic_search` with job description text
+4. Cross-references results
+5. Gets full details with `get_cv_detail`
+6. Produces match explanation
+
+## Setup
+
+### Prerequisites
+
+- Node.js >= 22
+- pnpm
+- OpenAI API Key
+
+### Install & Build
+
+```bash
+pnpm install
+pnpm build
+```
+
+### Environment Variables
+
+```env
+OPENAI_API_KEY=sk-your-key-here
+LANCEDB_PATH=./data/lancedb          # optional, default: ./data/lancedb
+EMBEDDING_MODEL=text-embedding-3-large # optional
+EXTRACTION_MODEL=gpt-5-mini           # optional
+```
+
+### MCP Configuration
+
+Add to your Claude Code or Claude Desktop config:
+
+```json
+{
+  "mcpServers": {
+    "hirebase": {
+      "command": "node",
+      "args": ["<path-to-project>/dist/interface/cli/index.js"],
+      "env": {
+        "OPENAI_API_KEY": "sk-your-key",
+        "LANCEDB_PATH": "<path-to-project>/data/lancedb"
+      }
+    }
+  }
+}
+```
+
+## Key Design Decisions
+
+- **LanceDB has no UPDATE** — update is implemented as delete + add at repository level
+- **Complex fields stored as JSON strings** — skills, experience, etc. serialized in Utf8 columns
+- **Batch embedding** — all chunks embedded in a single OpenAI API call
+- **Seed rows** — tables use `__seed__` rows for schema inference, filtered out in queries
+- **Versioning** — old CV data archived before updates, full history accessible
+- **Section-level chunking** — each work experience is a separate chunk for granular matching
+
+## License
+
+MIT

package/dist/application/dto/candidate-summary.d.ts

@@ -0,0 +1,10 @@
+export interface CandidateSummaryDto {
+    id: string;
+    name: string;
+    email?: string;
+    location?: string;
+    skills: string[];
+    experienceYears?: number;
+    tags: string[];
+    createdAt: string;
+}

package/dist/application/dto/candidate-summary.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=candidate-summary.js.map

package/dist/application/dto/candidate-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-summary.js","sourceRoot":"","sources":["../../../src/application/dto/candidate-summary.ts"],"names":[],"mappings":""}

package/dist/application/dto/extracted-cv.d.ts

@@ -0,0 +1,43 @@
+export interface ExtractedCv {
+    name: string;
+    email?: string;
+    phone?: string;
+    location?: string;
+    summary?: string;
+    experience: {
+        company: string;
+        position: string;
+        startDate?: string;
+        endDate?: string;
+        description?: string;
+    }[];
+    education: {
+        institution: string;
+        degree?: string;
+        field?: string;
+        startDate?: string;
+        endDate?: string;
+    }[];
+    skills: string[];
+    languages: {
+        language: string;
+        level?: string;
+    }[];
+    certifications: {
+        name: string;
+        issuer?: string;
+        date?: string;
+    }[];
+    projects: {
+        name: string;
+        description?: string;
+        technologies?: string[];
+    }[];
+    links?: {
+        linkedin?: string;
+        github?: string;
+        portfolio?: string;
+        other?: string[];
+    };
+    totalExperienceYears?: number;
+}

package/dist/application/dto/extracted-cv.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extracted-cv.js.map

package/dist/application/dto/extracted-cv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extracted-cv.js","sourceRoot":"","sources":["../../../src/application/dto/extracted-cv.ts"],"names":[],"mappings":""}

package/dist/application/dto/filter-input.d.ts

@@ -0,0 +1,7 @@
+export interface FilterInput {
+    skills?: string[];
+    location?: string;
+    minExperienceYears?: number;
+    languages?: string[];
+    tags?: string[];
+}

package/dist/application/dto/filter-input.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=filter-input.js.map

package/dist/application/dto/filter-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-input.js","sourceRoot":"","sources":["../../../src/application/dto/filter-input.ts"],"names":[],"mappings":""}

package/dist/application/dto/index.d.ts

@@ -0,0 +1,5 @@
+export type { ExtractedCv } from './extracted-cv.js';
+export type { SearchResultDto, SearchInput } from './search-results.js';
+export type { FilterInput } from './filter-input.js';
+export type { CandidateSummaryDto } from './candidate-summary.js';
+export type { StatsDto } from './stats.js';

package/dist/application/dto/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/application/dto/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/application/dto/index.ts"],"names":[],"mappings":""}

package/dist/application/dto/search-results.d.ts

@@ -0,0 +1,13 @@
+export interface SearchResultDto {
+    candidateId: string;
+    candidateName: string;
+    sectionType: string;
+    content: string;
+    score: number;
+    metadata: Record<string, unknown>;
+}
+export interface SearchInput {
+    query: string;
+    limit?: number;
+    sectionType?: string;
+}

package/dist/application/dto/search-results.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search-results.js.map

package/dist/application/dto/search-results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-results.js","sourceRoot":"","sources":["../../../src/application/dto/search-results.ts"],"names":[],"mappings":""}

package/dist/application/dto/stats.d.ts

@@ -0,0 +1,8 @@
+export interface StatsDto {
+    totalCandidates: number;
+    totalChunks: number;
+    skillCounts: Record<string, number>;
+    locationCounts: Record<string, number>;
+    avgExperienceYears: number;
+    tagCounts: Record<string, number>;
+}

package/dist/application/dto/stats.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stats.js.map

package/dist/application/dto/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/application/dto/stats.ts"],"names":[],"mappings":""}

package/dist/application/ports/document-parser.d.ts

@@ -0,0 +1,8 @@
+export interface ParsedDocument {
+    text: string;
+    pageCount?: number;
+}
+export interface IDocumentParser {
+    parse(filePath: string): Promise<ParsedDocument>;
+    supports(fileType: string): boolean;
+}

package/dist/application/ports/document-parser.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=document-parser.js.map

package/dist/application/ports/document-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-parser.js","sourceRoot":"","sources":["../../../src/application/ports/document-parser.ts"],"names":[],"mappings":""}

package/dist/application/ports/embedding-service.d.ts

@@ -0,0 +1,4 @@
+export interface IEmbeddingService {
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+}

package/dist/application/ports/embedding-service.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=embedding-service.js.map

package/dist/application/ports/embedding-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-service.js","sourceRoot":"","sources":["../../../src/application/ports/embedding-service.ts"],"names":[],"mappings":""}

package/dist/application/ports/export-service.d.ts

@@ -0,0 +1,5 @@
+import type { Candidate } from '../../domain/entities/candidate.js';
+import type { ExportFormat } from '../../shared/types/index.js';
+export interface IExportService {
+    export(candidates: Candidate[], format: ExportFormat): string;
+}

package/dist/application/ports/export-service.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=export-service.js.map

package/dist/application/ports/export-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-service.js","sourceRoot":"","sources":["../../../src/application/ports/export-service.ts"],"names":[],"mappings":""}

package/dist/application/ports/index.d.ts

@@ -0,0 +1,4 @@
+export type { IDocumentParser, ParsedDocument } from './document-parser.js';
+export type { IEmbeddingService } from './embedding-service.js';
+export type { IStructuredExtractor } from './structured-extractor.js';
+export type { IExportService } from './export-service.js';

package/dist/application/ports/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/application/ports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/application/ports/index.ts"],"names":[],"mappings":""}

package/dist/application/ports/structured-extractor.d.ts

@@ -0,0 +1,4 @@
+import type { ExtractedCv } from '../dto/extracted-cv.js';
+export interface IStructuredExtractor {
+    extract(rawText: string): Promise<ExtractedCv>;
+}

package/dist/application/ports/structured-extractor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=structured-extractor.js.map

package/dist/application/ports/structured-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-extractor.js","sourceRoot":"","sources":["../../../src/application/ports/structured-extractor.ts"],"names":[],"mappings":""}

package/dist/application/use-cases/add-cv.d.ts

@@ -0,0 +1,15 @@
+import type { ICandidateRepository } from '../../domain/repositories/candidate-repository.js';
+import type { IChunkRepository } from '../../domain/repositories/chunk-repository.js';
+import type { Candidate } from '../../domain/entities/candidate.js';
+import type { IDocumentParser } from '../ports/document-parser.js';
+import type { IEmbeddingService } from '../ports/embedding-service.js';
+import type { IStructuredExtractor } from '../ports/structured-extractor.js';
+export declare class AddCvUseCase {
+    private candidateRepo;
+    private chunkRepo;
+    private parsers;
+    private embeddingService;
+    private extractor;
+    constructor(candidateRepo: ICandidateRepository, chunkRepo: IChunkRepository, parsers: IDocumentParser[], embeddingService: IEmbeddingService, extractor: IStructuredExtractor);
+    execute(filePath: string): Promise<Candidate>;
+}

package/dist/application/use-cases/add-cv.js

@@ -0,0 +1,88 @@
+import { nanoid } from 'nanoid';
+import { detectFileType } from '../../shared/utils/text.js';
+import { createChunks } from '../../shared/utils/chunking.js';
+import { UnsupportedFileTypeError, DuplicateCandidateError } from '../../shared/errors/index.js';
+export class AddCvUseCase {
+    candidateRepo;
+    chunkRepo;
+    parsers;
+    embeddingService;
+    extractor;
+    constructor(candidateRepo, chunkRepo, parsers, embeddingService, extractor) {
+        this.candidateRepo = candidateRepo;
+        this.chunkRepo = chunkRepo;
+        this.parsers = parsers;
+        this.embeddingService = embeddingService;
+        this.extractor = extractor;
+    }
+    async execute(filePath) {
+        const fileType = detectFileType(filePath);
+        const parser = this.parsers.find((p) => p.supports(fileType));
+        if (!parser) {
+            throw new UnsupportedFileTypeError(fileType);
+        }
+        const { text: rawText } = await parser.parse(filePath);
+        const extracted = await this.extractor.extract(rawText);
+        if (extracted.email) {
+            const existing = await this.candidateRepo.findByEmail(extracted.email);
+            if (existing) {
+                throw new DuplicateCandidateError(extracted.email);
+            }
+        }
+        const candidateId = nanoid();
+        const now = new Date().toISOString();
+        const chunkInputs = createChunks(extracted, rawText);
+        const chunkTexts = chunkInputs.map((c) => c.content);
+        const vectors = await this.embeddingService.embedBatch(chunkTexts);
+        const candidate = {
+            id: candidateId,
+            name: extracted.name,
+            contact: {
+                email: extracted.email,
+                phone: extracted.phone,
+                location: extracted.location,
+            },
+            summary: extracted.summary,
+            experience: extracted.experience.map((e) => ({
+                company: e.company,
+                position: e.position,
+                startDate: e.startDate,
+                endDate: e.endDate,
+                description: e.description,
+            })),
+            education: extracted.education.map((e) => ({
+                institution: e.institution,
+                degree: e.degree,
+                field: e.field,
+                startDate: e.startDate,
+                endDate: e.endDate,
+            })),
+            skills: extracted.skills,
+            languages: extracted.languages,
+            certifications: extracted.certifications,
+            projects: extracted.projects,
+            links: extracted.links,
+            tags: [],
+            experienceYears: extracted.totalExperienceYears,
+            sourceFile: filePath,
+            fileType,
+            rawText,
+            createdAt: now,
+            updatedAt: now,
+            version: 1,
+        };
+        const chunks = chunkInputs.map((input, i) => ({
+            id: nanoid(),
+            candidateId,
+            sectionType: input.sectionType,
+            content: input.content,
+            vector: vectors[i],
+            metadata: input.metadata,
+            createdAt: now,
+        }));
+        await this.candidateRepo.save(candidate);
+        await this.chunkRepo.saveMany(chunks);
+        return candidate;
+    }
+}
+//# sourceMappingURL=add-cv.js.map

package/dist/application/use-cases/add-cv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-cv.js","sourceRoot":"","sources":["../../../src/application/use-cases/add-cv.ts"],"names":[],"mappings":"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"}

package/dist/application/use-cases/bulk-add-cvs.d.ts

@@ -0,0 +1,14 @@
+import type { Candidate } from '../../domain/entities/candidate.js';
+import { AddCvUseCase } from './add-cv.js';
+export interface BulkAddResult {
+    succeeded: Candidate[];
+    failed: {
+        file: string;
+        error: string;
+    }[];
+}
+export declare class BulkAddCvsUseCase {
+    private addCvUseCase;
+    constructor(addCvUseCase: AddCvUseCase);
+    execute(directoryPath: string): Promise<BulkAddResult>;
+}

package/dist/application/use-cases/bulk-add-cvs.js

@@ -0,0 +1,32 @@
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+export class BulkAddCvsUseCase {
+    addCvUseCase;
+    constructor(addCvUseCase) {
+        this.addCvUseCase = addCvUseCase;
+    }
+    async execute(directoryPath) {
+        const entries = await readdir(directoryPath);
+        const cvFiles = entries.filter((f) => {
+            const ext = f.toLowerCase().split('.').pop();
+            return ext === 'pdf' || ext === 'docx';
+        });
+        const succeeded = [];
+        const failed = [];
+        for (const file of cvFiles) {
+            const filePath = join(directoryPath, file);
+            try {
+                const candidate = await this.addCvUseCase.execute(filePath);
+                succeeded.push(candidate);
+            }
+            catch (error) {
+                failed.push({
+                    file,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        return { succeeded, failed };
+    }
+}
+//# sourceMappingURL=bulk-add-cvs.js.map

package/dist/application/use-cases/bulk-add-cvs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-add-cvs.js","sourceRoot":"","sources":["../../../src/application/use-cases/bulk-add-cvs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,MAAM,OAAO,iBAAiB;IACR;IAApB,YAAoB,YAA0B;QAA1B,iBAAY,GAAZ,YAAY,CAAc;IAAG,CAAC;IAElD,KAAK,CAAC,OAAO,CAAC,aAAqB;QACjC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACnC,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YAC7C,OAAO,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,MAAM,SAAS,GAAgB,EAAE,CAAC;QAClC,MAAM,MAAM,GAAsC,EAAE,CAAC;QAErD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YAC3C,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAC5D,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI;oBACJ,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC9D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;CACF"}

package/dist/application/use-cases/delete-cv.d.ts

@@ -0,0 +1,10 @@
+import type { ICandidateRepository } from '../../domain/repositories/candidate-repository.js';
+import type { IChunkRepository } from '../../domain/repositories/chunk-repository.js';
+import type { IVersionRepository } from '../../domain/repositories/version-repository.js';
+export declare class DeleteCvUseCase {
+    private candidateRepo;
+    private chunkRepo;
+    private versionRepo;
+    constructor(candidateRepo: ICandidateRepository, chunkRepo: IChunkRepository, versionRepo: IVersionRepository);
+    execute(candidateId: string): Promise<void>;
+}

package/dist/application/use-cases/delete-cv.js

@@ -0,0 +1,21 @@
+import { CandidateNotFoundError } from '../../shared/errors/index.js';
+export class DeleteCvUseCase {
+    candidateRepo;
+    chunkRepo;
+    versionRepo;
+    constructor(candidateRepo, chunkRepo, versionRepo) {
+        this.candidateRepo = candidateRepo;
+        this.chunkRepo = chunkRepo;
+        this.versionRepo = versionRepo;
+    }
+    async execute(candidateId) {
+        const candidate = await this.candidateRepo.findById(candidateId);
+        if (!candidate) {
+            throw new CandidateNotFoundError(candidateId);
+        }
+        await this.chunkRepo.deleteByCandidateId(candidateId);
+        await this.versionRepo.deleteByCandidateId(candidateId);
+        await this.candidateRepo.delete(candidateId);
+    }
+}
+//# sourceMappingURL=delete-cv.js.map

package/dist/application/use-cases/delete-cv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-cv.js","sourceRoot":"","sources":["../../../src/application/use-cases/delete-cv.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,MAAM,OAAO,eAAe;IAEhB;IACA;IACA;IAHV,YACU,aAAmC,EACnC,SAA2B,EAC3B,WAA+B;QAF/B,kBAAa,GAAb,aAAa,CAAsB;QACnC,cAAS,GAAT,SAAS,CAAkB;QAC3B,gBAAW,GAAX,WAAW,CAAoB;IACtC,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,WAAmB;QAC/B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACjE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,sBAAsB,CAAC,WAAW,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QACxD,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/application/use-cases/export-results.d.ts

@@ -0,0 +1,9 @@
+import type { ICandidateRepository } from '../../domain/repositories/candidate-repository.js';
+import type { IExportService } from '../ports/export-service.js';
+import type { ExportFormat } from '../../shared/types/index.js';
+export declare class ExportResultsUseCase {
+    private candidateRepo;
+    private exportService;
+    constructor(candidateRepo: ICandidateRepository, exportService: IExportService);
+    execute(candidateIds: string[], format: ExportFormat): Promise<string>;
+}

package/dist/application/use-cases/export-results.js

@@ -0,0 +1,21 @@
+import { CandidateNotFoundError } from '../../shared/errors/index.js';
+export class ExportResultsUseCase {
+    candidateRepo;
+    exportService;
+    constructor(candidateRepo, exportService) {
+        this.candidateRepo = candidateRepo;
+        this.exportService = exportService;
+    }
+    async execute(candidateIds, format) {
+        const candidates = [];
+        for (const id of candidateIds) {
+            const candidate = await this.candidateRepo.findById(id);
+            if (!candidate) {
+                throw new CandidateNotFoundError(id);
+            }
+            candidates.push(candidate);
+        }
+        return this.exportService.export(candidates, format);
+    }
+}
+//# sourceMappingURL=export-results.js.map

package/dist/application/use-cases/export-results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-results.js","sourceRoot":"","sources":["../../../src/application/use-cases/export-results.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,MAAM,OAAO,oBAAoB;IAErB;IACA;IAFV,YACU,aAAmC,EACnC,aAA6B;QAD7B,kBAAa,GAAb,aAAa,CAAsB;QACnC,kBAAa,GAAb,aAAa,CAAgB;IACpC,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,YAAsB,EAAE,MAAoB;QACxD,MAAM,UAAU,GAAgB,EAAE,CAAC;QAEnC,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACxD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,sBAAsB,CAAC,EAAE,CAAC,CAAC;YACvC,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/application/use-cases/filter-candidates.d.ts

@@ -0,0 +1,9 @@
+import type { ICandidateRepository } from '../../domain/repositories/candidate-repository.js';
+import type { FilterInput } from '../dto/filter-input.js';
+import type { CandidateSummaryDto } from '../dto/candidate-summary.js';
+export declare class FilterCandidatesUseCase {
+    private candidateRepo;
+    constructor(candidateRepo: ICandidateRepository);
+    execute(input: FilterInput): Promise<CandidateSummaryDto[]>;
+    private toSummary;
+}