scavio 0.36.0 → 0.37.0

package/README.md

@@ -685,10 +685,10 @@ to `MENARDS_PRODUCT_TIMEOUT` (120s). None ever lowers a longer client timeout.
 
 ### [Nordstrom](https://scavio.dev/docs/nordstrom-search?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme)
 
-Seven endpoints, nordstrom.com (US site only). `search` and `product` are new in
+Eight endpoints, nordstrom.com (US site only). `search` and `product` are new in
 0.35.0; `category`, `brand`, `stores`, `availability` and `suggestions` are new
-in 0.36.0. `availability` costs 10 credits (the product page plus the store
-lookup); every other call costs 5.
+in 0.36.0; `reviews` is new in 0.37.0. `availability` costs 10 credits (the
+product page plus the store lookup) and `reviews` 10; every other call costs 5.
 
 - `search`, `category` and `brand` return 24 products a page with current and
   original price ranges, percent off, on-sale flag, rating, review count,
@@ -703,6 +703,15 @@ lookup); every other call costs 5.
   as a sku with UPC, price, price type, `in_stock` and the `quantity` available
   to ship. `in_stock` is true when the sku can be shipped or picked up in a
   store, so a sku can be in stock with `quantity` 0 (store-only).
+- `reviews` takes `url` or `style_id` and returns the product's full review
+  history, up to `max_reviews` per call (1-200, default 60). `sort` is
+  `most_helpful` (default), `most_recent`, `highest_rated` or `lowest_rated`;
+  filter with `stars` (e.g. `[1, 2]`), `verified_only`, `with_photos` or a text
+  `search` (`search` cannot be combined with `sort`). The response carries the
+  `summary` (average rating, total reviews, histogram, size and width rating,
+  praised and criticized features with a quote, rating-only count), the
+  `ai_summary`, `total_results`, `returned` and `has_more`. Rating-only reviews
+  are included with `title` and `text` null.
 - `availability` takes `url` or `style_id` (optionally `sku_id`) and returns per
   sku `ship_quantity`, `pickup_available`, `pick_quantity` and the stores that
   can do in-store pickup. Quantities are chain-wide; per store Nordstrom only
