codeowners.d.ts

interface Codeowners {
  /**
   * Searches upwards for a codeowners file either in a direct
   * parent or within a docs/ or .github/ or .gitlab/ folder in a parent
   * folder of the cwd.
   * @param cwd current directory, defaults to process.cwd()
   */
  new(cwd?: string, fileName?: string): CodeownersFile;
}

interface CodeownersFile {
  /**
   * The codeowners file found as a parent of the cwd
   */
  readonly codeownersFilePath: string;
  /**
   * The assumed project directory root for paths within the codeowners file
   */
  readonly codeownersDirectory: string;

  /**
   * Get a list of owner(s) for a given file/folder path
   * @param filePath relative to the codeownersDirectory
   */
  getOwner(filePath: string): string[];
}

declare const co: Codeowners;
export = co;