@library-pals/isbn 1.0.0 → 1.0.2

package/README.md

@@ -57,7 +57,6 @@ information.
 
 ```json
 {
-  "isbn": 9780374104092,
   "title": "Annihilation",
   "authors": ["Jeff VanderMeer"],
   "description": "Describes the 12th expedition to “Area X,” a region cut off from the continent for decades, by a group of intrepid women scientists who try to ignore the high mortality rates of those on the previous 11 missions. Original. 75,000 first printing.",
@@ -65,7 +64,10 @@ information.
   "printType": "BOOK",
   "categories": ["Fiction"],
   "thumbnail": "http://books.google.com/books/content?id=2cl7AgAAQBAJ&printsec=frontcover&img=1&zoom=1&edge=curl&source=gbs_api",
-  "link": "https://books.google.com/books/about/Annihilation.html?hl=&id=2cl7AgAAQBAJ"
+  "link": "https://books.google.com/books/about/Annihilation.html?hl=&id=2cl7AgAAQBAJ",
+  "publisher": "Macmillan",
+  "publishedDate": "2014-02-04",
+  "isbn": "9780374104092"
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@library-pals/isbn",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Find books by ISBN",
   "exports": "./src/index.js",
   "types": "./src/index.d.ts",

package/src/index.d.ts

@@ -1,13 +1,15 @@
 /**
  * @typedef {object} Book
  * @property {string} isbn - The ISBN of the book.
- * @property {string} title - The long title of the book.
+ * @property {string} title - The title of the book.
  * @property {string[]} authors - The authors of the book.
  * @property {string} description - The overview of the book.
  * @property {number} pageCount - The number of pages in the book.
- * @property {string} printType - The print type of the book. Always "BOOK" for this context.
+ * @property {string} printType - The print type of the book.
  * @property {string[]} categories - The subjects or categories of the book.
- * @property {string} thumbnail - The thumbnail image link of the book.
+ * @property {string} publisher - The publisher of the book.
+ * @property {string} publishedDate - The date the book was published.
+ * @property {string | undefined} [thumbnail] - The thumbnail image link of the book.
  * @property {string} [link] - The link of the book.
  */
 /**
@@ -47,7 +49,7 @@ export type Book = {
      */
     isbn: string;
     /**
-     * - The long title of the book.
+     * - The title of the book.
      */
     title: string;
     /**
@@ -63,17 +65,25 @@ export type Book = {
      */
     pageCount: number;
     /**
-     * - The print type of the book. Always "BOOK" for this context.
+     * - The print type of the book.
      */
     printType: string;
     /**
      * - The subjects or categories of the book.
      */
     categories: string[];
+    /**
+     * - The publisher of the book.
+     */
+    publisher: string;
+    /**
+     * - The date the book was published.
+     */
+    publishedDate: string;
     /**
      * - The thumbnail image link of the book.
      */
-    thumbnail: string;
+    thumbnail?: string | undefined;
     /**
      * - The link of the book.
      */

package/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;GAWG;AAEH;;;GAGG;AAEH;IACE;;OAEG;IACH,wDAA+B;IAG7B;;;;MAAoC;IAGtC;;;;;;OAMG;IACH,oBALW,MAAM,EAAE,GACN,MAAM,CAwBlB;IAED;;;;;;OAMG;IACH,cALW,MAAM,YACN,kBAAkB,GAChB,QAAQ,IAAI,CAAC,CAkBzB;CACF;;;;;UA9Ea,MAAM;;;;WACN,MAAM;;;;aACN,MAAM,EAAE;;;;iBACR,MAAM;;;;eACN,MAAM;;;;eACN,MAAM;;;;gBACN,MAAM,EAAE;;;;eACR,MAAM;;;;WACN,MAAM;;wBAIP,OAAO,yBAAyB,EAAE,SAAS;iCAC3C,OAAO,OAAO,EAAE,kBAAkB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AAEH;IACE;;OAEG;IACH,wDAA+B;IAG7B;;;;MAAoC;IAGtC;;;;;;OAMG;IACH,oBALW,MAAM,EAAE,GACN,MAAM,CAwBlB;IAED;;;;;;OAMG;IACH,cALW,MAAM,YACN,kBAAkB,GAChB,QAAQ,IAAI,CAAC,CAkBzB;CACF;;;;;UAhFa,MAAM;;;;WACN,MAAM;;;;aACN,MAAM,EAAE;;;;iBACR,MAAM;;;;eACN,MAAM;;;;eACN,MAAM;;;;gBACN,MAAM,EAAE;;;;eACR,MAAM;;;;mBACN,MAAM;;;;gBACN,MAAM,GAAG,SAAS;;;;WAClB,MAAM;;wBAIP,OAAO,yBAAyB,EAAE,SAAS;iCAC3C,OAAO,OAAO,EAAE,kBAAkB"}

package/src/index.js

@@ -7,13 +7,15 @@ import {
 /**
  * @typedef {object} Book
  * @property {string} isbn - The ISBN of the book.
- * @property {string} title - The long title of the book.
+ * @property {string} title - The title of the book.
  * @property {string[]} authors - The authors of the book.
  * @property {string} description - The overview of the book.
  * @property {number} pageCount - The number of pages in the book.
- * @property {string} printType - The print type of the book. Always "BOOK" for this context.
+ * @property {string} printType - The print type of the book.
  * @property {string[]} categories - The subjects or categories of the book.
- * @property {string} thumbnail - The thumbnail image link of the book.
+ * @property {string} publisher - The publisher of the book.
+ * @property {string} publishedDate - The date the book was published.
+ * @property {string | undefined} [thumbnail] - The thumbnail image link of the book.
  * @property {string} [link] - The link of the book.
  */
 

package/src/providers/google.d.ts

@@ -10,6 +10,15 @@
  * @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 resolveGoogle(isbn: string, options: AxiosRequestConfig): Promise<Book>;
+/**
+ * @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.
@@ -29,7 +38,7 @@ export function resolveGoogle(isbn: string, options: AxiosRequestConfig): Promis
  * @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 {object} imageLinks - The image links 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.
@@ -41,13 +50,38 @@ export function resolveGoogle(isbn: string, options: AxiosRequestConfig): Promis
 /**
  * Standardizes a book object by extracting relevant information from the provided book object.
  * @param {GoogleBook} book - The book object to be standardized.
- * @param {string} id - The book's id.
  * @param {string} isbn - The book's ISBN.
- * @returns {Book} - The standardized book object.
+ * @returns {Book} The standardized book object.
  */
-export function standardize(book: GoogleBook, id: string, isbn: string): Book;
+export function standardize(book: GoogleBook, isbn: string): Book;
 export type Book = import('../index.js').Book;
 export type AxiosRequestConfig = import('axios').AxiosRequestConfig;
+export type ImageLinks = {
+    /**
+     * - extraLarge
+     */
+    extraLarge?: string;
+    /**
+     * - large
+     */
+    large?: string;
+    /**
+     * - medium
+     */
+    medium?: string;
+    /**
+     * - small
+     */
+    small?: string;
+    /**
+     * - thumbnail
+     */
+    thumbnail?: string;
+    /**
+     * - smallThumbnail
+     */
+    smallThumbnail?: string;
+};
 export type GoogleBook = {
     /**
      * - The title of the book.
@@ -120,7 +154,7 @@ export type GoogleBook = {
     /**
      * - The image links of the book.
      */
-    imageLinks: object;
+    imageLinks?: ImageLinks;
     /**
      * - The language of the book.
      */

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

@@ -1 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;;;;;;GAMG;AACH,kCALW,UAAU,MACV,MAAM,QACN,MAAM,GACJ,IAAI,CAgBhB;mBAxFY,OAAO,aAAa,EAAE,IAAI;iCAC1B,OAAO,OAAO,EAAE,kBAAkB;;;;;WAuCjC,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;;;;gBACN,MAAM;;;;cACN,MAAM;;;;iBACN,MAAM;;;;cACN,MAAM;;;;yBACN,MAAM;;;;cACN,MAAM;;;;gBACN,MAAM;;;;gBACN,MAAM"}
+{"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,CAkBhB;mBAnGY,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

@@ -38,12 +38,22 @@ export async function resolveGoogle(isbn, options) {
       throw new Error(`No volume info found for book with isbn: ${isbn}`);
     }
     const book = books.items[0];
-    return standardize(book.volumeInfo, book.id, isbn);
+    return standardize(book.volumeInfo, isbn);
   } catch (error) {
     throw new Error(error.message);
   }
 }
 
+/**
+ * @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.
@@ -63,7 +73,7 @@ export async function resolveGoogle(isbn, options) {
  * @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 {object} imageLinks - The image links 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.
@@ -76,11 +86,10 @@ export async function resolveGoogle(isbn, options) {
 /**
  * Standardizes a book object by extracting relevant information from the provided book object.
  * @param {GoogleBook} book - The book object to be standardized.
- * @param {string} id - The book's id.
  * @param {string} isbn - The book's ISBN.
- * @returns {Book} - The standardized book object.
+ * @returns {Book} The standardized book object.
  */
-export function standardize(book, id, isbn) {
+export function standardize(book, isbn) {
   const standardBook = {
     title: book.title,
     authors: book.authors,
@@ -88,10 +97,37 @@ export function standardize(book, id, isbn) {
     pageCount: book.pageCount,
     printType: book.printType,
     categories: book.categories,
-    thumbnail: `https://books.google.com/books?id=${id}&printsec=frontcover&img=1&zoom=6&edge=curl&source=gbs_api`,
+    thumbnail: getLargestThumbnail(book.imageLinks),
     link: book.canonicalVolumeLink,
