feat: support expired and not-found ref API errors

[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 adds support for two new ref-related errors that may be returned by Rest API V2:

• RefNotFoundError: Thrown when a query's ref does not exist.
• RefExpiredError: Thrown when a query's ref is expired (generally older than 5 minutes if it is not the master ref or a release).

This is a non-breaking change since the errors were previously thrown as ForbiddenErrors. The new error types extend from ForbiddenError and will continue to work with instanceof ForbiddenError.

The new errors will extend from PrismicError in a future major version for better semantics.

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.

🫎

[lihbr]

Just a small suggestion so we can release that as a minor, but look good to me otherwise :)

[codecov-commenter]

Codecov Report

All modified lines are covered by tests ✅

Comparison is base (fb555fd) 99.97% compared to head (a34d2d2) 99.97%.

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@           Coverage Diff           @@
##           master     #327   +/-   ##
=======================================
  Coverage   99.97%   99.97%           
=======================================
  Files          57       59    +2     
  Lines        6794     6843   +49     
  Branches      374      376    +2     
=======================================
+ Hits         6792     6841   +49     
  Misses          2        2           

Files	Coverage Δ
src/createClient.ts	100.00% <100.00%> (ø)
src/errors/ForbiddenError.ts	100.00% <100.00%> (ø)
src/errors/NotFoundError.ts	100.00% <100.00%> (ø)
src/errors/ParsingError.ts	100.00% <100.00%> (ø)
src/errors/RefExpiredError.ts	100.00% <100.00%> (ø)
src/errors/RefNotFoundError.ts	100.00% <100.00%> (ø)
src/index.ts	100.00% <100.00%> (ø)

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.