scavio 0.30.1 → 0.31.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.30.1" : "0.0.0";
+var SDK_VERSION = true ? "0.31.0" : "0.0.0";
 var USER_AGENT = `scavio-js/${SDK_VERSION}`;
 function isServerRuntime() {
   const g = globalThis;
@@ -2799,6 +2799,259 @@ var SpecsNamespace = class {
   }
 };
 
+// src/namespaces/lowes.ts
+var LowesNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Lowe's by keyword or category at one store: the store's price,
+   * was-price and savings with the sale end date, brand, model number, rating,
+   * review count, and stock for pickup, truck delivery, parcel shipping and
+   * same-day delivery. Pass query or category_id; on_sale returns that
+   * store's deals.
+   *
+   * Costs 2 credits.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/lowes/search", options);
+  }
+  /**
+   * One Lowe's item at one store: price, was-price and savings, on-hand stock
+   * with lead time per fulfillment method, stock at nearby stores, aisle and
+   * bay, grouped specifications, UPC, dimensions, weight, rating, images, and
+   * the store's hours.
+   *
+   * Costs 2 credits.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/lowes/product", options);
+  }
+  /**
+   * Lowe's stores near a ZIP code, nearest first: store_id, name, address,
+   * phone, coordinates, distance, time zone, opening hours and features.
+   *
+   * Costs 2 credits.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/lowes/stores", options);
+  }
+  /**
+   * One page of an item's customer reviews (10 per page): rating, title, text,
+   * date, reviewer, recommended, helpful votes, verified and incentivized
+   * flags, photos and brand replies, plus the average rating and count per star.
+   *
+   * Costs 1 credit.
+   */
+  async reviews(options) {
+    return this.client._post("/api/v1/lowes/reviews", options);
+  }
+};
+
+// src/namespaces/sams-club.ts
+var SamsClubNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Sam's Club: item_id, price, was_price, savings_amount, unit price,
+   * Instant Savings (amount, end date, purchase limit), rating, review count,
+   * stock, pickup/delivery/shipping availability and aisle. The club is picked
+   * by location and returned in data.club.
+   *
+   * Costs 1 credit.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/samsclub/search", options);
+  }
+  /**
+   * One Sam's Club item: online price and the club shelf price (club_price)
+   * with was price, savings and unit price, Instant Savings, rating histogram,
+   * UPC, model, specifications, and per-method fulfillment with stock and
+   * aisle. Pass club_id to price and stock a specific club.
+   *
+   * Costs 1 credit.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/samsclub/product", options);
+  }
+  /**
+   * Sam's Club clubs near a US ZIP, nearest first: club_id, name, address,
+   * coordinates, distance in miles, phone, opening hours, services and whether
+   * the club is temporarily closed.
+   *
+   * Costs 1 credit.
+   */
+  async clubs(options) {
+    return this.client._post("/api/v1/samsclub/clubs", options);
+  }
+  /**
+   * Every item on Sam's Club Instant Savings, paged: price, was price and
+   * savings amount, plus each offer's amount, end date, purchase limit and
+   * channels.
+   *
+   * Costs 1 credit.
+   */
+  async savings(options = {}) {
+    return this.client._post("/api/v1/samsclub/savings", options);
+  }
+  /**
+   * Products in a Sam's Club category, paged, with the same fields as
+   * search(). Clearance is category "1150109".
+   *
+   * Costs 1 credit.
+   */
+  async category(options) {
+    return this.client._post("/api/v1/samsclub/category", options);
+  }
+  /**
+   * Customer reviews for a Sam's Club item, 10 per page: rating, title, text,
+   * author, date, verified purchase and helpful votes, plus the average rating,
+   * total count and 1-5 star breakdown.
+   *
+   * Costs 1 credit.
+   */
+  async reviews(options) {
+    return this.client._post("/api/v1/samsclub/reviews", options);
+  }
+};
+
+// src/namespaces/canadian-tire.ts
+var CanadianTireNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Canadian Tire by keyword or category at one store: the store's
+   * price and regular price (CAD), price range for multi-variant items,
+   * savings, badges (clearance, sale, rebate), rating, review count, brand,
+   * part number, SKU, and stock at the store and online.
+   *
+   * Costs 1 credit.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/canadiantire/search", options);
+  }
+  /**
+   * One product by code at one store: breadcrumb, images, rating, review
+   * count, descriptions, features, specifications, price and regular price,
+   * warranty, manuals, variants with their SKUs, and the store's price, stock,
+   * and pickup and ship-to-home dates.
+   *
+   * Costs 1 credit.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/canadiantire/product", options);
+  }
+  /**
+   * Canadian Tire stores near a postal code or coordinates, nearest first:
+   * store_id, name, address, phone, coordinates, distance, weekly hours and
+   * services. Pass sku to get each store's stock quantity and aisle for it.
+   *
+   * Costs 1 credit.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/canadiantire/stores", options);
+  }
+  /**
+   * Up to 50 SKUs at one store in one call: the store's price and regular
+   * price, clearance and sale flags, price valid-until date, stock quantity,
+   * aisle, online stock, and pickup and delivery dates. Unknown SKUs are
+   * listed in not_found.
+   *
+   * Costs 1 credit.
+   */
+  async availability(options) {
+    return this.client._post("/api/v1/canadiantire/availability", options);
+  }
+  /**
+   * Every clearance item at one store, 100 per page, with clearance price,
+   * regular price, stock at the store and the same fields as search().
+   * In-stock items only by default.
+   *
+   * Costs 1 credit.
+   */
+  async clearance(options) {
+    return this.client._post("/api/v1/canadiantire/clearance", options);
+  }
+  /**
+   * Items on a deal at one store, 100 per page: sale prices, instant rebates,
+   * special buys or Triangle Rewards loyalty offers, with the same fields as
+   * search().
+   *
+   * Costs 1 credit.
+   */
+  async deals(options) {
+    return this.client._post("/api/v1/canadiantire/deals", options);
+  }
+};
+
+// src/namespaces/dollar-general.ts
+var DollarGeneralNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Dollar General at one store: that store's price and original price,
+   * available_quantity (units on hand at that store), inventory_status,
+   * rating, review count, categories, digital coupons and promotions, UPC and
+   * product URL.
+   *
+   * Costs 1 credit.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/dollargeneral/search", options);
+  }
+  /**
+   * One product by UPC at one store: price, original price,
+   * available_quantity, stock_status, nearby_stores_with_stock, rating, review
+   * count, SKU, brand, description, highlights, images, categories, digital
+   * coupons and promotions. An unknown UPC or store number is a 404.
+   *
+   * Costs 1 credit.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/dollargeneral/product", options);
+  }
+  /**
+   * Dollar General stores near a US ZIP code or coordinates, nearest first (up
+   * to 25): store_id, address, phone, coordinates, distance in miles, opening
+   * hours and services. Pass upc and each store also carries its unit count of
+   * that product.
+   *
+   * Costs 1 credit.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/dollargeneral/stores", options);
+  }
+  /**
+   * Products on sale or on clearance, priced and stocked at one store, 24 per
+   * page. available_quantity > 0 means in stock at that store; the listing
+   * covers the whole chain. Clearance items carry the current price only (no
+   * was-price).
+   *
+   * Costs 1 credit.
+   */
+  async deals(options) {
+    return this.client._post("/api/v1/dollargeneral/deals", options);
+  }
+  /**
+   * Dollar General's current digital coupons, 30 per page: offer id and code,
+   * summary, description, brand, company, value, offer type, category, minimum
+   * quantity, start and expiration dates, and whether it is a manufacturer
+   * coupon.
+   *
+   * Costs 1 credit.
+   */
+  async coupons(options = {}) {
+    return this.client._post("/api/v1/dollargeneral/coupons", options);
+  }
+};
+
 // src/namespaces/trustpilot.ts
 var TrustpilotNamespace = class {
   constructor(client) {
@@ -3314,6 +3567,10 @@ var Scavio = class extends ScavioCore {
   kroger;
   decathlon;
   specs;
+  lowes;
+  samsClub;
+  canadianTire;
+  dollarGeneral;
   trustpilot;
   chatgpt;
   gemini;
@@ -3377,6 +3634,10 @@ var Scavio = class extends ScavioCore {
     this.kroger = new KrogerNamespace(this);
     this.decathlon = new DecathlonNamespace(this);
     this.specs = new SpecsNamespace(this);
+    this.lowes = new LowesNamespace(this);
+    this.samsClub = new SamsClubNamespace(this);
+    this.canadianTire = new CanadianTireNamespace(this);
+    this.dollarGeneral = new DollarGeneralNamespace(this);
     this.trustpilot = new TrustpilotNamespace(this);
     this.chatgpt = new ChatgptNamespace(this);
     this.gemini = new GeminiNamespace(this);
@@ -3491,11 +3752,13 @@ export {
   AppStoreNamespace,
   BadRequestError,
   BookingNamespace,
+  CanadianTireNamespace,
   CapterraNamespace,
   ChatgptNamespace,
   CompaniesHouseNamespace,
   CostcoNamespace,
   DEFAULT_MAX_REQUESTS_PER_SECOND,
+  DollarGeneralNamespace,
   EbayNamespace,
   ExtractNamespace,
   G2Namespace,
@@ -3513,6 +3776,7 @@ export {
   KrogerNamespace,
   KuaishouNamespace,
   LinkedInNamespace,
+  LowesNamespace,
   MAX_REQUESTS_PER_SECOND,
   MercadoLibreNamespace,
   MetaAdsNamespace,
@@ -3524,6 +3788,7 @@ export {
   RedfinNamespace,
   RightmoveNamespace,
   SECNamespace,
+  SamsClubNamespace,
   Scavio,
   ScavioAPIError,
   ScavioConnectionError,