scavio 0.32.2 → 0.34.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.32.2" : "0.0.0";
+var SDK_VERSION = true ? "0.34.0" : "0.0.0";
 var USER_AGENT = `scavio-js/${SDK_VERSION}`;
 function isServerRuntime() {
   const g = globalThis;
@@ -3333,6 +3333,459 @@ var CvsNamespace = class {
   }
 };
 
+// src/namespaces/whole-foods.ts
+var WholeFoodsNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Whole Foods Market products at one store, up to 60 per page: ASIN,
+   * slug, name, brand, image, that store's regular_price, sale_price and
+   * prime_price with sale start and end dates (a multi-buy is a total:
+   * sale_price 10 with sale_quantity 2 is 2 for $10; price_unit lb is per
+   * pound), on_sale and is_local flags. Also total_results and facets
+   * (categories, diets). Sorts by relevance or price only.
+   *
+   * Costs 1 credit.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/wholefoods/search", options);
+  }
+  /**
+   * Browse one Whole Foods Market category at one store, with sort, on_sale
+   * and diet filters. Same product fields as search, plus the category
+   * breadcrumb, total_results and facets. An unknown category slug is a 404.
+   *
+   * Costs 1 credit.
+   */
+  async category(options) {
+    return this.client._post("/api/v1/wholefoods/category", options);
+  }
+  /**
+   * Every product on sale at one Whole Foods Market store, store-wide or in
+   * one category, with regular, sale and Prime prices and sale dates.
+   *
+   * Costs 1 credit.
+   */
+  async deals(options = {}) {
+    return this.client._post("/api/v1/wholefoods/deals", options);
+  }
+  /**
+   * One Whole Foods Market product by ASIN, URL or slug: name, brand,
+   * description, ingredients, nutrition facts, diets, SNAP EBT eligibility
+   * and images. With store_id, two separate price blocks: in_store (the
+   * store's shelf regular, sale and Prime price; null when it does not list
+   * the item) and online (delivery/pickup price, list price, savings, Prime
+   * price, unit price, availability; null with no online offer). An unknown
+   * ASIN is a 404.
+   *
+   * Costs 1 credit.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/wholefoods/product", options);
+  }
+  /**
+   * Whole Foods Market stores near a US ZIP code, nearest first (within 15
+   * miles, widening to 50): store_id, name, address, phone, coordinates,
+   * distance in miles, time zone and seven days of in-store and pickup hours.
+   * No store in range is an empty list.
+   *
+   * Costs 1 credit.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/wholefoods/stores", options);
+  }
+  /**
+   * One Whole Foods Market store by id: name, status, phone, Prime
+   * eligibility, opening date, address, coordinates, time zone, store page and
+   * sales flyer URLs. An unknown store id is a 404.
+   *
+   * Costs 1 credit.
+   */
+  async store(options) {
+    return this.client._post("/api/v1/wholefoods/store", options);
+  }
+  /**
+   * The current weekly sales flyer of one Whole Foods Market store: each
+   * promotion's product name, brand, headline, description, terms, regular,
+   * sale and Prime price as printed (text such as "$3.99/lb" or "44% off"),
+   * start and end dates, image, rank and the ASINs it covers. An unknown
+   * store id is a 404.
+   *
+   * Costs 1 credit.
+   */
+  async salesFlyer(options) {
+    return this.client._post("/api/v1/wholefoods/sales-flyer", options);
+  }
+};
+
+// src/namespaces/harbor-freight.ts
+var HarborFreightNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Harbor Freight by keyword and/or category, with brand and
+   * clearance filters: item number, id, title, brand, URL, image, price,
+   * regular price, on_sale and clearance flags, sale (price, end date,
+   * savings), coupon, member_deal, compare_at, badges, rating, review count,
+   * in-store-only / online-only flags and variants. Also total_results,
+   * facets, and redirect when a keyword maps to a category page.
+   *
+   * Costs 1 credit.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/harborfreight/search", options);
+  }
+  /**
+   * Harbor Freight clearance items, optionally narrowed by keyword, category
+   * or brand. Same fields as search; each item's clearance price and end date
+   * are in `sale`.
+   *
+   * Costs 1 credit.
+   */
+  async clearance(options = {}) {
+    return this.client._post("/api/v1/harborfreight/clearance", options);
+  }
+  /**
+   * One product by item number, id or URL: title, brand, UPC, every price
+   * field of search, rating, review count, description, highlights, the full
+   * specification table, warranty, shipping notes, owner's manuals, images
+   * and variants. An unknown item is a 404.
+   *
+   * Costs 1 credit.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/harborfreight/product", options);
+  }
+  /**
+   * Current prices for up to 50 item numbers in one call: price, regular
+   * price, sale, coupon, member_deal and compare_at per item. Unknown item
+   * numbers are listed in not_found.
+   *
+   * Costs 1 credit.
+   */
+  async prices(options) {
+    return this.client._post("/api/v1/harborfreight/prices", options);
+  }
+  /**
+   * Harbor Freight stores near a ZIP code, "City, ST" or coordinates, nearest
+   * first: store_id, name, address, phone, coordinates, distance in miles,
+   * status, opening date and hours.
+   *
+   * Costs 1 credit.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/harborfreight/stores", options);
+  }
+  /**
+   * In-store stock for up to 20 items at chosen stores, or at the stores
+   * nearest a ZIP code or coordinates. Each store lists every item with
+   * stock_status (in_stock, limited, out_of_stock or not_carried), the aisle
+   * and a nearby store that has it. inventory_updated_at is the time of the
+   * daily stock snapshot. Stock is a status, not a unit count.
+   *
+   * Costs 1 credit.
+   */
+  async availability(options) {
+    return this.client._post("/api/v1/harborfreight/availability", options);
+  }
+  /**
+   * Customer reviews for one item, newest first, with limit/offset paging:
+   * title, text, star rating, author, review and purchase dates, incentivized
+   * flag, helpful votes and the reviewer's answers. Also the average rating
+   * and total review count. An unknown item is a 404.
+   *
+   * Costs 1 credit.
+   */
+  async reviews(options) {
+    return this.client._post("/api/v1/harborfreight/reviews", options);
+  }
+};
+
+// src/namespaces/petsmart.ts
+var PetsmartNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search PetSmart products, up to 40 per page: SKU, web_style_id, name,
+   * brand, UPC, price, original and sale price, price range across sizes,
+   * rating, review count, image, size, variations, category, pets,
+   * promotions, stores_in_stock (how many stores stock it), pickup and
+   * Autoship eligibility and URL. Prices are national. Pass store_id to list
+   * only products in stock at that store.
+   *
+   * Costs 1 credit.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/petsmart/search", options);
+  }
+  /**
+   * One PetSmart product by web_style_id, SKU or URL, with every variant
+   * (size, flavor): SKU, UPC, price, original price, sale price and end date,
+   * Autoship discount with first-order and recurring price, ship-to-home
+   * stock, pickup and same-day options, images and promotions. Also brand,
+   * rating, review count, categories and description. An unknown id is a 404.
+   *
+   * Costs 1 credit.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/petsmart/product", options);
+  }
+  /**
+   * The 12 PetSmart stores nearest a US ZIP code: store_id, name, address,
+   * phone, coordinates, distance in miles, time zone, the next 7 days of
+   * hours and services (grooming, PetsHotel, veterinary, adoptions). Pass a
+   * sku and each store also carries quantity and in_stock for it.
+   *
+   * Costs 1 credit.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/petsmart/stores", options);
+  }
+  /**
+   * Stock of up to 20 SKUs at one PetSmart store: units for in-store pickup
+   * at that store, units to ship to home, and a nearby alternate store with
+   * its count when the store has none. Includes the store's address and
+   * pickup options. An unknown store is a 404; an unknown SKU reads 0.
+   *
+   * Costs 1 credit.
+   */
+  async storeStock(options) {
+    return this.client._post("/api/v1/petsmart/store-stock", options);
+  }
+  /**
+   * Unit counts for up to 20 store and SKU pairs in one call, mixing stores
+   * and SKUs freely: quantity and in_stock per pair. Unknown stores or SKUs
+   * read 0.
+   *
+   * Costs 1 credit.
+   */
+  async availability(options) {
+    return this.client._post("/api/v1/petsmart/availability", options);
+  }
+  /**
+   * Products in PetSmart's Sale section, up to 40 per page, in the same shape
+   * as search, plus the current sale events with approximate product counts.
+   * The Sale section also lists points and Autoship promotions, so on_sale
+   * marks the rows whose price is actually reduced.
+   *
+   * Costs 1 credit.
+   */
+  async deals(options = {}) {
+    return this.client._post("/api/v1/petsmart/deals", options);
+  }
+};
+
+// src/namespaces/petco.ts
+var PETCO_SLOW_TIMEOUT = 12e4;
+var PetcoNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Petco products, 48 per page: price, list price and autoship
+   * (Repeat Delivery) price, rating, review count, brand, part_number,
+   * cat_entry_id (for storeInventory), fulfillment flags (pickup, same-day
+   * delivery, autoship, in-store only), deal group ids and every size/flavor
+   * variation with its own prices. Also total_results, facets and the
+   * categories the matches fall into. Prices are national.
+   *
+   * Costs 1 credit.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/petco/search", options, void 0, PETCO_SLOW_TIMEOUT);
+  }
+  /**
+   * Products in a Petco category, e.g. dog/dog-food/dry-dog-food, in the same
+   * shape as search. An unknown category is a 404. Can take 10-30 seconds.
+   *
+   * Costs 1 credit.
+   */
+  async category(options) {
+    return this.client._post("/api/v1/petco/category", options, void 0, PETCO_SLOW_TIMEOUT);
+  }
+  /**
+   * One Petco product by part number or URL, with every variant (size,
+   * flavor): cat_entry_id, part number, SKU, UPC, price, list price, autoship
+   * price, first-autoship promo price, online quantity and status,
+   * fulfillment flags, ingredients, guaranteed analysis, directions,
+   * specifications, dimensions and images. Plus brand, rating, review count
+   * and breadcrumbs. Prices are national. An unknown product is a 404. Can
+   * take 10-30 seconds.
+   *
+   * Costs 1 credit.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/petco/product", options, void 0, PETCO_SLOW_TIMEOUT);
+  }
+  /**
+   * Petco stores nearest a US ZIP code (up to 10): store_id (for
+   * storeInventory), store number, name, address, phone, coordinates,
+   * distance in miles, in-store pickup and opening hours per weekday.
+   *
+   * Costs 1 credit.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/petco/stores", options, void 0, PETCO_SLOW_TIMEOUT);
+  }
+  /**
+   * Units on hand at one Petco store for up to 10 products: qty_available,
+   * alert_level (GREEN, YELLOW, RED) and in_stock per cat_entry_id. Pass a
+   * store_id, or a zip to use the nearest store.
+   *
+   * Costs 1 credit.
+   */
+  async storeInventory(options) {
+    return this.client._post("/api/v1/petco/store-inventory", options, void 0, PETCO_SLOW_TIMEOUT);
+  }
+};
+
+// src/namespaces/iherb.ts
+var IHERB_SLOW_TIMEOUT = 12e4;
+var IherbNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search iHerb (US store, USD), 48 per page: product_id, part_number, name,
+   * brand, brand_code, URL, image, price, list price, original price and
+   * discount_percent when discounted, rating, review count, in_stock, badges
+   * (Best seller, iHerb Brands, New), recent_sales (e.g. "30K+ sold in 30
+   * days") and position. Also total_results and brand_filters for narrowing
+   * with brand_code.
+   *
+   * Costs 2 credits.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/iherb/search", options, void 0, IHERB_SLOW_TIMEOUT);
+  }
+  /**
+   * One iHerb product by id or URL (US store, USD): name, brand, part number,
+   * UPC, price, list price, discount, price per serving or unit, stock status,
+   * discontinued and coming-soon flags, quantity limit, expiration date,
+   * package quantity, weight and dimensions, rating and review count,
+   * breadcrumbs, best-seller rankings, badges, variants, supplement facts,
+   * description, suggested use, ingredients, warnings and images. An unknown
+   * product id is a 404.
+   *
+   * Costs 2 credits.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/iherb/product", options, void 0, IHERB_SLOW_TIMEOUT);
+  }
+  /**
+   * Current price, list price, discount, in-stock flag, rating and review
+   * count for up to 50 iHerb products in one call (US store, USD). One row
+   * per requested id, in request order; unknown ids come back with
+   * found: false and are listed in not_found.
+   *
+   * Costs 2 credits.
+   */
+  async prices(options) {
+    return this.client._post("/api/v1/iherb/prices", options);
+  }
+  /**
+   * The review summary for one iHerb product: average rating, total review
+   * count, star histogram, review counts per language, and the full text of
+   * the top positive and top critical review (rating, title, author, country,
+   * date, verified-purchase flag, helpful votes, images). Not a full review
+   * list.
+   *
+   * Costs 2 credits.
+   */
+  async reviews(options) {
+    return this.client._post("/api/v1/iherb/reviews", options);
+  }
+};
+
+// src/namespaces/chewy.ts
+var ChewyNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Chewy by keyword, or browse a category, 36 per page: one-time
+   * price, offer and strike-through price, Autoship price and discount,
+   * first-Autoship price, discount and savings cap, MAP price, per-unit
+   * price, rating, rating count, in-stock flag, deal/new/exclusive/
+   * prescription flags, brand, image and URL. Sponsored listings are removed
+   * (sponsored_removed counts them). `redirect` names the category when
+   * Chewy sends the query to one.
+   *
+   * Costs 10 credits.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/chewy/search", options);
+  }
+  /**
+   * One Chewy product by id or URL: one-time price, offer price, list and
+   * strike-through price with savings, MAP price and whether it is enforced,
+   * Autoship price and discount, first-Autoship price, per-unit price,
+   * in-stock flag, rating, rating count, review count and star distribution,
+   * brand, GTIN, description, key benefits, specifications, breadcrumbs,
+   * images, promotions and every variant (size, flavor) with its own price,
+   * Autoship price and stock. An unknown product id is a 404.
+   *
+   * Costs 10 credits.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/chewy/product", options);
+  }
+};
+
+// src/namespaces/menards.ts
+var MENARDS_PRODUCT_TIMEOUT = 12e4;
+var MenardsNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search menards.com at one store, 40 products a page: item_id, sku, name,
+   * url, image, price, everyday_price, sale_price, price_type (regular, sale,
+   * clearance, minimum_advertised), mail-in rebates, final_price after
+   * rebates, and that store's stock_quantity, stock_message, pickup and
+   * delivery flags. Also total_results, total_pages and facets.
+   *
+   * Costs 2 credits.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/menards/search", options);
+  }
+  /**
+   * One Menards product by item id or URL: name, brand, model number, SKU,
+   * description, bullets, specifications, images, videos and documents, with
+   * the full price ladder: everyday price, sale price and end date, mail-in
+   * rebates (text, amount, dates), final price after rebates and you_save.
+   * Also pickup, delivery and ship-to-store flags. With store_id, that store's
+   * stock quantity, stock message, aisle location and not_available_at_store.
+   * An unknown item id or store number is a 404.
+   *
+   * Costs 1 credit, or 2 with store_id.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/menards/product", options, void 0, MENARDS_PRODUCT_TIMEOUT);
+  }
+  /**
+   * Menards stores near a US ZIP code or a city and state, nearest first:
+   * store_id, name, address, coordinates, distance in miles and services
+   * (garden center, grocery, rental center, propane and more).
+   *
+   * Costs 1 credit.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/menards/stores", options);
+  }
+};
+
 // src/namespaces/trustpilot.ts
 var TrustpilotNamespace = class {
   constructor(client) {
@@ -3858,6 +4311,13 @@ var Scavio = class extends ScavioCore {
   microCenter;
   walgreens;
   cvs;
+  wholeFoods;
+  harborFreight;
+  petsmart;
+  petco;
+  iherb;
+  chewy;
+  menards;
   trustpilot;
   chatgpt;
   gemini;
@@ -3931,6 +4391,13 @@ var Scavio = class extends ScavioCore {
     this.microCenter = new MicroCenterNamespace(this);
     this.walgreens = new WalgreensNamespace(this);
     this.cvs = new CvsNamespace(this);
+    this.wholeFoods = new WholeFoodsNamespace(this);
+    this.harborFreight = new HarborFreightNamespace(this);
+    this.petsmart = new PetsmartNamespace(this);
+    this.petco = new PetcoNamespace(this);
+    this.iherb = new IherbNamespace(this);
+    this.chewy = new ChewyNamespace(this);
+    this.menards = new MenardsNamespace(this);
     this.trustpilot = new TrustpilotNamespace(this);
     this.chatgpt = new ChatgptNamespace(this);
     this.gemini = new GeminiNamespace(this);
@@ -4050,6 +4517,7 @@ export {
   CanadianTireNamespace,
   CapterraNamespace,
   ChatgptNamespace,
+  ChewyNamespace,
   CompaniesHouseNamespace,
   CostcoNamespace,
   CvsNamespace,
@@ -4063,8 +4531,11 @@ export {
   GoogleAdsNamespace,
   GoogleNamespace,
   GooglePlayNamespace,
+  HarborFreightNamespace,
   HebNamespace,
   HomeDepotNamespace,
+  IHERB_SLOW_TIMEOUT,
+  IherbNamespace,
   IndeedNamespace,
   InstagramNamespace,
   InsufficientCreditsError,
@@ -4074,11 +4545,16 @@ export {
   LinkedInNamespace,
   LowesNamespace,
   MAX_REQUESTS_PER_SECOND,
+  MENARDS_PRODUCT_TIMEOUT,
+  MenardsNamespace,
   MercadoLibreNamespace,
   MetaAdsNamespace,
   MicroCenterNamespace,
   MissingAPIKeyError,
   NotFoundError,
+  PETCO_SLOW_TIMEOUT,
+  PetcoNamespace,
+  PetsmartNamespace,
   RateLimitError,
   RealtorNamespace,
   RedditNamespace,
@@ -4102,6 +4578,7 @@ export {
   UltaNamespace,
   WalgreensNamespace,
   WalmartNamespace,
+  WholeFoodsNamespace,
   XNamespace,
   YelpNamespace,
   YouTubeNamespace,