fix: throw `NotFoundError` when a document cannot be found

Types of changes

[ ] Chore (a non-breaking change which is related to package maintenance)
[x] 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 fixes getFirst() and all dependent methods, including getByUID() and getByID(), by throwing a NotFoundError when a matching document is not found.

NotFoundError is a subclass of PrismicError, retaining compatibility with instanceof PrismicError.

Before:

import { createClient } from "@prismicio/client";

const client = createClient("example-prismic-repo");
await client.getByUID("page", "non-existent");
// => throws PrismicError

After:

import { createClient } from "@prismicio/client";

const client = createClient("example-prismic-repo");
await client.getByUID("page", "non-existent");
// => throws NotFoundError

Checklist:

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

🦁

prismicio / prismic-client

fix: throw `NotFoundError` when a document cannot be found #316

Types of changes

Description

Checklist:

Codecov Report