scavio 0.15.0 → 0.18.0

package/dist/index.js

@@ -611,7 +611,11 @@ var WalmartNamespace = class {
    * Structured Walmart search results: `products[]`, `products_count` and the
    * resolved `location`. Page through with `page` (1-indexed).
    *
-   * Costs 1 credit for `domain` "com" or "ca", 2 credits for "com.mx".
+   * Pass `delivery_zip` + `store_id` to get one store's results (walmart.com
+   * and walmart.ca); `data.location` confirms the store.
+   *
+   * Costs 1 credit for `domain` "com" or "ca", 2 credits for "com.mx", and 2
+   * credits when store-targeted.
    */
   async search(options) {
     return this.client._post("/api/v1/walmart/search", options);
@@ -620,8 +624,11 @@ var WalmartNamespace = class {
    * Full product detail: price, rating, images, specifications, availability
    * and seller.
    *
-   * Costs 1 credit. Walmart.ca product pages are not fetchable, so this is
-   * walmart.com only.
+   * Pass `delivery_zip` + `store_id` for one store's price and availability.
+   * `domain: "ca"` is available only together with a store target.
+   *
+   * Costs 1 credit, or 2 when store-targeted. A store that does not carry the
+   * item returns 404.
    */
   async product(options) {
     return this.client._post("/api/v1/walmart/product", options);
@@ -672,6 +679,20 @@ var WalmartNamespace = class {
   async sellerProducts(options) {
     return this.client._post("/api/v1/walmart/seller-products", options);
   }
+  /**
+   * Walmart stores near a US ZIP (or a Canadian postal code with `domain: "ca"`),
+   * nearest first, with `store_id`, address, distance, coordinates and hours.
+   * Use a `store_id` with `delivery_zip` on `search()` or `product()`, on the
+   * same domain, to target that store.
+   *
+   * Costs 1 credit.
+   */
+  async stores(options) {
+    return await this.client._post(
+      "/api/v1/walmart/stores",
+      options
+    );
+  }
 };
 
 // src/namespaces/youtube.ts
@@ -2236,7 +2257,144 @@ var MetaAdsNamespace = class {
   }
 };
 
+// src/namespaces/costco.ts
+var CostcoNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Costco by keyword or item number: online price and original price,
+   * ratings, member-only and stock flags, promotions and facets. Pass
+   * `warehouse_id` to add that warehouse's in-store price and stock to every
+   * result.
+   *
+   * Costs 1 credit.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/costco/search", options);
+  }
+  /**
+   * Products in a Costco category, with the same sort, filters and
+   * per-warehouse pricing as search().
+   *
+   * Costs 1 credit.
+   */
+  async category(options) {
+    return this.client._post("/api/v1/costco/category", options);
+  }
+  /**
+   * The Costco department list, or the full subcategory tree under one
+   * department when `category_id` is set.
+   *
+   * Costs 1 credit.
+   */
+  async categories(options = {}) {
+    return this.client._post("/api/v1/costco/categories", options);
+  }
+  /**
+   * Full details for up to 20 items: description, features, specifications,
+   * variants, member-only and purchase limits, delivery fee, and promotions
+   * with start and end dates. Pass `item_id` or `item_ids`.
+   *
+   * Costs 1 credit.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/costco/product", options);
+  }
+  /**
+   * Online price versus in-warehouse price for up to 20 items across up to 10
+   * warehouses, with each location's discount, final price, promotion dates
+   * and price code.
+   *
+   * Costs 1 credit for up to 9 warehouses and 2 credits for 10.
+   */
+  async prices(options) {
+    return this.client._post("/api/v1/costco/prices", options);
+  }
+  /**
+   * In-warehouse stock status for one item at up to 10 warehouses, plus
+   * pickup and same-day delivery availability. A status, never a quantity.
+   *
+   * Costs 1 credit per 5 warehouses.
+   */
+  async availability(options) {
+    return this.client._post("/api/v1/costco/availability", options);
+  }
+  /**
+   * Customer reviews for a Costco product with the rating distribution and
+   * recommend count; sort, star filter and up to 100 reviews per page.
+   *
+   * Costs 1 credit.
+   */
+  async reviews(options) {
+    return this.client._post("/api/v1/costco/reviews", options);
+  }
+  /**
+   * Costco warehouses near a US zip code or coordinates, nearest first:
+   * warehouse_id, address, hours, departments, services, and gas station hours
+   * and prices.
+   *
+   * Costs 1 credit, or 2 with country "ca".
+   */
+  async warehouses(options) {
+    return this.client._post("/api/v1/costco/warehouses", options);
+  }
+  /**
+   * Current regular, premium and diesel prices at Costco gas stations near a
+   * location, or at specific warehouses.
+   *
+   * Costs 1 credit by location (2 with country "ca"); by `warehouse_ids`,
+   * 1 credit per 5 warehouses on us and 2 credits per warehouse on ca.
+   */
+  async gas(options) {
+    return this.client._post("/api/v1/costco/gas", options);
+  }
+  /**
+   * The current Costco member coupon book (US): every offer with its item
+   * number, discount, final price, warehouse/online scope, limits and the
+   * book's valid dates. Takes no parameters.
+   *
+   * Costs 1 credit.
+   */
+  async coupons(options = {}) {
+    return this.client._post("/api/v1/costco/coupons", options);
+  }
+  /**
+   * Costco deal feeds: new items, while supplies last, treasure hunt, member
+   * favorites, online-only and everything on sale, with the same filters and
+   * optional per-warehouse pricing as search().
+   *
+   * Costs 1 credit.
+   */
+  async deals(options) {
+    return this.client._post("/api/v1/costco/deals", options);
+  }
+  /**
+   * Markdown finder for one warehouse: scans a query or category and keeps
+   * the items whose in-warehouse price ends in a markdown code - .97
+   * clearance and .00/.88 manager markdown by default, .49/.79/.89 special
+   * buys on request. The codes are the member-community decode; Costco does
+   * not publish them. Only items Costco lists online are covered.
+   *
+   * Costs 1 credit.
+   */
+  async clearance(options) {
+    return this.client._post("/api/v1/costco/clearance", options);
+  }
+  /**
+   * Costco search-box suggestions for a partial query.
+   *
+   * Costs 1 credit.
+   */
+  async autocomplete(options) {
+    return this.client._post("/api/v1/costco/autocomplete", options);
+  }
+};
+
 // src/client.ts
