scavio 0.26.4 → 0.28.0

package/README.md

@@ -967,8 +967,15 @@ await client.target.search({ keyword: "office chair", store_id: "1234" });
 await client.target.category({ category_id: "5xtg6" });
 await client.target.product({ tcin: "82291396" });
 await client.target.reviews({ tcin: "82291396" });
+// In-store stock at every Target near a ZIP (new in 0.27.0)
+await client.target.availability({ tcin: "85978609", zip: "79407" });
 ```
 
+`store_id` on search, category, product and reviews sets the store for prices.
+`availability` is the in-store stock call: per store it returns units,
+in-store, pickup, curbside and ship-to-store status, distance, address and hours
+(up to 20 stores; pass `store_id` to keep one). About 3s.
+
 1 credit per call, but these are the slowest endpoints in the SDK: product about
 4s, search about 9s, category about 37s, reviews about 40s. Raise `timeout`
 accordingly. `reviews` returns at most 8 review bodies whatever `review_count`

package/dist/index.cjs

@@ -49,11 +49,13 @@ __export(index_exports, {
   GoogleAdsNamespace: () => GoogleAdsNamespace,
   GoogleNamespace: () => GoogleNamespace,
   GooglePlayNamespace: () => GooglePlayNamespace,
+  HebNamespace: () => HebNamespace,
   HomeDepotNamespace: () => HomeDepotNamespace,
   IndeedNamespace: () => IndeedNamespace,
   InstagramNamespace: () => InstagramNamespace,
   InsufficientCreditsError: () => InsufficientCreditsError,
   InvalidAPIKeyError: () => InvalidAPIKeyError,
+  KrogerNamespace: () => KrogerNamespace,
   KuaishouNamespace: () => KuaishouNamespace,
   LinkedInNamespace: () => LinkedInNamespace,
   MAX_REQUESTS_PER_SECOND: () => MAX_REQUESTS_PER_SECOND,
@@ -235,7 +237,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.26.4" : "0.0.0";
+var SDK_VERSION = true ? "0.28.0" : "0.0.0";
 var USER_AGENT = `scavio-js/${SDK_VERSION}`;
 function isServerRuntime() {
   const g = globalThis;
@@ -1529,8 +1531,8 @@ var TargetNamespace = class {
    * Target product details by TCIN: price, rating, images, specifications,
    * variants, return policy and fulfillment.
    *
-   * `store_id` is a real request param here - the price and availability you
-   * get back are the store you asked for.
+   * `store_id` is a real request param here - the price you get back is the
+   * store you asked for. For in-store stock use availability().
    *
    * Costs 1 credit. Typically ~4s. Single response, no pagination.
    */
@@ -1550,6 +1552,16 @@ var TargetNamespace = class {
   async reviews(options) {
     return this.client._post("/api/v1/target/reviews", options);
   }
+  /**
+   * In-store stock for one product at every Target store near a ZIP: units,
+   * in-store, pickup, curbside and ship-to-store status, distance, address and
+   * hours. Up to 20 stores; `store_id` narrows to one.
+   *
+   * Costs 1 credit. Typically ~3s.
+   */
+  async availability(options) {
+    return this.client._post("/api/v1/target/availability", options);
+  }
 };
 
 // src/namespaces/home-depot.ts
@@ -2746,6 +2758,73 @@ var CostcoNamespace = class {
   }
 };
 
+// src/namespaces/heb.ts
+var HebNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search HEB grocery products by keyword: price (cents), sale status, unit
+   * price, size, UPC, stock, EBT/SNAP eligibility, aisle location and product
+   * URL.
+   *
+   * Costs 2 credits.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/heb/search", options);
+  }
+  /**
+   * Full HEB product detail: nutrition facts, ingredients, description, images,
+   * similar products, coupons, EBT/SNAP eligibility and breadcrumbs. Pass
+   * product_url (from search()) or slug + product_id.
+   *
+   * Costs 2 credits.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/heb/product", options);
+  }
+  /**
+   * HEB stores near a US ZIP code or city: store number, address, phone, hours,
+   * pharmacy availability, fulfillment channels, distance and store URL.
+   *
+   * Costs 2 credits.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/heb/stores", options);
+  }
+};
+
+// src/namespaces/kroger.ts
+var KrogerNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Kroger grocery products by keyword: price (cents), promo price,
+   * n-for deals, unit price, size, UPC, stock, SNAP eligibility, dietary info,
+   * rating and category. Kroger operates Kroger, Ralphs, Fred Meyer, Harris
+   * Teeter, King Soopers, Fry's and other banners.
+   *
+   * Costs 2 credits.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/kroger/search", options);
+  }
+  /**
+   * Full Kroger product detail by URL or UPC: nutrition facts (allergens,
+   * ingredients, nutrients with daily values), description, images, rating
+   * distribution, store aisle location, stock level, dietary flags (organic,
+   * non-GMO, gluten-free), SNAP eligibility, dimensions and country of origin.
+   *
+   * Costs 2 credits.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/kroger/product", options);
+  }
+};
+
 // src/namespaces/trustpilot.ts
 var TrustpilotNamespace = class {
   constructor(client) {
@@ -3257,6 +3336,8 @@ var Scavio = class extends ScavioCore {
   googleAds;
   metaAds;
   costco;
+  heb;
+  kroger;
   trustpilot;
   chatgpt;
   gemini;
@@ -3316,6 +3397,8 @@ var Scavio = class extends ScavioCore {
     this.googleAds = new GoogleAdsNamespace(this);
     this.metaAds = new MetaAdsNamespace(this);
     this.costco = new CostcoNamespace(this);
+    this.heb = new HebNamespace(this);
+    this.kroger = new KrogerNamespace(this);
     this.trustpilot = new TrustpilotNamespace(this);
     this.chatgpt = new ChatgptNamespace(this);
     this.gemini = new GeminiNamespace(this);
@@ -3444,11 +3527,13 @@ async function getSubtle() {
   GoogleAdsNamespace,
   GoogleNamespace,
   GooglePlayNamespace,
+  HebNamespace,
   HomeDepotNamespace,
   IndeedNamespace,
   InstagramNamespace,
   InsufficientCreditsError,
   InvalidAPIKeyError,
+  KrogerNamespace,
   KuaishouNamespace,
   LinkedInNamespace,
   MAX_REQUESTS_PER_SECOND,