refactor: optimize getFirst() and dependent methods

[angeloashmore]

Types of changes

• Chore (a non-breaking change which is related to package maintenance)
• Bug fix (a non-breaking change which fixes an issue)
• New feature (a non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

Description

This PR optimizes getFirst() by defaulting to only query one document. It does this by setting pageSize=1.

The following methods also benefit from this optimization since they use getFirst() within their implementation:

• getByID()
• getByUID()
• getSingle()
• resolvePreviewURL()

Exceptions to this optimization:

• If a page param is provided, pageSize is not set. pageSize affects the behavior of page, so we cannot automatically set pageSize to 1.
• If a pageSize param is provided, it takes priority.

Checklist:

• My change requires an update to the official documentation.
• All TSDoc comments are up-to-date and new ones have been added where necessary.
• All new and existing tests are passing.

🐥

[github-actions]

size-limit report 📦

Path	Size
dist/index.js	4.12 KB (+0.58% 🔺)
dist/index.cjs	7.02 KB (+0.33% 🔺)

[codecov-commenter]

Codecov Report

Merging #249 (de04971) into master (62fdae1) will increase coverage by 0.00%.
The diff coverage is 100.00%.

@@           Coverage Diff           @@
##           master     #249   +/-   ##
=======================================
  Coverage   99.46%   99.47%           
=======================================
  Files          23       23           
  Lines         377      379    +2     
  Branches       76       78    +2     
=======================================
+ Hits          375      377    +2     
  Partials        2        2           

Impacted Files	Coverage Δ
src/client.ts	99.11% <100.00%> (+<0.01%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 62fdae1...de04971. Read the comment docs.

[lihbr]

LGTM 👏