@library-pals/isbn 0.2.0 → 1.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["google.js"],"names":[],"mappings":"AAOA;;;GAGG;AAEH;;;;;;GAMG;AACH,oCALW,MAAM,WACN,kBAAkB,GAChB,QAAQ,IAAI,CAAC,CA4BzB;AAED;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;;;;;GAKG;AACH,kCAJW,UAAU,QACV,MAAM,GACJ,IAAI,CAgBhB;mBAjGY,OAAO,aAAa,EAAE,IAAI;iCAC1B,OAAO,OAAO,EAAE,kBAAkB;;;;;iBAuCjC,MAAM;;;;YACN,MAAM;;;;aACN,MAAM;;;;YACN,MAAM;;;;gBACN,MAAM;;;;qBACN,MAAM;;;;;;WAKN,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;;;;iBACN,UAAU;;;;cACV,MAAM;;;;iBACN,MAAM;;;;cACN,MAAM;;;;yBACN,MAAM;;;;cACN,MAAM;;;;gBACN,MAAM;;;;gBACN,MAAM"}

package/src/providers/google.js

@@ -5,32 +5,127 @@ import {
   GOOGLE_BOOKS_API_BOOK,
 } from "../provider-resolvers.js";
 
+/**
+ * @typedef {import('../index.js').Book} Book
+ * @typedef {import('axios').AxiosRequestConfig} AxiosRequestConfig
+ */
+
 /**
  * Resolves book information from Google Books API using the provided ISBN.
  * @param {string} isbn - The ISBN of the book.
- * @param {object} options - Additional options for the API request.
- * @returns {Promise<object>} The book information retrieved from the API.
+ * @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 resolveGoogle(isbn, options) {
   const requestOptions = {
     ...defaultOptions,
     ...options,
-    url: `${GOOGLE_BOOKS_API_BASE}${GOOGLE_BOOKS_API_BOOK}?q=isbn:${isbn}`,
   };
+  const url = `${GOOGLE_BOOKS_API_BASE}${GOOGLE_BOOKS_API_BOOK}?q=isbn:${isbn}`;
 
-  const { status, data } = await axios.request(requestOptions);
-  if (status !== 200) {
-    throw new Error(`wrong response code: ${status}`);
+  try {
+    const response = await axios.get(url, requestOptions);
+    if (response.status !== 200) {
+      throw new Error(`Wrong response code: ${response.status}`);
+    }
+    const books = response.data;
+    if (!books.totalItems) {
+      throw new Error(`No books found with isbn: ${isbn}`);
+    }
+    // In very rare circumstances books.items[0] is undefined (see #2)
+    if (!books.items || books.items.length === 0) {
+      throw new Error(`No volume info found for book with isbn: ${isbn}`);
+    }
+    const book = books.items[0];
+    return standardize(book.volumeInfo, isbn);
+  } catch (error) {
+    throw new Error(error.message);
   }
-  const books = data;
-  if (!books.totalItems) {
-    throw new Error(`no books found with isbn: ${isbn}`);
-  }
-  // In very rare circumstances books.items[0] is undefined (see #2)
-  if (!books.items || books.items.length === 0) {
-    throw new Error(`no volume info found for book with isbn: ${isbn}`);
+}
+
+/**
+ * @typedef {object} ImageLinks
+ * @property {string} [extraLarge] - extraLarge
+ * @property {string} [large] - large
+ * @property {string} [medium] - medium
+ * @property {string} [small] - small
+ * @property {string} [thumbnail] - thumbnail
+ * @property {string} [smallThumbnail] - smallThumbnail
+ */
+
+/**
+ * @typedef {object} GoogleBook
+ * @property {string} title - The title of the book.
+ * @property {string} subtitle - The subtitle of the book.
+ * @property {string[]} authors - The authors of the book.
+ * @property {string} publisher - The publisher of the book.
+ * @property {string} publishedDate - The published date of the book.
+ * @property {string} description - The description of the book.
+ * @property {object[]} industryIdentifiers - The industry identifiers of the book.
+ * @property {object} readingModes - The reading modes of the book.
+ * @property {number} pageCount - The number of pages in the book.
+ * @property {string} printType - The print type of the book.
+ * @property {string[]} categories - The categories of the book.
+ * @property {number} averageRating - The average rating of the book.
+ * @property {number} ratingsCount - The ratings count of the book.
+ * @property {string} maturityRating - The maturity rating of the book.
+ * @property {boolean} allowAnonLogging - The allow anon logging of the book.
+ * @property {string} contentVersion - The content version of the book.
+ * @property {object} panelizationSummary - The panelization summary of the book.
+ * @property {ImageLinks} [imageLinks] - The image links of the book.
+ * @property {string} language - The language of the book.
+ * @property {string} previewLink - The preview link of the book.
+ * @property {string} infoLink - The info link of the book.
+ * @property {string} canonicalVolumeLink - The canonical volume link of the book.
+ * @property {object} saleInfo - The sale info of the book.
+ * @property {object} accessInfo - The access info of the book.
+ * @property {object} searchInfo - The search info of the book.
+ */
+
+/**
+ * Standardizes a book object by extracting relevant information from the provided book object.
+ * @param {GoogleBook} book - The book object to be standardized.
+ * @param {string} isbn - The book's ISBN.
+ * @returns {Book} The standardized book object.
+ */
+export function standardize(book, isbn) {
+  const standardBook = {
+    title: book.title,
+    authors: book.authors,
+    description: book.description,
+    pageCount: book.pageCount,
+    printType: book.printType,
+    categories: book.categories,
+    thumbnail: getLargestThumbnail(book.imageLinks),
+    link: book.canonicalVolumeLink,
+    isbn,
+  };
+
+  return standardBook;
+}
+
+/**
+ * Get the largest available thumbnail from a book's image links.
+ * @param {ImageLinks} [imageLinks] - The image links object.
+ * @returns {string|undefined} The URL of the largest thumbnail, or undefined if not found.
+ */
+function getLargestThumbnail(imageLinks) {
+  const sizes = [
+    "extraLarge",
+    "large",
+    "medium",
+    "small",
+    "thumbnail",
+    "smallThumbnail",
+  ];
+
+  if (!imageLinks) return;
+
+  for (const size of sizes) {
+    if (size in imageLinks) {
+      // @ts-ignore
+      return imageLinks[size];
+    }
   }
-  const book = books.items[0].volumeInfo;
-  return book;
 }

