DeepSource MCP Server

/** * @fileoverview Project repository interface * * This module defines the repository interface for the Project aggregate. */ import { IRepository } from '../../shared/repository.interface.js'; import { Project } from './project.aggregate.js'; import { ProjectKey } from '../../../types/branded.js'; /** * Repository interface for Project aggregates * * Provides methods for persisting and retrieving Project aggregates. * * @example * ```typescript * class InMemoryProjectRepository implements IProjectRepository { * private projects = new Map<ProjectKey, Project>(); * * async findByKey(key: ProjectKey): Promise<Project | null> { * return this.projects.get(key) || null; * } * * async findAll(): Promise<Project[]> { * return Array.from(this.projects.values()); * } * * async save(project: Project): Promise<void> { * this.projects.set(project.key, project); * } * * async delete(key: ProjectKey): Promise<void> { * this.projects.delete(key); * } * } * ``` */ export interface IProjectRepository extends IRepository<Project, ProjectKey> { /** * Finds a project by its unique key * * @param key - The project key * @returns The project if found, null otherwise */ findByKey(_key: ProjectKey): Promise<Project | null>; /** * Finds all projects * * @returns All projects in the repository */ findAll(): Promise<Project[]>; /** * Finds all active projects * * @returns All projects with ACTIVE status */ findActive(): Promise<Project[]>; /** * Finds projects by repository provider * * @param provider - The VCS provider (e.g., 'GITHUB', 'GITLAB') * @returns Projects using the specified provider */ findByProvider(_provider: string): Promise<Project[]>; /** * Checks if a project exists with the given key * * @param key - The project key to check * @returns True if the project exists, false otherwise */ exists(_key: ProjectKey): Promise<boolean>; /** * Counts the total number of projects * * @returns The total project count */ count(): Promise<number>; /** * Counts the number of active projects * * @returns The active project count */ countActive(): Promise<number>; }