+    publisher: book.publisher,
+    publishedDate: book.publishedDate,
     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];
+    }
+  }
+}

package/src/providers/isbndb.js

@@ -123,6 +123,8 @@ function standardize(book, isbn) {
     printType: "BOOK",
     categories: book.subjects,
     thumbnail: book.image,
+    publisher: book.publisher,
+    publishedDate: book.date_published,
     isbn,
   };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"open-library.d.ts","sourceRoot":"","sources":["open-library.js"],"names":[],"mappings":"AAOA;;;GAGG;AAEH;;;;;;GAMG;AACH,yCALW,MAAM,WACN,kBAAkB,GAChB,QAAQ,IAAI,CAAC,CAuBzB;AAED;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;;GAIG;AAEH;;;GAGG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;;GAKG;AACH,kCAJW,eAAe,QACf,MAAM,GACJ,QAAQ,IAAI,CAAC,CAoBzB;AAED;;;;GAIG;AACH,uCAHW;IAAC,GAAG,EAAE,MAAM,CAAA;CAAC,EAAE,GACb,QAAQ,MAAM,EAAE,CAAC,CAuB7B;AAED;;;;;GAKG;AAEH;;;;GAIG;AACH,+BAHW,eAAe,GACb,QAAQ;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,EAAE,CAAA;CAAC,CAAC,CAuC3F;mBAnMY,OAAO,aAAa,EAAE,IAAI;iCAC1B,OAAO,OAAO,EAAE,kBAAkB;;;;;SAkCjC,MAAM;;;;;;SAKN,MAAM;;;;;;SAKN,MAAM;;;;;;UAKN,MAAM;;;;WACN,MAAM;;;;;;SAKN,MAAM;;;;;;UAKN,MAAM;;;;WACN,MAAM;;;;;;iBAKN,MAAM;;;;WACN,MAAM;;;;aACN,MAAM,EAAE;;;;kBACR,MAAM;;;;gBACN,MAAM,EAAE;;;;YACR,MAAM,EAAE;;;;mBACR,MAAM,EAAE;;;;eACR,QAAQ,EAAE;;;;oBACV,MAAM,EAAE;;;;cACR,MAAM,EAAE;;;;UACR,IAAI;;;;oBACJ,aAAa;;;;SACb,MAAM;;;;qBACN,MAAM;;;;WACN,IAAI,EAAE;;;;qBACN,MAAM;;;;WACN,MAAM;;;;aACN,MAAM,EAAE;;;;aACR,MAAM,EAAE;;;;qBACR,MAAM;;;;cACN,MAAM;;;;aACN,QAAQ;;;;mBACR,QAAQ;;;;;;iBA2DR,MAAM;;;;cACN,MAAM,EAAE;;;;aACR;QAAC,MAAM,EAAE;YAAC,GAAG,EAAE,MAAM,CAAA;SAAC,CAAA;KAAC,EAAE"}