@@ -736,13 +745,25 @@ for (const sku of (stock as any).data.skus) {
 
 const ideas = await client.nordstrom.suggestions({ query: "nike air" });
 console.log((ideas as any).data.suggestions);
+
+const rev = (await client.nordstrom.reviews({ style_id: "7737947", sort: "most_recent", max_reviews: 100 })) as any;
+const { summary } = rev.data;
+console.log(summary.average_rating, summary.total_reviews, summary.ratings_histogram, summary.size_rating);
+console.log(rev.data.total_results, rev.data.returned, rev.data.has_more, rev.data.ai_summary);
+for (const r of rev.data.reviews.slice(0, 5)) {
+  console.log(r.date, r.rating, r.title, r.text, r.size_purchased, r.helpful_votes, r.badges, r.photos.length);
+}
+const critical = await client.nordstrom.reviews({ style_id: "7737947", stars: [1, 2], verified_only: true });
 ```
 
 `product` returns the reviews shown on the product page (up to about 13) plus
-the total review count and star histogram; the full review history is not
-available. An unknown style id, sku id, category or brand is a 404. Every call
-raises the request timeout to `NORDSTROM_TIMEOUT` (120s), never lowering a
-longer client timeout.
+the total review count and star histogram; `reviews` returns the rest. An
+unknown style id, sku id, category or brand is a 404. Every call raises the
+request timeout to `NORDSTROM_TIMEOUT` (120s), except `reviews`, which takes
+20-60s (up to about 100s at 200 reviews) and raises it to
+`NORDSTROM_REVIEWS_TIMEOUT` (150s). Neither ever lowers a longer client timeout.
+If the upstream page still fails after the API's own retries, the call is an
+unbilled 502.
 
 ### [Mercado Libre](https://scavio.dev/docs/mercadolibre-search?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme)
 

package/dist/index.cjs

@@ -76,6 +76,7 @@ __export(index_exports, {
   MetaAdsNamespace: () => MetaAdsNamespace,
   MicroCenterNamespace: () => MicroCenterNamespace,
   MissingAPIKeyError: () => MissingAPIKeyError,
+  NORDSTROM_REVIEWS_TIMEOUT: () => NORDSTROM_REVIEWS_TIMEOUT,
   NORDSTROM_TIMEOUT: () => NORDSTROM_TIMEOUT,
   NordstromNamespace: () => NordstromNamespace,
   NotFoundError: () => NotFoundError,
@@ -261,7 +262,7 @@ function parseRetryAfter(header) {
 var BASE_URL = "https://api.scavio.dev";
 var DEFAULT_TIMEOUT = 3e4;
 var DEFAULT_MAX_RETRIES = 2;
-var SDK_VERSION = true ? "0.36.0" : "0.0.0";
+var SDK_VERSION = true ? "0.37.0" : "0.0.0";
 var USER_AGENT = `scavio-js/${SDK_VERSION}`;
 function isServerRuntime() {
   const g = globalThis;
@@ -3906,6 +3907,7 @@ var MenardsNamespace = class {
 
 // src/namespaces/nordstrom.ts
 var NORDSTROM_TIMEOUT = 12e4;
+var NORDSTROM_REVIEWS_TIMEOUT = 15e4;
 var NordstromNamespace = class {
   constructor(client) {
     this.client = client;
@@ -3940,8 +3942,9 @@ var NordstromNamespace = class {
    * a store reads in stock with quantity 0 (availability() lists its pickup
    * stores). Includes the reviews shown on the product page (up to about 13),
    * with the total review count; each review has title, text, rating, size
-   * rating, author, date, helpful votes and verified-purchase flag. Pass url
-   * or style_id. An unknown style id is a 404.
+   * rating, author, date, helpful votes and verified-purchase flag
+   * (reviews() pages the full review history). Pass url or style_id. An
+   * unknown style id is a 404.
    *
    * Costs 5 credits.
    */
@@ -4018,6 +4021,32 @@ var NordstromNamespace = class {
   async suggestions(options) {
     return this.client._post("/api/v1/nordstrom/suggestions", options, void 0, NORDSTROM_TIMEOUT);
   }
+  /**
+   * Customer reviews of one nordstrom.com (US) product by URL or style id, up
+   * to 200 per call (default 60), sorted most helpful (default), most recent,
+   * highest rated or lowest rated, optionally filtered to star ratings,
+   * verified purchases, reviews with photos, or a text search. Returns the
+   * product's review summary (average rating, total reviews, star histogram,
+   * size rating 1 runs small to 5 runs big, width rating where the site has
+   * one, the most mentioned praised and criticized features with a quote each,
+   * and the count of rating-only reviews), the AI review summary when the site
+   * shows one, the number of reviews matching the filters (total_results),
+   * returned and has_more. Each review has id, title, text, star rating, size
+   * rating, author, date, helpful votes, verified-purchase flag, reviewer
+   * badges (verified_purchaser, top_250, top_1000), size and color purchased,
+   * the reviewer's height, weight, body type and usual sizes when given,
+   * secondary ratings (Size, with its scale), the site it was syndicated from
+   * (e.g. nordstromrack.com) and photos with thumbnails. Rating-only reviews
+   * are included with title and text null. Takes 20-60s, up to about 100s at
+   * max_reviews 200, so the request timeout is raised to
+   * NORDSTROM_REVIEWS_TIMEOUT. A product with no reviews returns an empty
+   * list; an unknown style id is a 404.
+   *
+   * Costs 10 credits.
+   */
+  async reviews(options) {
+    return this.client._post("/api/v1/nordstrom/reviews", options, void 0, NORDSTROM_REVIEWS_TIMEOUT);
+  }
 };
 
 // src/namespaces/trustpilot.ts
@@ -4789,6 +4818,7 @@ async function getSubtle() {
   MetaAdsNamespace,
   MicroCenterNamespace,
   MissingAPIKeyError,
+  NORDSTROM_REVIEWS_TIMEOUT,
   NORDSTROM_TIMEOUT,
   NordstromNamespace,
   NotFoundError,