Download a repository archive (tar)

type Github = {

  token: string;

};

/**

 * Download a repository archive (tar)

 * Gets a redirect URL to download a tar archive for a repository. If you omit `:ref`, the repository’s default branch (usually

`main`) will be used. Please make sure your HTTP framework is configured to follow redirects or you will need to use

the `Location` header to make a second `GET` request.

**Note**: For private repositories, these links are temporary and expire after five minutes.

 */

export async function main(

  auth: Github,

  owner: string,

  repo: string,

  ref: string

) {

  const url = new URL(

    `https://api.github.com/repos/${owner}/${repo}/tarball/${ref}`

  );

  const response = await fetch(url, {

    method: "GET",

    headers: {

      Authorization: "Bearer " + auth.token,

    },

    body: undefined,

  });

  if (!response.ok) {

    const text = await response.text();

    throw new Error(`${response.status} ${text}`);

  }

  return await response.text();

}