+{"version":3,"file":"open-library.d.ts","sourceRoot":"","sources":["open-library.js"],"names":[],"mappings":"AAOA;;;GAGG;AAEH;;;;;;GAMG;AACH,yCALW,MAAM,WACN,kBAAkB,GAChB,QAAQ,IAAI,CAAC,CAuBzB;AAED;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;;GAIG;AAEH;;;GAGG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;;GAKG;AACH,kCAJW,eAAe,QACf,MAAM,GACJ,QAAQ,IAAI,CAAC,CAsBzB;AAED;;;;GAIG;AACH,uCAHW;IAAC,GAAG,EAAE,MAAM,CAAA;CAAC,EAAE,GACb,QAAQ,MAAM,EAAE,CAAC,CAuB7B;AAED;;;;;GAKG;AAEH;;;;GAIG;AACH,+BAHW,eAAe,GACb,QAAQ;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,EAAE,CAAA;CAAC,CAAC,CAuC3F;mBArMY,OAAO,aAAa,EAAE,IAAI;iCAC1B,OAAO,OAAO,EAAE,kBAAkB;;;;;SAkCjC,MAAM;;;;;;SAKN,MAAM;;;;;;SAKN,MAAM;;;;;;UAKN,MAAM;;;;WACN,MAAM;;;;;;SAKN,MAAM;;;;;;UAKN,MAAM;;;;WACN,MAAM;;;;;;iBAKN,MAAM;;;;WACN,MAAM;;;;aACN,MAAM,EAAE;;;;kBACR,MAAM;;;;gBACN,MAAM,EAAE;;;;YACR,MAAM,EAAE;;;;mBACR,MAAM,EAAE;;;;eACR,QAAQ,EAAE;;;;oBACV,MAAM,EAAE;;;;cACR,MAAM,EAAE;;;;UACR,IAAI;;;;oBACJ,aAAa;;;;SACb,MAAM;;;;qBACN,MAAM;;;;WACN,IAAI,EAAE;;;;qBACN,MAAM;;;;WACN,MAAM;;;;aACN,MAAM,EAAE;;;;aACR,MAAM,EAAE;;;;qBACR,MAAM;;;;cACN,MAAM;;;;aACN,QAAQ;;;;mBACR,QAAQ;;;;;;iBA6DR,MAAM;;;;cACN,MAAM,EAAE;;;;aACR;QAAC,MAAM,EAAE;YAAC,GAAG,EAAE,MAAM,CAAA;SAAC,CAAA;KAAC,EAAE"}

package/src/providers/open-library.js

@@ -118,6 +118,8 @@ export async function standardize(book, isbn) {
     link: book.key
       ? `${OPENLIBRARY_API_BASE}${book.key}`
       : `${OPENLIBRARY_API_BASE}${OPENLIBRARY_API_BOOK}/${isbn}`,
+    publisher: book.publishers?.join(", "),
+    publishedDate: book.publish_date,
     isbn,
   };