headFile()

const metadata = await repo.headFile({
  path: "README.md",
  ref: "main",
});
console.log(metadata.status, metadata.etag, metadata.size, metadata.lastCommitSha);

const ranged = await repo.headFile({
  path: "README.md",
  headers: { range: "bytes=0-1023" },
});
console.log(ranged.status, ranged.contentRange);

const cached = await repo.headFile({
  path: "README.md",
  headers: { ifNoneMatch: '"abc123"' },
});
console.log(cached.status);