scavio 0.28.1 → 0.29.0

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.
      */
@@ -5011,6 +5027,109 @@ declare class DecathlonNamespace {
     product(options: DecathlonProductOptions): Promise<Record<string, unknown>>;
 }
 
+interface TotalWineSearchOptions {
+    /** Search keywords (1-200 characters). */
+    query: string;
+    /** Total Wine store number from stores(), e.g. "503". */
+    store_id: string;
+    /** Results page, 1-based (1-50). 24 results per page. */
+    page?: number;
+    [key: string]: unknown;
+}
+interface TotalWineProductOptions {
+    /** Numeric product id from search() or the URL's /p/<id>, e.g. "96260175". */
+    product_id?: string;
+    /** Total Wine product URL ending in /p/<id>. */
+    product_url?: string;
+    /** Total Wine store number from stores(), e.g. "503". */
+    store_id: string;
+    [key: string]: unknown;
+}
+interface TotalWineStoresOptions {
+    /** ZIP code, city, or "city, state", e.g. "78801". */
+    query: string;
+    /** Radius in miles (1-200). Defaults to 50. */
+    radius?: number;
+    [key: string]: unknown;
+}
+declare class TotalWineNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Search Total Wine at one store: that store's price (cents), units in
+     * stock, purchase limit, aisle, size, rating and pickup/delivery/shipping
+     * availability. When the store carries none of the matches, products is
+     * empty and searched_all_stores is true.
+     *
+     * Costs 2 credits.
+     */
+    search(options: TotalWineSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * One Total Wine product at one store: price (cents), units in stock, aisle,
+     * bay, shelf, last restock date, ABV, taste profile, characteristics and
+     * breadcrumbs. Pass product_id or product_url.
+     *
+     * Costs 2 credits.
+     */
+    product(options: TotalWineProductOptions): Promise<Record<string, unknown>>;
+    /**
+     * Total Wine stores near a ZIP code or city, nearest first: store_id,
+     * address, phone, coordinates, distance in miles and delivery availability.
+     *
+     * Costs 2 credits.
+     */
+    stores(options: TotalWineStoresOptions): Promise<Record<string, unknown>>;
+}
+
+type SpecsRegion = "austin" | "corpus-christi" | "dallas" | "el-paso" | "fort-worth" | "houston" | "san-antonio";
+interface SpecsSearchOptions {
+    /** Search keywords (1-200 characters). */
+    query: string;
+    /** Results page, 1-based (1-50). 24 results per page. */
+    page?: number;
+    [key: string]: unknown;
+}
+interface SpecsProductOptions {
+    /** Product slug from search(), e.g. "titos-texas-vodka-5". */
+    slug?: string;
+    /** Spec's product URL, https://specsonline.com/shop/<type>/<slug>/. */
+    product_url?: string;
+    /** Spec's store number from stores(), e.g. "169". Puts that store's price on top. */
+    store_id?: string;
+    [key: string]: unknown;
+}
+interface SpecsStoresOptions {
+    /** Store region. */
+    region: SpecsRegion;
+    [key: string]: unknown;
+}
+declare class SpecsNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Search Spec's: online price (cents), case price and quantity, promo and
+     * Keyclub flags, stock, size, SKU, UPC and slug.
+     *
+     * Costs 1 credit.
+     */
+    search(options: SpecsSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * One Spec's product with every store's price and stock in store_prices,
+     * the online price, and ABV, origin, region, vintage and tasting notes.
+     * Pass slug or product_url.
+     *
+     * Costs 1 credit.
+     */
+    product(options: SpecsProductOptions): Promise<Record<string, unknown>>;
+    /**
+     * Spec's stores in a Texas region: store_id, name, status, address, phone,
+     * coordinates and opening hours.
+     *
+     * Costs 1 credit.
+     */
+    stores(options: SpecsStoresOptions): Promise<Record<string, unknown>>;
+}
+
 type TrustpilotReviewsDateRange = "last30days" | "last3months" | "last6months" | "last12months";
 type TrustpilotReviewsSort = "recency" | "relevance";
 type TrustpilotCategorySort = "most_relevant" | "reviews_count" | "latest_review";
