scavio 0.28.2 → 0.29.0

package/dist/index.d.cts

@@ -5027,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";
@@ -6147,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

@@ -5027,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";
@@ -6147,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.2" : "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;
@@ -2763,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) {
@@ -3277,6 +3351,8 @@ var Scavio = class extends ScavioCore {
   heb;
   kroger;
   decathlon;
+  totalwine;
+  specs;
   trustpilot;
   chatgpt;
   gemini;
@@ -3339,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);