@library-pals/isbn 1.5.0 → 2.0.0

package/README.md

@@ -34,7 +34,7 @@ try {
 }
 ```
 
-### Setting a timeout
+### Setting request options
 
 ```javascript
 import Isbn from "@library-pals/isbn";
@@ -48,6 +48,25 @@ try {
 }
 ```
 
+### Using a Google Books API key
+
+The Google Books API has a shared anonymous quota that can be exhausted. To
+avoid `429` errors, pass your API key via `params`:
+
+```javascript
+import Isbn from "@library-pals/isbn";
+
+try {
+  const isbn = new Isbn();
+  const book = await isbn.resolve("9780374104092", {
+    params: { key: process.env.GOOGLE_BOOKS_API_KEY },
+  });
+  console.log("Book found %j", book);
+} catch (err) {
+  console.log("Book not found", err);
+}
+```
+
 ### Response
 
 Response follows the same schema, but some fields could depend on the service
@@ -69,12 +88,14 @@ information.
     "Fiction",
     "Fiction / General",
     "Fiction / Fantasy / General",
-    "Fiction / Horror",
+    "Fiction / Horror / General",
     "Fiction / Literary",
     "Fiction / Science Fiction / General",
     "Fiction / Science Fiction / Action & Adventure",
+    "Fiction / Science Fiction / Apocalyptic & Post-Apocalyptic",
     "Fiction / Thrillers / Suspense",
-    "Fiction / Dystopian"
+    "Fiction / Dystopian",
+    "Fiction / Nature & the Environment"
   ],
   "thumbnail": "http://books.google.com/books/publisher/content?id=2cl7AgAAQBAJ&printsec=frontcover&img=1&zoom=6&edge=curl&source=gbs_api",
   "link": "https://books.google.com/books/about/Annihilation.html?hl=&id=2cl7AgAAQBAJ",
@@ -141,10 +162,10 @@ information.
     "Ps3572.a4284 a84 2014",
     "813/.54"
   ],
-  "thumbnail": "https://covers.openlibrary.org/b/id/10520611-L.jpg",
-  "link": "https://openlibrary.org/books/OL31444108M",
-  "publisher": "Farrar, Straus and Giroux",
-  "publishedDate": "2014",
+  "thumbnail": "https://covers.openlibrary.org/b/id/12900600-L.jpg",
+  "link": "https://openlibrary.org/books/OL25841044M",
+  "publisher": "Farrar, Strauss and Giroux",
+  "publishedDate": "February 2, 2014",
   "language": "en",
   "isbn": "9780374104092",
   "bookProvider": "Open Library"
@@ -176,7 +197,7 @@ import Isbn from "@library-pals/isbn";
 try {
   const isbn = new Isbn();
   // This request will search ONLY in the Google Books API
-  isbn.provider( "google"]);
+  isbn.provider(["google"]);
   const book = await isbn.resolve("9780374104092");
   console.log("Book isbn:" + input + " found %j", book);
 } catch (err) {
@@ -209,3 +230,26 @@ try {
 See also
 [Google Books API Terms of Service](https://developers.google.com/books/terms),
 [Open Library Licensing](https://openlibrary.org/developers/licensing)
+
+## Development
+
+### Running tests
+
+Unit tests run without any API keys:
+
+```bash
+npm test
+```
+
+The end-to-end tests call the real Google Books API, which requires an API key
+to avoid `429` quota errors. Set `GOOGLE_BOOKS_API_KEY` before running:
+
+```bash
+GOOGLE_BOOKS_API_KEY=your_key npm test
+```
+
+To update snapshots after expected output changes:
+
+```bash
+GOOGLE_BOOKS_API_KEY=your_key npm test -- -u
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@library-pals/isbn",
-  "version": "1.5.0",
+  "version": "2.0.0",
   "description": "Find books by ISBN",
   "exports": {
     ".": {
@@ -11,10 +11,10 @@
   "types": "./types/index.d.ts",
   "type": "module",
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
-    "build": "tsc src/**/*.js --declaration --allowJs --emitDeclarationOnly --outDir types",
+    "build": "tsc",
     "prepack": "npm run build",
     "lint": "eslint .",
     "pretest": "npm run build && npm run lint",
@@ -36,19 +36,20 @@
   "author": "Katy DeCorah <@katydecorah>",
   "license": "AGPL-3.0-or-later",
   "devDependencies": {
-    "@eslint/js": "^9.26.0",
-    "eslint": "^9.26.0",
-    "eslint-plugin-jest": "^28.11.0",
-    "eslint-plugin-jsdoc": "^50.6.11",
-    "eslint-plugin-unicorn": "^59.0.0",
-    "globals": "^16.0.0",
-    "jest": "^29.7.0",
-    "prettier": "^3.5.3",
+    "@eslint/js": "^10.0.1",
+    "baseline-browser-mapping": "^2.10.40",
+    "eslint": "^10.6.0",
+    "eslint-plugin-jest": "^29.15.3",
+    "eslint-plugin-jsdoc": "^63.0.10",
+    "eslint-plugin-unicorn": "^69.0.0",
+    "globals": "^17.7.0",
+    "jest": "^30.4.2",
+    "prettier": "^3.9.3",
     "prettier-2": "npm:prettier@^2",
-    "typescript": "^5.8.3"
+    "typescript": "^6.0.3"
   },
   "dependencies": {
-    "axios": "^1.9.0"
+    "axios": "^1.18.1"
   },
   "bugs": {
     "url": "https://github.com/library-pals/isbn/issues"

package/src/index.js

@@ -31,7 +31,7 @@ export default class Isbn {
   /**
    * @type {Providers}
    */
-  _providers = DEFAULT_PROVIDERS;
+  #providers = DEFAULT_PROVIDERS;
 
   constructor() {
     this.PROVIDER_NAMES = PROVIDER_NAMES;
@@ -62,7 +62,7 @@ export default class Isbn {
       );
     }
 
-    this._providers = [...new Set(providers)];
+    this.#providers = [...new Set(providers)];
     return this;
   }
 
@@ -75,7 +75,7 @@ export default class Isbn {
    */
   async resolve(isbn, options = {}) {
     const messages = [];
-    for (const provider of this._providers) {
+    for (const provider of this.#providers) {
       try {
         return await PROVIDER_RESOLVERS[provider](isbn, options);
       } catch (error) {

package/src/provider-resolvers.js

@@ -21,6 +21,7 @@ export const GOOGLE_BOOKS_API_BOOK = "/books/v1/volumes";
 
 export const OPENLIBRARY_API_BASE = "https://openlibrary.org";
 export const OPENLIBRARY_API_BOOK = "/isbn";
+export const OPENLIBRARY_API_SEARCH = "/search.json";
 
 export const LIBROFM_API_BASE = "https://libro.fm";
 export const LIBROFM_API_BOOK = "/audiobooks";

package/src/providers/google.js

@@ -38,9 +38,9 @@ export async function resolveGoogle(isbn, options) {
       throw new Error(`No volume info found for book with isbn: ${isbn}`);
     }
     const book = books.items[0];
-    return await standardize(book.volumeInfo, book.id, isbn);
+    return await standardize(book.volumeInfo, book.id, isbn, requestOptions);
   } catch (error) {
-    throw new Error(error.message);
+    throw new Error(error.message, { cause: error });
   }
 }
 
@@ -88,11 +88,12 @@ export async function resolveGoogle(isbn, options) {
  * @param {GoogleBook} book - The book object to be standardized.
  * @param {string} id - The book id.
  * @param {string} isbn - The book's ISBN.
+ * @param {AxiosRequestConfig} [options] - Additional options for the API request.
  * @returns {Promise<Book>} The standardized book object.
  */
-export async function standardize(book, id, isbn) {
+export async function standardize(book, id, isbn, options = {}) {
   const { imageLinks = book.imageLinks, categories = book.categories } =
-    await getVolume(id);
+    await getVolume(id, options);
 
   const standardBook = {
     title: book.title,
@@ -116,13 +117,14 @@ export async function standardize(book, id, isbn) {
 /**
  * Retrieves the volume information for a book.
  * @param {string} id - The book id.
+ * @param {AxiosRequestConfig} [options] - Additional options for the API request.
  * @returns {Promise<{imageLinks?: ImageLinks, categories?: string[]}>} - A promise that resolves to an array of author names.
  * @throws {Error} - If there is an error retrieving the author information.
  */
-export async function getVolume(id) {
+export async function getVolume(id, options = {}) {
   try {
     const url = `${GOOGLE_BOOKS_API_BASE}${GOOGLE_BOOKS_API_BOOK}/${id}`;
-    const response = await axios.get(url);
+    const response = await axios.get(url, options);
 
     if (response.status !== 200) {
       throw new Error(`Unable to get volume ${id}: ${response.status}`);
@@ -131,7 +133,7 @@ export async function getVolume(id) {
       ...response.data.volumeInfo,
     };
   } catch (error) {
-    throw new Error(error.message);
+    throw new Error(error.message, { cause: error });
   }
 }
 
@@ -141,6 +143,8 @@ export async function getVolume(id) {
  * @returns {string|undefined} The URL of the largest thumbnail, or undefined if not found.
  */
 function getLargestThumbnail(imageLinks) {
+  if (!imageLinks) return;
+
   const sizes = [
     "extraLarge",
     "smallThumbnail",
@@ -150,9 +154,7 @@ function getLargestThumbnail(imageLinks) {
     "thumbnail",
   ];
 
-  if (!imageLinks) return;
-
-  const size = sizes.find((size) => size in imageLinks);
+  const size = sizes.find((size) => Object.hasOwn(imageLinks, size));
 
   // @ts-ignore
   return removeQueryParameter(imageLinks[size], "imgtk");
@@ -167,7 +169,7 @@ function getLargestThumbnail(imageLinks) {
 function removeQueryParameter(url, parameter) {
   const urlObject = new URL(url);
   urlObject.searchParams.delete(parameter);
-  return urlObject.toString();
+  return urlObject.href;
 }
 
 /**
@@ -180,6 +182,6 @@ function formatCategories(categories) {
 
   const [firstCategory] = categories;
   return firstCategory.includes("/")
-    ? [firstCategory.split("/")[0].trim(), ...categories]
+    ? [firstCategory.split("/", 1)[0].trim(), ...categories]
     : categories;
 }

package/src/providers/librofm.js

@@ -1,4 +1,8 @@
-import { LIBROFM_API_BASE, LIBROFM_API_BOOK } from "../provider-resolvers.js";
+import {
+  LIBROFM_API_BASE,
+  LIBROFM_API_BOOK,
+  defaultOptions,
+} from "../provider-resolvers.js";
 import axios from "axios";
 
 /**
@@ -9,20 +13,26 @@ import axios from "axios";
 /**
  * Resolves book information from Libro.fm using the provided ISBN.
  * @param {string} isbn - The ISBN of the book.
+ * @param {AxiosRequestConfig} options - Additional options for the API request.
  * @returns {Promise<Book>} The book information retrieved from the API.
  * @throws {Error} If the API response code is not 200, or if no books are found with the provided ISBN, or if no volume information is found for the book.
  */
-export async function resolveLibroFm(isbn) {
+export async function resolveLibroFm(isbn, options) {
+  const requestOptions = {
+    ...defaultOptions,
+    ...options,
+  };
+
   const url = `${LIBROFM_API_BASE}${LIBROFM_API_BOOK}/${isbn}`;
 
-  const response = await axios.get(url);
+  const response = await axios.get(url, requestOptions);
   try {
     if (response.status !== 200) {
       throw new Error(`Unable to get ${url}: ${response.status}`);
     }
     return standardize(response.data, isbn, url);
   } catch (error) {
-    throw new Error(error.message);
+    throw new Error(error.message, { cause: error });
   }
 }
 

package/src/providers/open-library.js

@@ -2,7 +2,7 @@ import axios from "axios";
 import {
   defaultOptions,
   OPENLIBRARY_API_BASE,
-  OPENLIBRARY_API_BOOK,
+  OPENLIBRARY_API_SEARCH,
 } from "../provider-resolvers.js";
 
 /**
@@ -10,8 +10,24 @@ import {
  * @typedef {import('axios').AxiosRequestConfig} AxiosRequestConfig
  */
 
+const SEARCH_FIELDS = [
+  "title",
+  "author_name",
+  "number_of_pages_median",
+  "subject",
+  "cover_i",
+  "key",
+  "editions",
+  "editions.key",
+  "editions.title",
+  "editions.cover_i",
+  "editions.publisher",
+  "editions.publish_date",
+  "editions.language",
+].join(",");
+
 /**
- * Resolves a book from the Open Library API using the provided ISBN.
+ * Resolves a book from the Open Library Search API using the provided ISBN.
  * @param {string} isbn - The ISBN of the book.
  * @param {AxiosRequestConfig} options - Additional options for the request.
  * @returns {Promise<Book>} A promise that resolves to the standardized book object.
@@ -22,234 +38,128 @@ export async function resolveOpenLibrary(isbn, options) {
     ...defaultOptions,
     ...options,
   };
-  const url = `${OPENLIBRARY_API_BASE}${OPENLIBRARY_API_BOOK}/${isbn}.json`;
+  const url = `${OPENLIBRARY_API_BASE}${OPENLIBRARY_API_SEARCH}`;
 
   try {
-    const response = await axios.get(url, requestOptions);
+    const response = await axios.get(url, {
+      timeout: requestOptions.timeout,
+      params: { isbn, fields: SEARCH_FIELDS, limit: 1 },
+    });
     if (response.status !== 200) {
       throw new Error(`Wrong response code: ${response.status}`);
     }
-    const book = response.data;
-    if (!book || Object.keys(book).length === 0) {
+    const { docs } = response.data;
+    if (!docs || docs.length === 0) {
       throw new Error(`No books found with ISBN: ${isbn}`);
     }
-    return await standardize(book, isbn);
+    const document = docs[0];
+    const description = document.key
+      ? await getDescription(document.key, requestOptions.timeout)
+      : "";
+    return standardize(document, isbn, description);
   } catch (error) {
-    throw new Error(error.message);
+    throw new Error(error.message, { cause: error });
   }
 }
 
 /**
- * @typedef {object} Author
- * @property {string} key - The key of the author.
- */
-
-/**
- * @typedef {object} Language
- * @property {string} key - The key of the language.
- */
-
-/**
- * @typedef {object} Type
- * @property {string} key - The key of the type.
- */
-
-/**
- * @typedef {object} FirstSentence
- * @property {string} type - The type of the first sentence.
- * @property {string} value - The value of the first sentence.
- */
-
-/**
- * @typedef {object} Work
- * @property {string} key - The key of the work.
- */
-
-/**
- * @typedef {object} DateTime
- * @property {string} type - The type of the datetime.
- * @property {string} value - The value of the datetime.
+ * @typedef {object} OpenLibraryEdition
+ * @property {string} key - Edition key.
+ * @property {string} [title] - Edition title.
+ * @property {number} [cover_i] - Edition cover image ID.
+ * @property {string[]} [publisher] - Publishers.
+ * @property {string[]} [publish_date] - Publish dates.
+ * @property {string[]} [language] - ISO 639-2 language codes.
  */
 
 /**
- * @typedef {object} OpenLibraryBook
- * @property {object} identifiers - The identifiers of the book.
- * @property {string} title - The title of the book.
- * @property {Author[]} authors - The authors of the book.
- * @property {string} publish_date - The publish date of the book.
- * @property {string[]} publishers - The publishers of the book.
- * @property {number[]} covers - The covers of the book.
- * @property {string[]} contributions - The contributions to the book.
- * @property {Language[]} languages - The languages of the book.
- * @property {string[]} source_records - The source records of the book.
- * @property {string[]} local_id - The local IDs of the book.
- * @property {Type} type - The type of the book.
- * @property {FirstSentence} first_sentence - The first sentence of the book.
- * @property {string} key - The key of the book.
- * @property {number} number_of_pages - The number of pages in the book.
- * @property {Work[]} works - The works related to the book.
- * @property {object} classifications - The classifications of the book.
- * @property {string} ocaid - The Open Content Alliance ID of the book.
- * @property {string[]} isbn_10 - The ISBN-10 of the book.
- * @property {string[]} isbn_13 - The ISBN-13 of the book.
- * @property {number} latest_revision - The latest revision of the book.
- * @property {number} revision - The revision of the book.
- * @property {DateTime} created - The creation datetime of the book.
- * @property {DateTime} last_modified - The last modified datetime of the book.
+ * @typedef {object} OpenLibrarySearchDoc
+ * @property {string} title - Work title.
+ * @property {string[]} [author_name] - Author names.
+ * @property {number} [number_of_pages_median] - Median page count.
+ * @property {string[]} [subject] - Subjects/categories.
+ * @property {number} [cover_i] - Work cover image ID.
+ * @property {string} key - Work key.
+ * @property {{docs: OpenLibraryEdition[]}} [editions] - Matched edition data.
  */
 
 /**
- * Standardizes a book object by extracting relevant information from the provided book object.
- * @param {OpenLibraryBook} book - The book object to be standardized.
- * @param {string} isbn - The book's isbn.
- * @returns {Promise<Book>} - The standardized book object.
+ * Standardizes a search result doc into a Book object.
+ * @param {OpenLibrarySearchDoc} document - The search result doc.
+ * @param {string} isbn - The book's ISBN.
+ * @param {string} [description] - The book's description.
+ * @returns {Book} The standardized book object.
  */
-export async function standardize(book, isbn) {
-  const { description, subjects, rawAuthors } = await getWorks(book);
-  const authors = await getAuthors(rawAuthors);
-  const standardBook = {
-    title: book.title,
-    authors,
-    description: handleDescription(description),
-    pageCount: book.number_of_pages,
+export function standardize(document, isbn, description = "") {
+  const edition = document.editions?.docs?.[0];
+  const coverId = edition?.cover_i || document.cover_i;
+  return {
+    title: edition?.title || document.title,
+    authors: document.author_name || [],
+    description,
+    pageCount: document.number_of_pages_median,
     format: "book",
-    categories: subjects,
-    thumbnail: `https://covers.openlibrary.org/b/id/${book.covers[0]}-L.jpg`,
-    link: book.key
-      ? `${OPENLIBRARY_API_BASE}${book.key}`
-      : `${OPENLIBRARY_API_BASE}${OPENLIBRARY_API_BOOK}/${isbn}`,
-    publisher: book.publishers?.join(", "),
-    publishedDate: book.publish_date,
-    language: formatLanguage(book.languages),
+    categories: document.subject || [],
+    thumbnail: coverId
+      ? `https://covers.openlibrary.org/b/id/${coverId}-L.jpg`
+      : undefined,
+    link: edition?.key
+      ? `${OPENLIBRARY_API_BASE}${edition.key}`
+      : (document.key
+        ? `${OPENLIBRARY_API_BASE}${document.key}`
+        : `${OPENLIBRARY_API_BASE}/isbn/${isbn}`),
+    publisher: edition?.publisher?.[0],
+    publishedDate: edition?.publish_date?.[0],
+    language: formatLanguage(edition?.language),
     isbn,
     bookProvider: "Open Library",
   };
-
-  return standardBook;
-}
-
-/**
- * Handles the description of the book.
- * @param {string|object} description - The description of the book.
- * @returns {string} - The processed description.
- */
-function handleDescription(description) {
-  if (typeof description === "string") {
-    return description;
-  }
-  return description.value;
-}
-
-/**
- * Retrieves the author names from OpenLibrary.
- * @param {{key: string}[]} rawAuthors - List of author keys.
- * @returns {Promise<string[]>} - List of author names.
- */
-export async function getAuthors(rawAuthors) {
-  const promises = rawAuthors
-    .filter((author) => author && author.key)
-    .map((author) =>
-      axios
-        .get(`https://openlibrary.org/${author.key}.json`)
-        .then((response) => {
-          if (response.status !== 200) {
-            throw new Error(
-              `Unable to get author ${author.key}: ${response.status}`,
-            );
-          }
-          return response.data && response.data.name;
-        }),
-    );
-
-  try {
-    return await Promise.all(promises);
-  } catch (error) {
-    throw new Error(error.message);
-  }
 }
 
 /**
- * @typedef {object} OpenLibraryResponse
- * @property {string} description - The description of the book.
- * @property {string[]} subjects - The subjects of the book.
- * @property {{author: {key: string}}[]} authors - The authors of the book.
+ * Fetches the description for a work from the Open Library works endpoint.
+ * @param {string} workKey - The work key (e.g. "/works/OL45804W").
+ * @param {number} [timeout] - Request timeout in milliseconds.
+ * @returns {Promise<string>} The description, or an empty string if unavailable.
  */
-
-/**
- * Retrieves the description of the book from OpenLibrary.
- * @param {OpenLibraryBook} book - The book object from OpenLibrary.
- * @returns {Promise<{description: string, subjects: string[], rawAuthors: {key: string}[]}>} - Description of the book.
- */
-export async function getWorks(book) {
-  const defaultResponse = {
-    description: "",
-    subjects: [],
-    rawAuthors: [],
-  };
-
-  if (!book.works) {
-    return defaultResponse;
-  }
-
-  const [work] = book.works;
-
-  if (!work || !work.key) {
-    return defaultResponse;
-  }
-
+export async function getDescription(workKey, timeout) {
   try {
-    const response = await axios.get(
-      `https://openlibrary.org/${work.key}.json`,
-    );
-
-    if (response.status !== 200) {
-      throw new Error(`Unable to get ${work.key}: ${response.status}`);
-    }
-
-    /** @type {OpenLibraryResponse} */
-    const data = response.data;
-
-    return {
-      description: data.description || "",
-      subjects: data.subjects || [],
-      rawAuthors: data.authors?.map((a) => a.author) || [],
-    };
-  } catch (error) {
-    throw new Error(error.message);
+    const response = await axios.get(`${OPENLIBRARY_API_BASE}${workKey}.json`, {
+      timeout,
+    });
+    if (response.status !== 200) return "";
+    const { description } = response.data;
+    if (!description) return "";
+    if (typeof description === "string") return description;
+    return description.value || "";
+  } catch {
+    return "";
   }
 }
 
 /**
- * Formats the language codes from Open Library API to their corresponding ISO 639-1 codes.
- * @param {Language[]} languages - An array of language codes from Open Library API.
- * @returns {string | undefined} - A new language map object with ISO 639-1 codes as keys and language codes as values.
+ * Formats ISO 639-2 language codes to ISO 639-1.
+ * @param {string[]} [languages] - Array of ISO 639-2 language codes.
+ * @returns {string | undefined} ISO 639-1 code, or undefined if not mapped.
  */
 function formatLanguage(languages) {
-  if (!languages || languages.length === 0) {
-    return;
-  }
-  /**
-   * Mapping of Open Library language codes to their corresponding language names.
-   * https://openlibrary.org/languages.json
-   * @type {{ [key: string]: string } } - A new language map object with ISO 639-1 codes as keys and language codes as values.
-   */
-  const newLanguageMap = {
-    "/languages/eng": "en",
-    "/languages/spa": "es",
-    "/languages/fre": "fr",
-    "/languages/ger": "de",
-    "/languages/rus": "ru",
-    "/languages/ita": "it",
-    "/languages/chi": "zh",
-    "/languages/jpn": "ja",
-    "/languages/por": "pt",
-    "/languages/ara": "ar",
-    "/languages/heb": "he",
-    "/languages/kor": "ko",
-    "/languages/pol": "pl",
-    "/languages/dut": "nl",
-    "/languages/lat": "la",
+  if (!languages || languages.length === 0) return;
+  const languageMap = {
+    eng: "en",
+    spa: "es",
+    fre: "fr",
+    ger: "de",
+    rus: "ru",
+    ita: "it",
+    chi: "zh",
+    jpn: "ja",
+    por: "pt",
+    ara: "ar",
+    heb: "he",
+    kor: "ko",
+    pol: "pl",
+    dut: "nl",
+    lat: "la",
   };
-
-  return newLanguageMap[languages[0].key] || undefined;
+  return languageMap[languages[0]] || undefined;
 }

package/types/index.d.ts

@@ -20,10 +20,6 @@
  * @typedef {import('axios').AxiosRequestConfig} AxiosRequestConfig
  */
 export default class Isbn {
-    /**
-     * @type {Providers}
-     */
-    _providers: Providers;
     PROVIDER_NAMES: {
         GOOGLE: string;
         OPENLIBRARY: string;
@@ -45,6 +41,7 @@ export default class Isbn {
      * @throws {Error} - If an error occurs while resolving the book information.
      */
     resolve(isbn: string, options?: AxiosRequestConfig): Promise<Book>;
+    #private;
 }
 export type Book = {
     /**
@@ -66,7 +63,7 @@ export type Book = {
     /**
      * - The number of pages in the book.
      */
-    pageCount?: number;
+    pageCount?: number | undefined;
     /**
      * - The format of the book.
      */
@@ -94,7 +91,7 @@ export type Book = {
     /**
      * - The link of the book.
      */
-    link?: string;
+    link?: string | undefined;
     /**
      * - The provider of the book information.
      */
@@ -102,7 +99,8 @@ export type Book = {
     /**
      * - The duration of the audiobook.
      */
-    duration?: string;
+    duration?: string | undefined;
 };
 export type Providers = import("./provider-resolvers.js").Providers;
 export type AxiosRequestConfig = import("axios").AxiosRequestConfig;
+//# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;GAGG;AAEH;IAOI;;;;MAAoC;IAGtC;;;;;;OAMG;IACH,oBALW,MAAM,EAAE,GACN,MAAM,CAwBlB;IAED;;;;;;OAMG;IACH,cALW,MAAM,YACN,kBAAkB,GAChB,OAAO,CAAC,IAAI,CAAC,CAkBzB;;CACF;;;;;UAnFa,MAAM;;;;WACN,MAAM;;;;aACN,MAAM,EAAE;;;;iBACR,MAAM;;;;;;;;YAEN,MAAM;;;;gBACN,MAAM,EAAE;;;;eACR,MAAM;;;;mBACN,MAAM;;;;eACN,MAAM,GAAG,SAAS;;;;gBAClB,MAAM,GAAG,SAAS;;;;;;;;kBAElB,MAAM;;;;;;wBAKP,OAAO,yBAAyB,EAAE,SAAS;iCAC3C,OAAO,OAAO,EAAE,kBAAkB"}

package/types/provider-resolvers.d.ts

@@ -12,6 +12,7 @@ export const GOOGLE_BOOKS_API_BASE: "https://www.googleapis.com";
 export const GOOGLE_BOOKS_API_BOOK: "/books/v1/volumes";
 export const OPENLIBRARY_API_BASE: "https://openlibrary.org";
 export const OPENLIBRARY_API_BOOK: "/isbn";
+export const OPENLIBRARY_API_SEARCH: "/search.json";
 export const LIBROFM_API_BASE: "https://libro.fm";
 export const LIBROFM_API_BOOK: "/audiobooks";
 export namespace PROVIDER_NAMES {
@@ -34,3 +35,4 @@ export type AxiosRequestConfig = import("axios").AxiosRequestConfig;
 import { resolveGoogle } from "./providers/google.js";
 import { resolveOpenLibrary } from "./providers/open-library.js";
 import { resolveLibroFm } from "./providers/librofm.js";
+//# sourceMappingURL=provider-resolvers.d.ts.map

package/types/provider-resolvers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-resolvers.d.ts","sourceRoot":"","sources":["../src/provider-resolvers.js"],"names":[],"mappings":"AAIA;;;GAGG;AAEH;;;;GAIG;AACH,6BAHU,kBAAkB,CAK1B;AAEF,oCAAqC,4BAA4B,CAAC;AAClE,oCAAqC,mBAAmB,CAAC;AAEzD,mCAAoC,yBAAyB,CAAC;AAC9D,mCAAoC,OAAO,CAAC;AAC5C,qCAAsC,cAAc,CAAC;AAErD,+BAAgC,kBAAkB,CAAC;AACnD,+BAAgC,aAAa,CAAC;;;;;;AAQ9C;;;GAGG;AACH,gCAFU,SAAS,CAMjB;AAEF;IACE,CAAC,cAAc,CAAC,MAAM,CAAC,uBAAe;IACtC,CAAC,cAAc,CAAC,WAAW,CAAC,4BAAoB;IAChD,CAAC,cAAc,CAAC,OAAO,CAAC,wBAAgB;EACxC;wBA3CW,MAAM,EAAE;iCACR,OAAO,OAAO,EAAE,kBAAkB;8BANjB,uBAAuB;mCAClB,6BAA6B;+BACjC,wBAAwB"}

package/types/providers/google.d.ts

@@ -52,16 +52,18 @@ export function resolveGoogle(isbn: string, options: AxiosRequestConfig): Promis
  * @param {GoogleBook} book - The book object to be standardized.
  * @param {string} id - The book id.
  * @param {string} isbn - The book's ISBN.
+ * @param {AxiosRequestConfig} [options] - Additional options for the API request.
  * @returns {Promise<Book>} The standardized book object.
  */
-export function standardize(book: GoogleBook, id: string, isbn: string): Promise<Book>;
+export function standardize(book: GoogleBook, id: string, isbn: string, options?: AxiosRequestConfig): Promise<Book>;
 /**
  * Retrieves the volume information for a book.
  * @param {string} id - The book id.
+ * @param {AxiosRequestConfig} [options] - Additional options for the API request.
  * @returns {Promise<{imageLinks?: ImageLinks, categories?: string[]}>} - A promise that resolves to an array of author names.
  * @throws {Error} - If there is an error retrieving the author information.
  */
-export function getVolume(id: string): Promise<{
+export function getVolume(id: string, options?: AxiosRequestConfig): Promise<{
     imageLinks?: ImageLinks;
     categories?: string[];
 }>;
@@ -71,27 +73,27 @@ export type ImageLinks = {
     /**
      * - extraLarge
      */
-    extraLarge?: string;
+    extraLarge?: string | undefined;
     /**
      * - large
      */
-    large?: string;
+    large?: string | undefined;
     /**
      * - medium
      */
-    medium?: string;
+    medium?: string | undefined;
     /**
      * - small
      */
-    small?: string;
+    small?: string | undefined;
     /**
      * - thumbnail
      */
-    thumbnail?: string;
+    thumbnail?: string | undefined;
     /**
      * - smallThumbnail
      */
-    smallThumbnail?: string;
+    smallThumbnail?: string | undefined;
 };
 export type GoogleBook = {
     /**
@@ -165,7 +167,7 @@ export type GoogleBook = {
     /**
      * - The image links of the book.
      */
-    imageLinks?: ImageLinks;
+    imageLinks?: ImageLinks | undefined;
     /**
      * - The language of the book.
      */
@@ -195,3 +197,4 @@ export type GoogleBook = {
      */
     searchInfo: object;
 };
+//# sourceMappingURL=google.d.ts.map

package/types/providers/google.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/providers/google.js"],"names":[],"mappings":"AAOA;;;GAGG;AAEH;;;;;;GAMG;AACH,oCALW,MAAM,WACN,kBAAkB,GAChB,OAAO,CAAC,IAAI,CAAC,CA4BzB;AAED;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;;;;;;;GAOG;AACH,kCANW,UAAU,MACV,MAAM,QACN,MAAM,YACN,kBAAkB,GAChB,OAAO,CAAC,IAAI,CAAC,CAuBzB;AAED;;;;;;GAMG;AACH,8BALW,MAAM,YACN,kBAAkB,GAChB,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CAiBrE;mBAjIY,OAAO,aAAa,EAAE,IAAI;iCAC1B,OAAO,OAAO,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAiDjC,MAAM;;;;cACN,MAAM;;;;aACN,MAAM,EAAE;;;;eACR,MAAM;;;;mBACN,MAAM;;;;iBACN,MAAM;;;;yBACN,MAAM,EAAE;;;;kBACR,MAAM;;;;eACN,MAAM;;;;eACN,MAAM;;;;gBACN,MAAM,EAAE;;;;mBACR,MAAM;;;;kBACN,MAAM;;;;oBACN,MAAM;;;;sBACN,OAAO;;;;oBACP,MAAM;;;;yBACN,MAAM;;;;;;;;cAEN,MAAM;;;;iBACN,MAAM;;;;cACN,MAAM;;;;yBACN,MAAM;;;;cACN,MAAM;;;;gBACN,MAAM;;;;gBACN,MAAM"}

package/types/providers/librofm.d.ts

@@ -5,10 +5,11 @@
 /**
  * Resolves book information from Libro.fm using the provided ISBN.
  * @param {string} isbn - The ISBN of the book.
+ * @param {AxiosRequestConfig} options - Additional options for the API request.
  * @returns {Promise<Book>} The book information retrieved from the API.
  * @throws {Error} If the API response code is not 200, or if no books are found with the provided ISBN, or if no volume information is found for the book.
  */
-export function resolveLibroFm(isbn: string): Promise<Book>;
+export function resolveLibroFm(isbn: string, options: AxiosRequestConfig): Promise<Book>;
 /**
  * Standardizes a book object by extracting relevant information from the provided book object.
  * @param {string} data - The data to be standardized.
@@ -120,3 +121,4 @@ export type Audiobook = {
      */
     workExample: object;
 };
+//# sourceMappingURL=librofm.d.ts.map

package/types/providers/librofm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"librofm.d.ts","sourceRoot":"","sources":["../../src/providers/librofm.js"],"names":[],"mappings":"AAOA;;;GAGG;AAEH;;;;;;GAMG;AACH,qCALW,MAAM,WACN,kBAAkB,GAChB,OAAO,CAAC,IAAI,CAAC,CAoBzB;AAED;;;;;;GAMG;AACH,kCALW,MAAM,QACN,MAAM,OACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAiCzB;AAED;;;GAGG;AACH;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;GAIG;AACH,+CAHW,MAAM,GACJ,MAAM,CAiBlB;mBAlHY,OAAO,aAAa,EAAE,IAAI;iCAC1B,OAAO,OAAO,EAAE,kBAAkB;;;;;UAuEjC,MAAM;;;;;;SAIN,MAAM;;;;gBACN,MAAM;;;;UACN,MAAM;;;;iBACN,MAAM;;;;UACN,MAAM;;;;WACN,MAAM;;;;cACN,MAAM;;;;YACN,MAAM,EAAE;;;;YACR,MAAM,EAAE;;;;eACR,MAAM;;;;mBACN,MAAM;;;;gBACN,MAAM;;;;cACN,MAAM;;;;oBACN,MAAM,EAAE;;;;YACR,MAAM;;;;iBACN,MAAM"}

package/types/providers/open-library.d.ts

@@ -1,9 +1,5 @@
 /**
- * @typedef {import('../index.js').Book} Book
- * @typedef {import('axios').AxiosRequestConfig} AxiosRequestConfig
- */
-/**
- * Resolves a book from the Open Library API using the provided ISBN.
+ * Resolves a book from the Open Library Search API using the provided ISBN.
  * @param {string} isbn - The ISBN of the book.
  * @param {AxiosRequestConfig} options - Additional options for the request.
  * @returns {Promise<Book>} A promise that resolves to the standardized book object.
@@ -11,245 +7,97 @@
  */
 export function resolveOpenLibrary(isbn: string, options: AxiosRequestConfig): Promise<Book>;
 /**
- * @typedef {object} Author
- * @property {string} key - The key of the author.
- */
-/**
- * @typedef {object} Language
- * @property {string} key - The key of the language.
- */
-/**
- * @typedef {object} Type
- * @property {string} key - The key of the type.
- */
-/**
- * @typedef {object} FirstSentence
- * @property {string} type - The type of the first sentence.
- * @property {string} value - The value of the first sentence.
- */
-/**
- * @typedef {object} Work
- * @property {string} key - The key of the work.
- */
-/**
- * @typedef {object} DateTime
- * @property {string} type - The type of the datetime.
- * @property {string} value - The value of the datetime.
+ * @typedef {object} OpenLibraryEdition
+ * @property {string} key - Edition key.
+ * @property {string} [title] - Edition title.
+ * @property {number} [cover_i] - Edition cover image ID.
+ * @property {string[]} [publisher] - Publishers.
+ * @property {string[]} [publish_date] - Publish dates.
+ * @property {string[]} [language] - ISO 639-2 language codes.
  */
 /**
- * @typedef {object} OpenLibraryBook
- * @property {object} identifiers - The identifiers of the book.
- * @property {string} title - The title of the book.
- * @property {Author[]} authors - The authors of the book.
- * @property {string} publish_date - The publish date of the book.
- * @property {string[]} publishers - The publishers of the book.
- * @property {number[]} covers - The covers of the book.
- * @property {string[]} contributions - The contributions to the book.
- * @property {Language[]} languages - The languages of the book.
- * @property {string[]} source_records - The source records of the book.
- * @property {string[]} local_id - The local IDs of the book.
- * @property {Type} type - The type of the book.
- * @property {FirstSentence} first_sentence - The first sentence of the book.
- * @property {string} key - The key of the book.
- * @property {number} number_of_pages - The number of pages in the book.
- * @property {Work[]} works - The works related to the book.
- * @property {object} classifications - The classifications of the book.
- * @property {string} ocaid - The Open Content Alliance ID of the book.
- * @property {string[]} isbn_10 - The ISBN-10 of the book.
- * @property {string[]} isbn_13 - The ISBN-13 of the book.
- * @property {number} latest_revision - The latest revision of the book.
- * @property {number} revision - The revision of the book.
- * @property {DateTime} created - The creation datetime of the book.
- * @property {DateTime} last_modified - The last modified datetime of the book.
+ * @typedef {object} OpenLibrarySearchDoc
+ * @property {string} title - Work title.
+ * @property {string[]} [author_name] - Author names.
+ * @property {number} [number_of_pages_median] - Median page count.
+ * @property {string[]} [subject] - Subjects/categories.
+ * @property {number} [cover_i] - Work cover image ID.
+ * @property {string} key - Work key.
+ * @property {{docs: OpenLibraryEdition[]}} [editions] - Matched edition data.
  */
 /**
- * Standardizes a book object by extracting relevant information from the provided book object.
- * @param {OpenLibraryBook} book - The book object to be standardized.
- * @param {string} isbn - The book's isbn.
- * @returns {Promise<Book>} - The standardized book object.
+ * Standardizes a search result doc into a Book object.
+ * @param {OpenLibrarySearchDoc} document - The search result doc.
+ * @param {string} isbn - The book's ISBN.
+ * @param {string} [description] - The book's description.
+ * @returns {Book} The standardized book object.
  */
-export function standardize(book: OpenLibraryBook, isbn: string): Promise<Book>;
+export function standardize(document: OpenLibrarySearchDoc, isbn: string, description?: string): Book;
 /**
- * Retrieves the author names from OpenLibrary.
- * @param {{key: string}[]} rawAuthors - List of author keys.
- * @returns {Promise<string[]>} - List of author names.
+ * Fetches the description for a work from the Open Library works endpoint.
+ * @param {string} workKey - The work key (e.g. "/works/OL45804W").
+ * @param {number} [timeout] - Request timeout in milliseconds.
+ * @returns {Promise<string>} The description, or an empty string if unavailable.
  */
-export function getAuthors(rawAuthors: {
-    key: string;
-}[]): Promise<string[]>;
-/**
- * @typedef {object} OpenLibraryResponse
- * @property {string} description - The description of the book.
- * @property {string[]} subjects - The subjects of the book.
- * @property {{author: {key: string}}[]} authors - The authors of the book.
- */
-/**
- * Retrieves the description of the book from OpenLibrary.
- * @param {OpenLibraryBook} book - The book object from OpenLibrary.
- * @returns {Promise<{description: string, subjects: string[], rawAuthors: {key: string}[]}>} - Description of the book.
- */
-export function getWorks(book: OpenLibraryBook): Promise<{
-    description: string;
-    subjects: string[];
-    rawAuthors: {
-        key: string;
-    }[];
-}>;
-export type Book = import("../index.js").Book;
-export type AxiosRequestConfig = import("axios").AxiosRequestConfig;
-export type Author = {
-    /**
-     * - The key of the author.
-     */
-    key: string;
-};
-export type Language = {
-    /**
-     * - The key of the language.
-     */
-    key: string;
-};
-export type Type = {
+export function getDescription(workKey: string, timeout?: number): Promise<string>;
+export type OpenLibraryEdition = {
     /**
-     * - The key of the type.
+     * - Edition key.
      */
     key: string;
-};
-export type FirstSentence = {
     /**
-     * - The type of the first sentence.
+     * - Edition title.
      */
-    type: string;
+    title?: string | undefined;
     /**
-     * - The value of the first sentence.
+     * - Edition cover image ID.
      */
-    value: string;
-};
-export type Work = {
+    cover_i?: number | undefined;
     /**
-     * - The key of the work.
+     * - Publishers.
      */
-    key: string;
-};
-export type DateTime = {
+    publisher?: string[] | undefined;
     /**
-     * - The type of the datetime.
+     * - Publish dates.
      */
-    type: string;
+    publish_date?: string[] | undefined;
     /**
-     * - The value of the datetime.
+     * - ISO 639-2 language codes.
      */
-    value: string;
+    language?: string[] | undefined;
 };
-export type OpenLibraryBook = {
+export type OpenLibrarySearchDoc = {
     /**
-     * - The identifiers of the book.
-     */
-    identifiers: object;
-    /**
-     * - The title of the book.
+     * - Work title.
      */
     title: string;
     /**
-     * - The authors of the book.
-     */
-    authors: Author[];
-    /**
-     * - The publish date of the book.
-     */
-    publish_date: string;
-    /**
-     * - The publishers of the book.
-     */
-    publishers: string[];
-    /**
-     * - The covers of the book.
-     */
-    covers: number[];
-    /**
-     * - The contributions to the book.
-     */
-    contributions: string[];
-    /**
-     * - The languages of the book.
-     */
-    languages: Language[];
-    /**
-     * - The source records of the book.
+     * - Author names.
      */
-    source_records: string[];
+    author_name?: string[] | undefined;
     /**
-     * - The local IDs of the book.
+     * - Median page count.
      */
-    local_id: string[];
+    number_of_pages_median?: number | undefined;
     /**
-     * - The type of the book.
+     * - Subjects/categories.
      */
-    type: Type;
+    subject?: string[] | undefined;
     /**
-     * - The first sentence of the book.
+     * - Work cover image ID.
      */
-    first_sentence: FirstSentence;
+    cover_i?: number | undefined;
     /**
-     * - The key of the book.
+     * - Work key.
      */
     key: string;
     /**
-     * - The number of pages in the book.
-     */
-    number_of_pages: number;
-    /**
-     * - The works related to the book.
-     */
-    works: Work[];
-    /**
-     * - The classifications of the book.
-     */
-    classifications: object;
-    /**
-     * - The Open Content Alliance ID of the book.
-     */
-    ocaid: string;
-    /**
-     * - The ISBN-10 of the book.
-     */
-    isbn_10: string[];
-    /**
-     * - The ISBN-13 of the book.
-     */
-    isbn_13: string[];
-    /**
-     * - The latest revision of the book.
-     */
-    latest_revision: number;
-    /**
-     * - The revision of the book.
-     */
-    revision: number;
-    /**
-     * - The creation datetime of the book.
-     */
-    created: DateTime;
-    /**
-     * - The last modified datetime of the book.
+     * - Matched edition data.
      */
-    last_modified: DateTime;
-};
-export type OpenLibraryResponse = {
-    /**
-     * - The description of the book.
-     */
-    description: string;
-    /**
-     * - The subjects of the book.
-     */
-    subjects: string[];
-    /**
-     * - The authors of the book.
-     */
-    authors: {
-        author: {
-            key: string;
-        };
-    }[];
+    editions?: {
+        docs: OpenLibraryEdition[];
+    } | undefined;
 };
+export type Book = import("../index.js").Book;
+export type AxiosRequestConfig = import("axios").AxiosRequestConfig;
+//# sourceMappingURL=open-library.d.ts.map

package/types/providers/open-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-library.d.ts","sourceRoot":"","sources":["../../src/providers/open-library.js"],"names":[],"mappings":"AA4BA;;;;;;GAMG;AACH,yCALW,MAAM,WACN,kBAAkB,GAChB,OAAO,CAAC,IAAI,CAAC,CA8BzB;AAED;;;;;;;;GAQG;AAEH;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,sCALW,oBAAoB,QACpB,MAAM,gBACN,MAAM,GACJ,IAAI,CA0BhB;AAED;;;;;GAKG;AACH,wCAJW,MAAM,YACN,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAe3B;;;;;SAvEa,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;WAUN,MAAM;;;;;;;;;;;;;;;;;;;;SAKN,MAAM;;;;;cACC,kBAAkB,EAAE;;;mBA1E5B,OAAO,aAAa,EAAE,IAAI;iCAC1B,OAAO,OAAO,EAAE,kBAAkB"}