scavio 0.28.0 → 0.28.2

package/dist/index.d.cts

@@ -4873,8 +4873,14 @@ interface HebSearchOptions {
     query: string;
     /** Results page, 1-based (1-100). */
     page?: number;
-    /** Results per page (1-60; server default 30). */
+    /** Results per page (1-60; server default 60). */
     page_size?: number;
+    /**
+     * HEB store number from stores() (field store_number), e.g. "441". Prices,
+     * stock, aisle location and assortment come from that store, echoed in
+     * data.store. US only. Omit for HEB's default store.
+     */
+    store_id?: string | number;
     [key: string]: unknown;
 }
 interface HebProductOptions {
@@ -4884,10 +4890,19 @@ interface HebProductOptions {
      * Preferred over slug + product_id.
      */
     product_url?: string;
-    /** HEB product id (numeric id at the end of a product URL). Requires slug. */
+    /**
+     * HEB product id (numeric id at the end of a product URL). Requires slug,
+     * unless store_id is set.
+     */
     product_id?: string;
-    /** Product slug (readable part of the URL). Required with product_id. */
+    /** Product slug (readable part of the URL). Required with product_id, unless store_id is set. */
     slug?: string;
+    /**
+     * HEB store number from stores() (field store_number), e.g. "441". Price,
+     * stock and aisle location come from that store, echoed in data.store. US
+     * only. Omit for HEB's default store.
+     */
+    store_id?: string | number;
     [key: string]: unknown;
 }
 interface HebStoresOptions {
@@ -4903,7 +4918,7 @@ declare class HebNamespace {
     /**
      * Search HEB grocery products by keyword: price (cents), sale status, unit
      * price, size, UPC, stock, EBT/SNAP eligibility, aisle location and product
-     * URL.
+     * URL. Pass store_id for one store's prices, stock and assortment.
      *
      * Costs 2 credits.
      */
@@ -4911,7 +4926,8 @@ declare class HebNamespace {
     /**
      * 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.
+     * product_url (from search()) or slug + product_id, or product_id alone
+     * with store_id.
      *
      * Costs 2 credits.
      */
@@ -4967,6 +4983,50 @@ declare class KrogerNamespace {
     product(options: KrogerProductOptions): Promise<Record<string, unknown>>;
 }
 
+type DecathlonCountry = "fr" | "es" | "it" | "in" | "uk" | "pt" | "net";
+interface DecathlonSearchOptions {
+    /** Search keywords (1-200 characters). */
+    query: string;
+    /** Country domain. */
+    country: DecathlonCountry;
+    /** Results page, 1-based (1-50). */
+    page?: number;
+    [key: string]: unknown;
+}
+interface DecathlonProductOptions {
+    /**
+     * Full or relative product URL from any Decathlon domain (e.g.
+     * "/p/mens-running-shoes/123456/..."). Preferred.
+     */
+    product_url?: string;
+    /** Decathlon numeric product ID (from the /p/{slug}/{id}/... URL pattern). */
+    product_id?: string;
+    /** Country domain. */
+    country: DecathlonCountry;
+    [key: string]: unknown;
+}
+declare class DecathlonNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Search Decathlon products by keyword across 7 country domains (FR, ES, IT,
+     * IN, UK, PT, NET). Returns product name, brand, price (cents), currency,
+     * availability, rating, review count and image.
+     *
+     * Costs 2 credits.
+     */
+    search(options: DecathlonSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * Full Decathlon product detail by URL or product ID: description, images,
+     * SKU, GTIN, color, price (cents), list price, availability, offers/variants,
+     * rating, review count, category and breadcrumbs. Supports all 7 country
+     * domains.
+     *
+     * Costs 2 credits.
+     */
+    product(options: DecathlonProductOptions): Promise<Record<string, unknown>>;
+}
+
 type TrustpilotReviewsDateRange = "last30days" | "last3months" | "last6months" | "last12months";
 type TrustpilotReviewsSort = "recency" | "relevance";
 type TrustpilotCategorySort = "most_relevant" | "reviews_count" | "latest_review";
@@ -6086,6 +6146,7 @@ declare class Scavio extends ScavioCore {
     readonly costco: CostcoNamespace;
     readonly heb: HebNamespace;
     readonly kroger: KrogerNamespace;
+    readonly decathlon: DecathlonNamespace;
     readonly trustpilot: TrustpilotNamespace;
     readonly chatgpt: ChatgptNamespace;
     readonly gemini: GeminiNamespace;

package/dist/index.d.ts

@@ -4873,8 +4873,14 @@ interface HebSearchOptions {
     query: string;
     /** Results page, 1-based (1-100). */
     page?: number;
-    /** Results per page (1-60; server default 30). */
+    /** Results per page (1-60; server default 60). */
     page_size?: number;
+    /**
+     * HEB store number from stores() (field store_number), e.g. "441". Prices,
+     * stock, aisle location and assortment come from that store, echoed in
+     * data.store. US only. Omit for HEB's default store.
+     */
+    store_id?: string | number;
     [key: string]: unknown;
 }
 interface HebProductOptions {
@@ -4884,10 +4890,19 @@ interface HebProductOptions {
      * Preferred over slug + product_id.
      */
     product_url?: string;
-    /** HEB product id (numeric id at the end of a product URL). Requires slug. */
+    /**
+     * HEB product id (numeric id at the end of a product URL). Requires slug,
+     * unless store_id is set.
+     */
     product_id?: string;
-    /** Product slug (readable part of the URL). Required with product_id. */
+    /** Product slug (readable part of the URL). Required with product_id, unless store_id is set. */
     slug?: string;
+    /**
+     * HEB store number from stores() (field store_number), e.g. "441". Price,
+     * stock and aisle location come from that store, echoed in data.store. US
+     * only. Omit for HEB's default store.
+     */
+    store_id?: string | number;
     [key: string]: unknown;
 }
 interface HebStoresOptions {
@@ -4903,7 +4918,7 @@ declare class HebNamespace {
     /**
      * Search HEB grocery products by keyword: price (cents), sale status, unit
      * price, size, UPC, stock, EBT/SNAP eligibility, aisle location and product
-     * URL.
+     * URL. Pass store_id for one store's prices, stock and assortment.
      *
      * Costs 2 credits.
      */
@@ -4911,7 +4926,8 @@ declare class HebNamespace {
     /**
      * 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.
+     * product_url (from search()) or slug + product_id, or product_id alone
+     * with store_id.
      *
      * Costs 2 credits.
      */
@@ -4967,6 +4983,50 @@ declare class KrogerNamespace {
     product(options: KrogerProductOptions): Promise<Record<string, unknown>>;
 }
 
+type DecathlonCountry = "fr" | "es" | "it" | "in" | "uk" | "pt" | "net";
+interface DecathlonSearchOptions {
+    /** Search keywords (1-200 characters). */
+    query: string;
+    /** Country domain. */
+    country: DecathlonCountry;
+    /** Results page, 1-based (1-50). */
+    page?: number;
+    [key: string]: unknown;
+}
+interface DecathlonProductOptions {
+    /**
+     * Full or relative product URL from any Decathlon domain (e.g.
+     * "/p/mens-running-shoes/123456/..."). Preferred.
+     */
+    product_url?: string;
+    /** Decathlon numeric product ID (from the /p/{slug}/{id}/... URL pattern). */
+    product_id?: string;
+    /** Country domain. */
+    country: DecathlonCountry;
+    [key: string]: unknown;
+}
+declare class DecathlonNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Search Decathlon products by keyword across 7 country domains (FR, ES, IT,
+     * IN, UK, PT, NET). Returns product name, brand, price (cents), currency,
+     * availability, rating, review count and image.
+     *
+     * Costs 2 credits.
+     */
+    search(options: DecathlonSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * Full Decathlon product detail by URL or product ID: description, images,
+     * SKU, GTIN, color, price (cents), list price, availability, offers/variants,
+     * rating, review count, category and breadcrumbs. Supports all 7 country
+     * domains.
+     *
+     * Costs 2 credits.
+     */
+    product(options: DecathlonProductOptions): Promise<Record<string, unknown>>;
+}
+
 type TrustpilotReviewsDateRange = "last30days" | "last3months" | "last6months" | "last12months";
 type TrustpilotReviewsSort = "recency" | "relevance";
 type TrustpilotCategorySort = "most_relevant" | "reviews_count" | "latest_review";
@@ -6086,6 +6146,7 @@ declare class Scavio extends ScavioCore {
     readonly costco: CostcoNamespace;
     readonly heb: HebNamespace;
     readonly kroger: KrogerNamespace;
+    readonly decathlon: DecathlonNamespace;
     readonly trustpilot: TrustpilotNamespace;
     readonly chatgpt: ChatgptNamespace;
     readonly gemini: GeminiNamespace;

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.28.0" : "0.0.0";
+var SDK_VERSION = true ? "0.28.2" : "0.0.0";
 var USER_AGENT = `scavio-js/${SDK_VERSION}`;
 function isServerRuntime() {
   const g = globalThis;
@@ -2675,7 +2675,7 @@ var HebNamespace = class {
   /**
    * Search HEB grocery products by keyword: price (cents), sale status, unit
    * price, size, UPC, stock, EBT/SNAP eligibility, aisle location and product
-   * URL.
+   * URL. Pass store_id for one store's prices, stock and assortment.
    *
    * Costs 2 credits.
    */
@@ -2685,7 +2685,8 @@ var HebNamespace = class {
   /**
    * 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.
+   * product_url (from search()) or slug + product_id, or product_id alone
+   * with store_id.
    *
    * Costs 2 credits.
    */
@@ -2733,6 +2734,35 @@ var KrogerNamespace = class {
   }
 };
 
+// src/namespaces/decathlon.ts
+var DecathlonNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Decathlon products by keyword across 7 country domains (FR, ES, IT,
+   * IN, UK, PT, NET). Returns product name, brand, price (cents), currency,
+   * availability, rating, review count and image.
+   *
+   * Costs 2 credits.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/decathlon/search", options);
+  }
+  /**
+   * Full Decathlon product detail by URL or product ID: description, images,
+   * SKU, GTIN, color, price (cents), list price, availability, offers/variants,
+   * rating, review count, category and breadcrumbs. Supports all 7 country
+   * domains.
+   *
+   * Costs 2 credits.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/decathlon/product", options);
+  }
+};
+
 // src/namespaces/trustpilot.ts
 var TrustpilotNamespace = class {
   constructor(client) {
@@ -3246,6 +3276,7 @@ var Scavio = class extends ScavioCore {
   costco;
   heb;
   kroger;
+  decathlon;
   trustpilot;
   chatgpt;
   gemini;
@@ -3307,6 +3338,7 @@ var Scavio = class extends ScavioCore {
     this.costco = new CostcoNamespace(this);
     this.heb = new HebNamespace(this);
     this.kroger = new KrogerNamespace(this);
+    this.decathlon = new DecathlonNamespace(this);
     this.trustpilot = new TrustpilotNamespace(this);
     this.chatgpt = new ChatgptNamespace(this);
     this.gemini = new GeminiNamespace(this);