package/src/providers/isbndb.d.ts

@@ -0,0 +1,184 @@
+/**
+ * @typedef {import('../index.js').Book} Book
+ * @typedef {import('axios').AxiosRequestConfig} AxiosRequestConfig
+ */
+/**
+ * Resolves the ISBN using the ISBNdb API.
+ * @param {string} isbn - The ISBN to resolve.
+ * @param {AxiosRequestConfig} options - Additional options for the request.
+ * @returns {Promise<Book>} - A promise that resolves to the standardized book data.
+ * @throws {Error} - If the response code is not 200 or if no books are found with the given ISBN.
+ */
+export function resolveIsbnDb(isbn: string, options: AxiosRequestConfig): Promise<Book>;
+export type Book = import('../index.js').Book;
+export type AxiosRequestConfig = import('axios').AxiosRequestConfig;
+export type Dimension = {
+    /**
+     * - The unit of the dimension.
+     */
+    unit: string;
+    /**
+     * - The value of the dimension.
+     */
+    value: number;
+};
+export type Offset = {
+    /**
+     * - The x offset.
+     */
+    x: string;
+    /**
+     * - The y offset.
+     */
+    y: string;
+};
+export type Price = {
+    /**
+     * - The condition of the book.
+     */
+    condition: string;
+    /**
+     * - The merchant selling the book.
+     */
+    merchant: string;
+    /**
+     * - The logo of the merchant.
+     */
+    merchant_logo: string;
+    /**
+     * - The offset of the merchant logo.
+     */
+    merchant_logo_offset: Offset;
+    /**
+     * - The shipping cost.
+     */
+    shipping: string;
+    /**
+     * - The price of the book.
+     */
+    price: string;
+    /**
+     * - The total cost.
+     */
+    total: string;
+    /**
+     * - The link to buy the book.
+     */
+    link: string;
+};
+export type OtherIsbn = {
+    /**
+     * - The ISBN of the book.
+     */
+    isbn: string;
+    /**
+     * - The binding of the book.
+     */
+    binding: string;
+};
+export type IsbnDbBook = {
+    /**
+     * - The title of the book.
+     */
+    title: string;
+    /**
+     * - The long title of the book.
+     */
+    title_long: string;
+    /**
+     * - The ISBN of the book.
+     */
+    isbn: string;
+    /**
+     * - The ISBN13 of the book.
+     */
+    isbn13: string;
+    /**
+     * - The Dewey Decimal classification of the book.
+     */
+    dewey_decimal: string;
+    /**
+     * - The binding of the book.
+     */
+    binding: string;
+    /**
+     * - The publisher of the book.
+     */
+    publisher: string;
+    /**
+     * - The language of the book.
+     */
+    language: string;
+    /**
+     * - The published date of the book.
+     */
+    date_published: string;
+    /**
+     * - The edition of the book.
+     */
+    edition: string;
+    /**
+     * - The number of pages in the book.
+     */
+    pages: number;
+    /**
+     * - The dimensions of the book.
+     */
+    dimensions: string;
+    /**
+     * - The structured dimensions of the book.
+     */
+    dimensions_structured: {
+        length: Dimension;
+        width: Dimension;
+        height: Dimension;
+        weight: Dimension;
+    };
+    /**
+     * - The overview of the book.
+     */
+    overview: string;
+    /**
+     * - The image link of the book.
+     */
+    image: string;
+    /**
+     * - The manufacturer's suggested retail price of the book.
+     */
+    msrp: number;
+    /**
+     * - The excerpt of the book.
+     */
+    excerpt: string;
+    /**
+     * - The synopsis of the book.
+     */
+    synopsis: string;
+    /**
+     * - The authors of the book.
+     */
+    authors: string[];
+    /**
+     * - The subjects or categories of the book.
+     */
+    subjects: string[];
+    /**
+     * - The reviews of the book.
+     */
+    reviews: string[];
+    /**
+     * - The prices of the book.
+     */
+    prices: Price[];
+    /**
+     * - The related books.
+     */
+    related: {
+        type: string;
+    };
+    /**
+     * - The other ISBNs of the book.
+     */
+    other_isbns: OtherIsbn[];
+};
+//# sourceMappingURL=isbndb.d.ts.map

