scavio 0.34.2 → 0.36.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.34.2" : "0.0.0";
+var SDK_VERSION = true ? "0.36.0" : "0.0.0";
 var USER_AGENT = `scavio-js/${SDK_VERSION}`;
 function isServerRuntime() {
   const g = globalThis;
@@ -3788,6 +3788,122 @@ var MenardsNamespace = class {
   }
 };
 
+// src/namespaces/nordstrom.ts
+var NORDSTROM_TIMEOUT = 12e4;
+var NordstromNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search nordstrom.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, original
+   * price range, percent off and on-sale flag, rating, review count, badges
+   * such as new or new_markdown, a low-inventory flag, whether it is sold by a
+   * marketplace seller (and the seller's name), and every color with its color
+   * family and image. 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/nordstrom/search", options, void 0, NORDSTROM_TIMEOUT);
+  }
+  /**
+   * One nordstrom.com (US) product by URL or style id: name, brand,
+   * description, feature bullets, fit notes, final-sale flag, current,
+   * original and clearance price ranges, percent off, rating, review count,
+   * the star histogram, the size-fit distribution (too small to too big), the
+   * AI review summary when the site shows one, the most mentioned praised and
+   * criticized features with a quote each, breadcrumbs and images. Every color
+   * lists its images and every size as a sku with sku id, size, size type,
+   * UPC, price, original price, percent off, price type (regular, clearance,
+   * promotion), 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 held only in
+   * 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.
+   *
+   * Costs 5 credits.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/nordstrom/product", options, void 0, NORDSTROM_TIMEOUT);
+  }
+  /**
+   * Browse a nordstrom.com (US) category page, 24 products per page, sorted
+   * by relevance, rating, price, newest or percent off. Works on any /browse
+   * category, including sale (sale/women), new arrivals (/browse/new) and
+   * top-level departments (/browse/women). Returns the category's name, page
+   * title, path, URL, breadcrumbs and subcategories (name and path, for
+   * drilling down). Each product has the same fields as a search result. Also
+   * returns the total result count, page count, and the filter sidebar: each
+   * filter group with its options and product counts (groups with more than
+   * 100 options list the 100 with the most products and give the full
+   * option_count). An unknown category is a 404.
+   *
+   * Costs 5 credits.
+   */
+  async category(options) {
+    return this.client._post("/api/v1/nordstrom/category", options, void 0, NORDSTROM_TIMEOUT);
+  }
+  /**
+   * List a brand's products on nordstrom.com (US) from its brand page, 24 per
+   * page, sorted by relevance, rating, price, newest or percent off. Returns
+   * the brand's name, path, URL, breadcrumbs and sub-pages (Women, Men,
+   * Kids...), 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/nordstrom/brand", options, void 0, NORDSTROM_TIMEOUT);
+  }
+  /**
+   * Find Nordstrom stores (full-line stores and Nordstrom Local) near a US ZIP
+   * code or latitude/longitude within up to 100 miles, nearest first, or look
+   * stores up by store number. Each store has store number, name, type
+   * (full_line or local), 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/nordstrom/stores", options, void 0, NORDSTROM_TIMEOUT);
+  }
+  /**
+   * Online and store-pickup availability for every size and color of one
+   * nordstrom.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
+   * stores where it can be picked up (store number, name, address, city,
+   * state, ZIP, phone). Quantities are chain-wide: per store Nordstrom 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/nordstrom/availability", options, void 0, NORDSTROM_TIMEOUT);
+  }
+  /**
+   * The search-box autocomplete of nordstrom.com: the queries Nordstrom
+   * 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/nordstrom/suggestions", options, void 0, NORDSTROM_TIMEOUT);
+  }
+};
+
 // src/namespaces/trustpilot.ts
 var TrustpilotNamespace = class {
   constructor(client) {
@@ -4320,6 +4436,7 @@ var Scavio = class extends ScavioCore {
   iherb;
   chewy;
   menards;
+  nordstrom;
   trustpilot;
   chatgpt;
   gemini;
@@ -4400,6 +4517,7 @@ var Scavio = class extends ScavioCore {
     this.iherb = new IherbNamespace(this);
     this.chewy = new ChewyNamespace(this);
     this.menards = new MenardsNamespace(this);
+    this.nordstrom = new NordstromNamespace(this);
     this.trustpilot = new TrustpilotNamespace(this);
     this.chatgpt = new ChatgptNamespace(this);
     this.gemini = new GeminiNamespace(this);
@@ -4554,6 +4672,8 @@ export {
   MetaAdsNamespace,
   MicroCenterNamespace,
   MissingAPIKeyError,
+  NORDSTROM_TIMEOUT,
+  NordstromNamespace,
   NotFoundError,
   PETCO_SLOW_TIMEOUT,
   PetcoNamespace,