Get GitHub Actions cache usage for a repository

type Github = {

  token: string;

};

/**

 * Get GitHub Actions cache usage for a repository

 * Gets GitHub Actions cache usage for a repository.

The data fetched using this API is refreshed approximately every 5 minutes, so values returned from this endpoint may take at least 5 minutes to get updated.

Anyone with read access to the repository can use this endpoint. If the repository is private, you must use an access token with the `repo` scope. GitHub Apps must have the `actions:read` permission to use this endpoint.

 */

export async function main(auth: Github, owner: string, repo: string) {

  const url = new URL(

    `https://api.github.com/repos/${owner}/${repo}/actions/cache/usage`

  );

  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.json();

}