+var DEFAULT_MAX_REQUESTS_PER_SECOND = 1;
+var MAX_REQUESTS_PER_SECOND = 50;
 var Scavio = class {
   google;
   amazon;
@@ -2269,6 +2427,7 @@ var Scavio = class {
   companiesHouse;
   googleAds;
   metaAds;
+  costco;
   apiKey;
   baseUrl;
   timeout;
@@ -2282,9 +2441,11 @@ var Scavio = class {
     this.baseUrl = (config?.baseUrl ?? BASE_URL).replace(/\/+$/, "");
     this.timeout = config?.timeout ?? DEFAULT_TIMEOUT;
     this.maxRetries = config?.maxRetries ?? DEFAULT_MAX_RETRIES;
-    const rps = config?.maxRequestsPerSecond ?? 1;
-    if (rps < 1 || rps > 10) {
-      throw new ScavioError("maxRequestsPerSecond must be between 1 and 10");
+    const rps = config?.maxRequestsPerSecond ?? DEFAULT_MAX_REQUESTS_PER_SECOND;
+    if (rps < 1 || rps > MAX_REQUESTS_PER_SECOND) {
+      throw new ScavioError(
+        `maxRequestsPerSecond must be between 1 and ${MAX_REQUESTS_PER_SECOND}`
+      );
     }
     this.rateLimiter = new RateLimiter(rps);
     this.google = new GoogleNamespace(this);
@@ -2318,6 +2479,7 @@ var Scavio = class {
     this.companiesHouse = new CompaniesHouseNamespace(this);
     this.googleAds = new GoogleAdsNamespace(this);
     this.metaAds = new MetaAdsNamespace(this);
+    this.costco = new CostcoNamespace(this);
   }
   /** @internal */
   async _post(path, body) {
@@ -2382,6 +2544,8 @@ export {
   BookingNamespace,
   CapterraNamespace,
   CompaniesHouseNamespace,
+  CostcoNamespace,
+  DEFAULT_MAX_REQUESTS_PER_SECOND,
   EbayNamespace,
   G2Namespace,
   GlassdoorNamespace,
@@ -2395,6 +2559,7 @@ export {
   InvalidAPIKeyError,
   KuaishouNamespace,
   LinkedInNamespace,
+  MAX_REQUESTS_PER_SECOND,
   MetaAdsNamespace,
   MissingAPIKeyError,
   NotFoundError,