package/src/providers/isbndb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isbndb.d.ts","sourceRoot":"","sources":["isbndb.js"],"names":[],"mappings":"AAOA;;;GAGG;AAEH;;;;;;GAMG;AACH,oCALW,MAAM,WACN,kBAAkB,GAChB,QAAQ,IAAI,CAAC,CA6BzB;mBArCY,OAAO,aAAa,EAAE,IAAI;iCAC1B,OAAO,OAAO,EAAE,kBAAkB;;;;;UAwCjC,MAAM;;;;WACN,MAAM;;;;;;OAKN,MAAM;;;;OACN,MAAM;;;;;;eAKN,MAAM;;;;cACN,MAAM;;;;mBACN,MAAM;;;;0BACN,MAAM;;;;cACN,MAAM;;;;WACN,MAAM;;;;WACN,MAAM;;;;UACN,MAAM;;;;;;UAKN,MAAM;;;;aACN,MAAM;;;;;;WAKN,MAAM;;;;gBACN,MAAM;;;;UACN,MAAM;;;;YACN,MAAM;;;;mBACN,MAAM;;;;aACN,MAAM;;;;eACN,MAAM;;;;cACN,MAAM;;;;oBACN,MAAM;;;;aACN,MAAM;;;;WACN,MAAM;;;;gBACN,MAAM;;;;;QAE2B,MAAM,EAAvC,SAAS;QACwB,KAAK,EAAtC,SAAS;QACwB,MAAM,EAAvC,SAAS;QACwB,MAAM,EAAvC,SAAS;;;;;cACT,MAAM;;;;WACN,MAAM;;;;UACN,MAAM;;;;aACN,MAAM;;;;cACN,MAAM;;;;aACN,MAAM,EAAE;;;;cACR,MAAM,EAAE;;;;aACR,MAAM,EAAE;;;;YACR,KAAK,EAAE;;;;;QAES,IAAI,EAApB,MAAM;;;;;iBACN,SAAS,EAAE"}

package/src/providers/isbndb.js

@@ -5,56 +5,124 @@ import {
   ISBNDB_API_BOOK,
 } from "../provider-resolvers.js";
 