@@ -6131,6 +6250,8 @@ declare class Scavio extends ScavioCore {
     readonly heb: HebNamespace;
     readonly kroger: KrogerNamespace;
     readonly decathlon: DecathlonNamespace;
+    readonly totalwine: TotalWineNamespace;
+    readonly specs: SpecsNamespace;
     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.
      */
@@ -5011,6 +5027,109 @@ declare class DecathlonNamespace {
     product(options: DecathlonProductOptions): Promise<Record<string, unknown>>;
 }
 
+interface TotalWineSearchOptions {
+    /** Search keywords (1-200 characters). */
+    query: string;
+    /** Total Wine store number from stores(), e.g. "503". */
+    store_id: string;
+    /** Results page, 1-based (1-50). 24 results per page. */
+    page?: number;
+    [key: string]: unknown;
+}
+interface TotalWineProductOptions {
+    /** Numeric product id from search() or the URL's /p/<id>, e.g. "96260175". */
+    product_id?: string;
+    /** Total Wine product URL ending in /p/<id>. */
+    product_url?: string;
+    /** Total Wine store number from stores(), e.g. "503". */
+    store_id: string;
+    [key: string]: unknown;
+}
+interface TotalWineStoresOptions {
+    /** ZIP code, city, or "city, state", e.g. "78801". */
+    query: string;
+    /** Radius in miles (1-200). Defaults to 50. */
+    radius?: number;
+    [key: string]: unknown;
+}
+declare class TotalWineNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Search Total Wine at one store: that store's price (cents), units in
+     * stock, purchase limit, aisle, size, rating and pickup/delivery/shipping
+     * availability. When the store carries none of the matches, products is
+     * empty and searched_all_stores is true.
+     *
+     * Costs 2 credits.
+     */
+    search(options: TotalWineSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * One Total Wine product at one store: price (cents), units in stock, aisle,
+     * bay, shelf, last restock date, ABV, taste profile, characteristics and
+     * breadcrumbs. Pass product_id or product_url.
+     *
+     * Costs 2 credits.
+     */
+    product(options: TotalWineProductOptions): Promise<Record<string, unknown>>;
+    /**
+     * Total Wine stores near a ZIP code or city, nearest first: store_id,
+     * address, phone, coordinates, distance in miles and delivery availability.
+     *
+     * Costs 2 credits.
+     */
+    stores(options: TotalWineStoresOptions): Promise<Record<string, unknown>>;
+}
+
+type SpecsRegion = "austin" | "corpus-christi" | "dallas" | "el-paso" | "fort-worth" | "houston" | "san-antonio";
+interface SpecsSearchOptions {
+    /** Search keywords (1-200 characters). */
+    query: string;
+    /** Results page, 1-based (1-50). 24 results per page. */
+    page?: number;
+    [key: string]: unknown;
+}
+interface SpecsProductOptions {
+    /** Product slug from search(), e.g. "titos-texas-vodka-5". */
+    slug?: string;
+    /** Spec's product URL, https://specsonline.com/shop/<type>/<slug>/. */
+    product_url?: string;
+    /** Spec's store number from stores(), e.g. "169". Puts that store's price on top. */
+    store_id?: string;
+    [key: string]: unknown;
+}
+interface SpecsStoresOptions {
+    /** Store region. */
+    region: SpecsRegion;
+    [key: string]: unknown;
+}
+declare class SpecsNamespace {
+    private client;
+    constructor(client: Scavio);
+    /**
+     * Search Spec's: online price (cents), case price and quantity, promo and
+     * Keyclub flags, stock, size, SKU, UPC and slug.
+     *
+     * Costs 1 credit.
+     */
+    search(options: SpecsSearchOptions): Promise<Record<string, unknown>>;
+    /**
+     * One Spec's product with every store's price and stock in store_prices,
+     * the online price, and ABV, origin, region, vintage and tasting notes.
+     * Pass slug or product_url.
+     *
+     * Costs 1 credit.
+     */
+    product(options: SpecsProductOptions): Promise<Record<string, unknown>>;
+    /**
+     * Spec's stores in a Texas region: store_id, name, status, address, phone,
+     * coordinates and opening hours.
+     *
+     * Costs 1 credit.
+     */
+    stores(options: SpecsStoresOptions): Promise<Record<string, unknown>>;
+}
+
 type TrustpilotReviewsDateRange = "last30days" | "last3months" | "last6months" | "last12months";
 type TrustpilotReviewsSort = "recency" | "relevance";
 type TrustpilotCategorySort = "most_relevant" | "reviews_count" | "latest_review";
@@ -6131,6 +6250,8 @@ declare class Scavio extends ScavioCore {
     readonly heb: HebNamespace;
     readonly kroger: KrogerNamespace;
     readonly decathlon: DecathlonNamespace;
+    readonly totalwine: TotalWineNamespace;
+    readonly specs: SpecsNamespace;
     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.1" : "0.0.0";
+var SDK_VERSION = true ? "0.29.0" : "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.
    */
@@ -2762,6 +2763,80 @@ var DecathlonNamespace = class {
   }
 };
 
+// src/namespaces/totalwine.ts
+var TotalWineNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Total Wine at one store: that store's price (cents), units in
+   * stock, purchase limit, aisle, size, rating and pickup/delivery/shipping
+   * availability. When the store carries none of the matches, products is
+   * empty and searched_all_stores is true.
+   *
+   * Costs 2 credits.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/totalwine/search", options);
+  }
+  /**
+   * One Total Wine product at one store: price (cents), units in stock, aisle,
+   * bay, shelf, last restock date, ABV, taste profile, characteristics and
+   * breadcrumbs. Pass product_id or product_url.
+   *
+   * Costs 2 credits.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/totalwine/product", options);
+  }
+  /**
+   * Total Wine stores near a ZIP code or city, nearest first: store_id,
+   * address, phone, coordinates, distance in miles and delivery availability.
+   *
+   * Costs 2 credits.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/totalwine/stores", options);
+  }
+};
+
+// src/namespaces/specs.ts
+var SpecsNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search Spec's: online price (cents), case price and quantity, promo and
+   * Keyclub flags, stock, size, SKU, UPC and slug.
+   *
+   * Costs 1 credit.
+   */
+  async search(options) {
+    return this.client._post("/api/v1/specs/search", options);
+  }
+  /**
+   * One Spec's product with every store's price and stock in store_prices,
+   * the online price, and ABV, origin, region, vintage and tasting notes.
+   * Pass slug or product_url.
+   *
+   * Costs 1 credit.
+   */
+  async product(options) {
+    return this.client._post("/api/v1/specs/product", options);
+  }
+  /**
+   * Spec's stores in a Texas region: store_id, name, status, address, phone,
+   * coordinates and opening hours.
+   *
+   * Costs 1 credit.
+   */
+  async stores(options) {
+    return this.client._post("/api/v1/specs/stores", options);
+  }
+};
+
 // src/namespaces/trustpilot.ts
 var TrustpilotNamespace = class {
   constructor(client) {
@@ -3276,6 +3351,8 @@ var Scavio = class extends ScavioCore {
   heb;
   kroger;
   decathlon;
+  totalwine;
+  specs;
   trustpilot;
   chatgpt;
   gemini;
@@ -3338,6 +3415,8 @@ var Scavio = class extends ScavioCore {
     this.heb = new HebNamespace(this);
     this.kroger = new KrogerNamespace(this);
     this.decathlon = new DecathlonNamespace(this);
+    this.totalwine = new TotalWineNamespace(this);
+    this.specs = new SpecsNamespace(this);
     this.trustpilot = new TrustpilotNamespace(this);
     this.chatgpt = new ChatgptNamespace(this);
     this.gemini = new GeminiNamespace(this);