.ts
TypeScript
(application/typescript)
// std
import { PathLike } from "node:fs";
// 1st-party
import type { ServiceApiContract } from "@ethicdevs/react-monolith";
// 3rd-party
import type { FastifyRequest } from "fastify";
// generated via script[generate:prisma]
import type { Organization, Repository } from "@prisma/client";
// app
import type {
  RepositoryFile,
  RepositoryFileContent,
  RepositoryHead,
} from "../../types";

export interface CreateRepositoryDTO {
  parentOrgSlug: string;
  repoSlug: string;
  repoData: Omit<
    Repository,
    "id" | "slug" | "createdAt" | "updatedAt" | "organizationId"
  >;
  repoInitFlags: {
    orgRepositoriesDir: PathLike;
    withBaseReadmeFile: boolean;
    withLicense: boolean;
    withLicenseKind: string;
  };
}

export interface RepositoryServiceAPI extends ServiceApiContract {
  createRepository(dto: CreateRepositoryDTO): Promise<Repository>;
  getRepository(orgSlug: string, repoSlug: string): Promise<Repository | null>;
  getRepositoryExploreCollection(): Promise<
    (Repository & { parentOrg: Organization })[]
  >;
  getRepositoryFileContent(
    repository: Repository,
    path: string,
    ref?: string
  ): Promise<null | RepositoryFileContent>;
  getRepositoryFiles(
    repository: Repository,
    path?: string,
    ref?: string
  ): Promise<RepositoryFile[]>;
  getRepositoryHead(
    repository: Repository,
    ref?: string
  ): Promise<RepositoryHead>;
  getRepositoryHTTPCloneUrl(repository: Repository): Promise<string>;
  getRepositorySSHCloneUrl(repository: Repository): Promise<string>;
}

export interface RepositoryServiceDeps {
  request: FastifyRequest;
}