+/**
+ * @typedef {import('../index.js').Book} Book
+ * @typedef {import('axios').AxiosRequestConfig} AxiosRequestConfig
+ */
+
 /**
  * Resolves the ISBN using the ISBNdb API.
  * @param {string} isbn - The ISBN to resolve.
- * @param {object} options - Additional options for the request.
- * @returns {Promise<object>} - A promise that resolves to the standardized book data.
+ * @param {AxiosRequestConfig} options - Additional options for the request.
+ * @returns {Promise<Book>} - A promise that resolves to the standardized book data.
  * @throws {Error} - If the response code is not 200 or if no books are found with the given ISBN.
  */
 export async function resolveIsbnDb(isbn, options) {
+  if (!process.env.ISBNDB_API_KEY) {
+    throw new Error(`ISBNdb requires an API key`);
+  }
+
   const requestOptions = {
     ...defaultOptions,
     ...options,
-    url: `${ISBNDB_API_BASE}${ISBNDB_API_BOOK}/${isbn}`,
-    headers: { Authorization: process.env.ISBNDB_API_KEY || "" },
+    headers: { Authorization: process.env.ISBNDB_API_KEY },
   };
 
-  const { status, data } = await axios.request(requestOptions);
-  if (status !== 200) {
-    throw new Error(
-      `Wrong response code: ${status}. Response data: ${JSON.stringify(data)}`
-    );
-  }
-  const books = data;
-  if (!books.book) {
-    throw new Error(`No books found with ISBN: ${isbn}`);
+  const url = `${ISBNDB_API_BASE}${ISBNDB_API_BOOK}/${isbn}`;
+
+  try {
+    const response = await axios.get(url, requestOptions);
+    if (response.status !== 200) {
+      throw new Error(`Wrong response code: ${response.status}`);
+    }
+    const books = response.data;
+    if (!books.book) {
+      throw new Error(`No books found with ISBN: ${isbn}`);
+    }
+    return standardize(books.book, isbn);
+  } catch (error) {
+    throw new Error(error.message);
   }
-  return standardize(books.book);
 }
 
+/**
+ * @typedef {object} Dimension
+ * @property {string} unit - The unit of the dimension.
+ * @property {number} value - The value of the dimension.
+ */
+
+/**
+ * @typedef {object} Offset
+ * @property {string} x - The x offset.
+ * @property {string} y - The y offset.
+ */
+
+/**
+ * @typedef {object} Price
+ * @property {string} condition - The condition of the book.
+ * @property {string} merchant - The merchant selling the book.
+ * @property {string} merchant_logo - The logo of the merchant.
+ * @property {Offset} merchant_logo_offset - The offset of the merchant logo.
+ * @property {string} shipping - The shipping cost.
+ * @property {string} price - The price of the book.
+ * @property {string} total - The total cost.
+ * @property {string} link - The link to buy the book.
+ */
+
+/**
+ * @typedef {object} OtherIsbn
+ * @property {string} isbn - The ISBN of the book.
+ * @property {string} binding - The binding of the book.
+ */
+
+/**
+ * @typedef {object} IsbnDbBook
+ * @property {string} title - The title of the book.
+ * @property {string} title_long - The long title of the book.
+ * @property {string} isbn - The ISBN of the book.
+ * @property {string} isbn13 - The ISBN13 of the book.
+ * @property {string} dewey_decimal - The Dewey Decimal classification of the book.
+ * @property {string} binding - The binding of the book.
+ * @property {string} publisher - The publisher of the book.
+ * @property {string} language - The language of the book.
+ * @property {string} date_published - The published date of the book.
+ * @property {string} edition - The edition of the book.
+ * @property {number} pages - The number of pages in the book.
+ * @property {string} dimensions - The dimensions of the book.
+ * @property {object} dimensions_structured - The structured dimensions of the book.
+ * @property {Dimension} dimensions_structured.length - The length of the book.
+ * @property {Dimension} dimensions_structured.width - The width of the book.
+ * @property {Dimension} dimensions_structured.height - The height of the book.
+ * @property {Dimension} dimensions_structured.weight - The weight of the book.
+ * @property {string} overview - The overview of the book.
+ * @property {string} image - The image link of the book.
+ * @property {number} msrp - The manufacturer's suggested retail price of the book.
+ * @property {string} excerpt - The excerpt of the book.
+ * @property {string} synopsis - The synopsis of the book.
+ * @property {string[]} authors - The authors of the book.
+ * @property {string[]} subjects - The subjects or categories of the book.
+ * @property {string[]} reviews - The reviews of the book.
+ * @property {Price[]} prices - The prices of the book.
+ * @property {object} related - The related books.
+ * @property {string} related.type - The type of the related books.
+ * @property {OtherIsbn[]} other_isbns - The other ISBNs of the book.
+ */
+
 /**
  * Standardizes a book object by transforming its properties into a consistent format.
- * @param {object} book - The book object to be standardized.
- * @returns {object} - The standardized book object.
+ * @param {IsbnDbBook} book - The book object to be standardized.
+ * @param {string} isbn - The book's ISBN.
+ * @returns {Book} - The standardized book object.
  */
-function standardize(book) {
+function standardize(book, isbn) {
   return {
     title: book.title_long,
-    publishedDate: book.date_published,
     authors: book.authors,
     description: book.overview,
-    industryIdentifiers: [book.isbn, book.isbn13, book.dewey_decimal].filter(
-      Boolean
-    ),
     pageCount: book.pages,
     printType: "BOOK",
     categories: book.subjects,
-    imageLinks: {
-      smallThumbnail: book.image,
-      thumbnail: book.image,
-    },
-    publisher: book.publisher,
-    language: book.language,
+    thumbnail: book.image,
+    isbn,
   };
 }