scavio 0.37.0 → 0.38.0

package/dist/index.js

@@ -145,7 +145,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.37.0" : "0.0.0";
+var SDK_VERSION = true ? "0.38.0" : "0.0.0";
 var USER_AGENT = `scavio-js/${SDK_VERSION}`;
 function isServerRuntime() {
   const g = globalThis;
@@ -3932,6 +3932,147 @@ var NordstromNamespace = class {
   }
 };
 
+// src/namespaces/nordstrom-rack.ts
+var NORDSTROM_RACK_TIMEOUT = 12e4;
+var NORDSTROM_RACK_REVIEWS_TIMEOUT = 15e4;
+var NordstromRackNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search nordstromrack.com (US) products, 24 per page, sorted by relevance,
+   * rating, price, newest or percent off. Each result has style id, URL,
+   * name, brand, image, current price and price range in dollars, the
+   * compare-at price range Rack strikes through (original_price_range),
+   * percent off and on-sale flag, the clearance price range, any promotion on
+   * top (promotion_price_range, and promotion_percent_off: the extra percent
+   * off the clearance price during Clear the Rack, otherwise off Rack's
+   * regular price), rating, review count (Rack's own reviews), badges such as
+   * new_markdown or final_sale, a low-inventory flag, marketplace seller and
+   * every color. Also returns the total result count and page count. Use a
+   * result's url or style_id with product().
+   *
+   * Costs 5 credits.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/nordstromrack/search", options, void 0, NORDSTROM_RACK_TIMEOUT);
+  }
+  /**
+   * One nordstromrack.com (US) product by URL or style id: name, brand, brand
+   * page URL, description, feature bullets, fit notes, final-sale flag,
+   * current, compare-at and clearance price ranges, percent off, any promotion
+   * on top (promotion_price_range and promotion_percent_off, e.g. Clear the
+   * Rack's extra 25% off clearance), rating, review count, the star
+   * histogram, the size-fit distribution, the AI review summary when the site
+   * shows one, praised and criticized features, breadcrumbs and images. Every
+   * color lists every size as a sku with sku id, size, UPC, price, compare-at
+   * price, percent off, price type (regular, clearance, promotion), in_stock
+   * and the quantity available to ship. Includes the reviews shown on the
+   * product page (up to about 13), with the total review count (reviews()
+   * pages the full history). Ratings and reviews are Rack's own, separate
+   * from nordstrom.com's. Pass url or style_id. An unknown style id is a 404.
+   *
+   * Costs 5 credits.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/nordstromrack/product", options, void 0, NORDSTROM_RACK_TIMEOUT);
+  }
+  /**
+   * Browse a nordstromrack.com (US) category page, 24 products per page,
+   * sorted by relevance, rating, price, newest or percent off. Works on every
+   * /shop and /clearance listing: departments (/shop/women), deals
+   * (/shop/deals/black-friday), new arrivals (/shop/new-arrivals), Clear the
+   * Rack (/clearance, /clearance/women/clothing) and flash events: /shop/flash
+   * lists the live events as subcategories (it has no products of its own),
+   * and each event (/shop/flash/event-7) is a listing whose first page shows
+   * the event's featured products first. Returns the category's name, page
+   * title, path, URL, breadcrumbs and subcategories, products with the same
+   * fields as a search result, the total result count, page count and the
+   * filter sidebar with option counts. An unknown category is a 404.
+   *
+   * Costs 5 credits.
+   */
+  async category(options) {
+    return this.client._post("/api/v1/nordstromrack/category", options, void 0, NORDSTROM_RACK_TIMEOUT);
+  }
+  /**
+   * List a brand's products on nordstromrack.com (US) from its brand page
+   * (/brands/adidas), 24 per page, sorted by relevance, rating, price, newest
+   * or percent off. Returns the brand's name, path, URL and breadcrumbs,
+   * products with the same fields as a search result, the total result count,
+   * page count and the filter sidebar with option counts. An unknown brand is
+   * a 404.
+   *
+   * Costs 5 credits.
+   */
+  async brand(options) {
+    return this.client._post("/api/v1/nordstromrack/brand", options, void 0, NORDSTROM_RACK_TIMEOUT);
+  }
+  /**
+   * Find Nordstrom Rack stores near a US ZIP code or latitude/longitude
+   * within up to 100 miles, nearest first, or look Rack stores up by store
+   * number. Each store has store number, name, type (rack), address, phone,
+   * weekly hours, holiday hours when posted, open and close times for the
+   * next 8 days, time zone, distance in miles, coordinates, whether it offers
+   * buy-online pickup and curbside pickup, its amenities and its store page
+   * URL. A ZIP with no store in range returns an empty list.
+   *
+   * Costs 5 credits.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/nordstromrack/stores", options, void 0, NORDSTROM_RACK_TIMEOUT);
+  }
+  /**
+   * Online and Rack store-pickup availability for every size and color of
+   * one nordstromrack.com (US) product, by URL or style id, optionally one
+   * sku. Each sku has sku id, size, color, UPC, in_stock, whether it ships
+   * and the quantity available to ship, the quantity available for pickup,
+   * and the Rack stores where it can be picked up (store number, name,
+   * address, city, state, ZIP, phone). Quantities are chain-wide: per store
+   * the site only says whether pickup is available, not how many. An unknown
+   * style id or sku id is a 404.
+   *
+   * Costs 10 credits (the product page plus the store lookup).
+   */
+  async availability(options) {
+    return this.client._post("/api/v1/nordstromrack/availability", options, void 0, NORDSTROM_RACK_TIMEOUT);
+  }
+  /**
+   * The search-box autocomplete of nordstromrack.com: the queries Nordstrom
+   * Rack suggests for a partial search term, most likely first. Useful for
+   * keyword research and for building queries for search().
+   *
+   * Costs 5 credits.
+   */
+  async suggestions(options) {
+    return this.client._post("/api/v1/nordstromrack/suggestions", options, void 0, NORDSTROM_RACK_TIMEOUT);
+  }
+  /**
+   * Customer reviews of one nordstromrack.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. Rack
+   * has its own review pool, separate from nordstrom.com's. Returns the review
+   * summary (average rating, total reviews, star histogram, size and width
+   * rating, praised and criticized features, rating-only count), the AI
+   * review summary when the site shows one, 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,
+   * size and color purchased, reviewer body details when given, secondary
+   * ratings, the site it was syndicated from and photos. Rating-only reviews
+   * are included with title and text null. Takes 15-60s, up to about 100s at
+   * max_reviews 200, so the request timeout is raised to
+   * NORDSTROM_RACK_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/nordstromrack/reviews", options, void 0, NORDSTROM_RACK_REVIEWS_TIMEOUT);
+  }
+};
+
 // src/namespaces/trustpilot.ts
 var TrustpilotNamespace = class {
   constructor(client) {
@@ -4465,6 +4606,7 @@ var Scavio = class extends ScavioCore {
   chewy;
   menards;
   nordstrom;
+  nordstromRack;
   trustpilot;
   chatgpt;
   gemini;
@@ -4546,6 +4688,7 @@ var Scavio = class extends ScavioCore {
     this.chewy = new ChewyNamespace(this);
     this.menards = new MenardsNamespace(this);
     this.nordstrom = new NordstromNamespace(this);
+    this.nordstromRack = new NordstromRackNamespace(this);
     this.trustpilot = new TrustpilotNamespace(this);
     this.chatgpt = new ChatgptNamespace(this);
     this.gemini = new GeminiNamespace(this);
@@ -4700,9 +4843,12 @@ export {
   MetaAdsNamespace,
   MicroCenterNamespace,
   MissingAPIKeyError,
+  NORDSTROM_RACK_REVIEWS_TIMEOUT,
+  NORDSTROM_RACK_TIMEOUT,
   NORDSTROM_REVIEWS_TIMEOUT,
   NORDSTROM_TIMEOUT,
   NordstromNamespace,
+  NordstromRackNamespace,
   NotFoundError,
   PETCO_SLOW_TIMEOUT,
   PetcoNamespace,