shop-client 3.10.0 → 3.12.0

package/dist/{chunk-MSIVKUGN.mjs → chunk-VK5666EK.mjs}

@@ -12,8 +12,8 @@ import {
 
 // src/client/get-info.ts
 import { unique } from "remeda";
-async function getInfoForStore(args) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
+async function getInfoForStore(args, options) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p;
   const {
     baseUrl,
     storeDomain,
@@ -22,7 +22,8 @@ async function getInfoForStore(args) {
     validateLinksInBatches
   } = args;
   const response = await rateLimitedFetch(baseUrl, {
-    rateLimitClass: "store:info"
+    rateLimitClass: "store:info",
+    timeoutMs: 7e3
   });
   if (!response.ok) {
     throw new Error(`HTTP error! status: ${response.status}`);
@@ -94,18 +95,22 @@ async function getInfoForStore(args) {
   )) {
     contactLinks.contactPage = (match == null ? void 0 : match[1]) || null;
   }
-  const extractedProductLinks = ((_g = (_f = html.match(/href=["']([^"']*\/products\/[^"']+)["']/g)) == null ? void 0 : _f.map(
-    (match) => {
-      var _a2, _b2;
-      return (_b2 = (_a2 = match == null ? void 0 : match.split("href=")[1]) == null ? void 0 : _a2.replace(/["']/g, "")) == null ? void 0 : _b2.split("/").at(-1);
-    }
-  )) == null ? void 0 : _g.filter(Boolean)) || [];
-  const extractedCollectionLinks = ((_i = (_h = html.match(/href=["']([^"']*\/collections\/[^"']+)["']/g)) == null ? void 0 : _h.map(
-    (match) => {
-      var _a2, _b2;
-      return (_b2 = (_a2 = match == null ? void 0 : match.split("href=")[1]) == null ? void 0 : _a2.replace(/["']/g, "")) == null ? void 0 : _b2.split("/").at(-1);
-    }
-  )) == null ? void 0 : _i.filter(Boolean)) || [];
+  const extractedProductLinks = unique(
+    ((_g = (_f = html.match(/href=["']([^"']*\/products\/[^"']+)["']/g)) == null ? void 0 : _f.map(
+      (match) => {
+        var _a2, _b2;
+        return (_b2 = (_a2 = match == null ? void 0 : match.split("href=")[1]) == null ? void 0 : _a2.replace(/["']/g, "")) == null ? void 0 : _b2.split("/").at(-1);
+      }
+    )) == null ? void 0 : _g.filter(Boolean)) || []
+  ).slice(0, 8);
+  const extractedCollectionLinks = unique(
+    ((_i = (_h = html.match(/href=["']([^"']*\/collections\/[^"']+)["']/g)) == null ? void 0 : _h.map(
+      (match) => {
+        var _a2, _b2;
+        return (_b2 = (_a2 = match == null ? void 0 : match.split("href=")[1]) == null ? void 0 : _a2.replace(/["']/g, "")) == null ? void 0 : _b2.split("/").at(-1);
+      }
+    )) == null ? void 0 : _i.filter(Boolean)) || []
+  ).slice(0, 8);
   const headerLinks = (_k = (_j = html.match(
     /<(header|nav|div|section)\b[^>]*\b(?:id|class)=["'][^"']*(?=.*shopify-section)(?=.*\b(header|navigation|nav|menu)\b)[^"']*["'][^>]*>[\s\S]*?<\/\1>/gi
   )) == null ? void 0 : _j.flatMap((header) => {
@@ -129,20 +134,37 @@ async function getInfoForStore(args) {
   })) != null ? _k : [];
   const slug = generateStoreSlug(baseUrl);
   const countryDetection = await detectShopCountry(html);
-  const [homePageProductLinks, homePageCollectionLinks] = await Promise.all([
-    validateLinksInBatches(
-      extractedProductLinks.filter(
-        (handle) => Boolean(handle)
+  const doValidate = (options == null ? void 0 : options.validateShowcase) === true;
+  let homePageProductLinks = [];
+  let homePageCollectionLinks = [];
+  if (doValidate) {
+    const batchSize = (_l = options == null ? void 0 : options.validationBatchSize) != null ? _l : 5;
+    const validated = await Promise.all([
+      validateLinksInBatches(
+        extractedProductLinks.filter(
+          (handle) => Boolean(handle)
+        ),
+        (handle) => validateProductExists(handle),
+        batchSize
       ),
-      (handle) => validateProductExists(handle)
-    ),
-    validateLinksInBatches(
-      extractedCollectionLinks.filter(
-        (handle) => Boolean(handle)
-      ),
-      (handle) => validateCollectionExists(handle)
-    )
-  ]);
+      validateLinksInBatches(
+        extractedCollectionLinks.filter(
+          (handle) => Boolean(handle)
+        ),
+        (handle) => validateCollectionExists(handle),
+        batchSize
+      )
+    ]);
+    homePageProductLinks = (_m = validated[0]) != null ? _m : [];
+    homePageCollectionLinks = (_n = validated[1]) != null ? _n : [];
+  } else {
+    homePageProductLinks = extractedProductLinks.filter(
+      (handle) => Boolean(handle)
+    );
+    homePageCollectionLinks = extractedCollectionLinks.filter(
+      (handle) => Boolean(handle)
+    );
+  }
   const info = {
     name: name || slug,
     domain: sanitizeDomain(baseUrl),
@@ -157,20 +179,21 @@ async function getInfoForStore(args) {
       products: unique(homePageProductLinks != null ? homePageProductLinks : []),
       collections: unique(homePageCollectionLinks != null ? homePageCollectionLinks : [])
     },
-    jsonLdData: ((_m = (_l = html.match(
+    jsonLdData: ((_p = (_o = html.match(
       /<script[^>]*type="application\/ld\+json"[^>]*>([^<]+)<\/script>/g
-    )) == null ? void 0 : _l.map(
+    )) == null ? void 0 : _o.map(
       (match) => {
         var _a2;
         return ((_a2 = match == null ? void 0 : match.split(">")[1]) == null ? void 0 : _a2.replace(/<\/script/g, "")) || null;
       }
-    )) == null ? void 0 : _m.map((json) => json ? JSON.parse(json) : null)) || [],
+    )) == null ? void 0 : _p.map((json) => json ? JSON.parse(json) : null)) || [],
     techProvider: {
       name: "shopify",
       walletId: shopifyWalletId,
       subDomain: myShopifySubdomain != null ? myShopifySubdomain : null
     },
-    country: countryDetection.country
+    country: countryDetection.country,
+    currency: (countryDetection == null ? void 0 : countryDetection.currencyCode) || null
   };
   const currencyCode = countryDetection == null ? void 0 : countryDetection.currencyCode;
   return { info, currencyCode };

package/dist/{chunk-CNJRHWIK.mjs → chunk-ZF4M6GMB.mjs}

@@ -450,6 +450,74 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
         console.error("Failed to create product filters:", storeDomain, error);
         throw error;
       }
+    },
+    predictiveSearch: async (query, options) => {
+      var _a, _b, _c, _d, _e;
+      if (!query || typeof query !== "string") {
+        throw new Error("Query is required and must be a string");
+      }
+      const limit = Math.max(1, Math.min((_a = options == null ? void 0 : options.limit) != null ? _a : 10, 10));
+      const unavailable = (options == null ? void 0 : options.unavailableProducts) === "show" || (options == null ? void 0 : options.unavailableProducts) === "hide" ? options.unavailableProducts : "hide";
+      const localeValue = (options == null ? void 0 : options.locale) && options.locale.trim() || "en";
+      const localePrefix = `${localeValue.replace(/^\/|\/$/g, "")}/`;
+      const url = `${baseUrl}${localePrefix}search/suggest.json?q=${encodeURIComponent(query)}&resources[type]=product&resources[limit]=${limit}&resources[options][unavailable_products]=${unavailable}`;
+      const response = await rateLimitedFetch(url, {
+        rateLimitClass: "search:predictive",
+        timeoutMs: 7e3,
+        retry: { maxRetries: 2, baseDelayMs: 300 }
+      });
+      let resp = response;
+      if (!resp.ok && (resp.status === 404 || resp.status === 417)) {
+        const fallbackUrl = `${baseUrl}search/suggest.json?q=${encodeURIComponent(query)}&resources[type]=product&resources[limit]=${limit}&resources[options][unavailable_products]=${unavailable}`;
+        resp = await rateLimitedFetch(fallbackUrl, {
+          rateLimitClass: "search:predictive",
+          timeoutMs: 7e3,
+          retry: { maxRetries: 2, baseDelayMs: 300 }
+        });
+      }
+      if (!resp.ok) {
+        throw new Error(`HTTP ${resp.status}: ${resp.statusText}`);
+      }
+      const data = await resp.json();
+      const raw = (_d = (_c = (_b = data == null ? void 0 : data.resources) == null ? void 0 : _b.results) == null ? void 0 : _c.products) != null ? _d : [];
+      const handles = raw.filter((p) => {
+        var _a2;
+        return Boolean((_a2 = p == null ? void 0 : p.available) != null ? _a2 : true);
+      }).map((p) => {
+        var _a2;
+        return String((_a2 = p == null ? void 0 : p.handle) != null ? _a2 : "");
+      }).filter((h) => h.length > 0).slice(0, limit);
+      const fetched = await Promise.all(handles.map((h) => findProduct(h)));
+      const results = filter(fetched, isNonNullish);
+      const finalProducts = (_e = maybeOverrideProductsCurrency(results, options == null ? void 0 : options.currency)) != null ? _e : [];
+      return finalProducts;
+    },
+    recommendations: async (productId, options) => {
+      var _a, _b;
+      if (!Number.isFinite(productId) || productId <= 0) {
+        throw new Error("Valid productId is required");
+      }
+      const limit = Math.max(1, Math.min((_a = options == null ? void 0 : options.limit) != null ? _a : 10, 10));
+      const intent = (options == null ? void 0 : options.intent) === "complementary" ? "complementary" : "related";
+      const localeValue = (options == null ? void 0 : options.locale) && options.locale.trim() || "en";
+      const localePrefix = `${localeValue.replace(/^\/|\/$/g, "")}/`;
+      const url = `${baseUrl}${localePrefix}recommendations/products.json?product_id=${encodeURIComponent(String(productId))}&limit=${limit}&intent=${intent}`;
+      const resp = await rateLimitedFetch(url, {
+        rateLimitClass: "products:recommendations",
+        timeoutMs: 7e3,
+        retry: { maxRetries: 2, baseDelayMs: 300 }
+      });
+      if (!resp.ok) {
+        if (resp.status === 404) {
+          return [];
+        }
+        throw new Error(`HTTP ${resp.status}: ${resp.statusText}`);
+      }
+      const data = await resp.json();
+      const productsArray = Array.isArray(data) ? data : Array.isArray(data == null ? void 0 : data.products) ? data.products : [];
+      const normalized = productsDto(productsArray) || [];
+      const finalProducts = (_b = maybeOverrideProductsCurrency(normalized, options == null ? void 0 : options.currency)) != null ? _b : [];
+      return finalProducts;
     }
   };
   return operations;

package/dist/index.d.ts

@@ -132,6 +132,7 @@ declare class ShopClient {
      * - `jsonLdData` - Structured data from JSON-LD scripts
      * - `techProvider` - Shopify-specific information (walletId, subDomain)
      * - `country` - Country detection results with ISO 3166-1 alpha-2 codes (e.g., "US", "GB")
+     * - `currency` - ISO 4217 currency code inferred from store (e.g., "USD")
      *
      * @throws {Error} When the store URL is unreachable or returns an error
      *
@@ -153,6 +154,8 @@ declare class ShopClient {
      */
     getInfo(options?: {
         force?: boolean;
+        validateShowcase?: boolean;
+        validationBatchSize?: number;
     }): Promise<StoreInfo>;
     /**
      * Manually clear the cached store info.

package/dist/index.mjs

@@ -6,11 +6,11 @@ import {
 } from "./chunk-554O5ED6.mjs";
 import {
   createProductOperations
-} from "./chunk-CNJRHWIK.mjs";
+} from "./chunk-ZF4M6GMB.mjs";
 import {
   createStoreOperations,
   getInfoForStore
-} from "./chunk-MSIVKUGN.mjs";
+} from "./chunk-VK5666EK.mjs";
 import {
   classifyProduct,
   determineStoreType,
@@ -568,7 +568,8 @@ var ShopClient = class {
       const url = `${this.baseUrl}products/${handle}.js`;
       const response = await rateLimitedFetch(url, {
         method: "HEAD",
-        rateLimitClass: "validate:product"
+        rateLimitClass: "validate:product",
+        timeoutMs: 5e3
       });
       const exists = response.ok;
       this.setCacheValue(cacheKey, exists);
@@ -590,7 +591,8 @@ var ShopClient = class {
       const url = `${this.baseUrl}collections/${handle}.json`;
       const response = await rateLimitedFetch(url, {
         method: "HEAD",
-        rateLimitClass: "validate:collection"
+        rateLimitClass: "validate:collection",
+        timeoutMs: 5e3
       });
       const exists = response.ok;
       this.setCacheValue(cacheKey, exists);
@@ -654,6 +656,7 @@ var ShopClient = class {
    * - `jsonLdData` - Structured data from JSON-LD scripts
    * - `techProvider` - Shopify-specific information (walletId, subDomain)
    * - `country` - Country detection results with ISO 3166-1 alpha-2 codes (e.g., "US", "GB")
+   * - `currency` - ISO 4217 currency code inferred from store (e.g., "USD")
    *
    * @throws {Error} When the store URL is unreachable or returns an error
    *
@@ -685,13 +688,19 @@ var ShopClient = class {
         return await this.infoInFlight;
       }
       this.infoInFlight = (async () => {
-        const { info, currencyCode } = await getInfoForStore({
-          baseUrl: this.baseUrl,
-          storeDomain: this.storeDomain,
-          validateProductExists: (handle) => this.validateProductExists(handle),
-          validateCollectionExists: (handle) => this.validateCollectionExists(handle),
-          validateLinksInBatches: (items, validator, batchSize) => this.validateLinksInBatches(items, validator, batchSize)
-        });
+        const { info, currencyCode } = await getInfoForStore(
+          {
+            baseUrl: this.baseUrl,
+            storeDomain: this.storeDomain,
+            validateProductExists: (handle) => this.validateProductExists(handle),
+            validateCollectionExists: (handle) => this.validateCollectionExists(handle),
+            validateLinksInBatches: (items, validator, batchSize) => this.validateLinksInBatches(items, validator, batchSize)
+          },
+          {
+            validateShowcase: (options == null ? void 0 : options.validateShowcase) === true,
+            validationBatchSize: options == null ? void 0 : options.validationBatchSize
+          }
+        );
         if (typeof currencyCode === "string") {
           this.storeCurrency = currencyCode;
         }

package/dist/products.d.ts

@@ -55,6 +55,24 @@ interface ProductOperations {
      * Creates a filter map of variant options and their distinct values from all products.
      */
     filter(): Promise<Record<string, string[]> | null>;
+    /**
+     * Predictive product search using Shopify Ajax API.
+     */
+    predictiveSearch(query: string, options?: {
+        limit?: number;
+        locale?: string;
+        currency?: CurrencyCode;
+        unavailableProducts?: "show" | "hide" | "last";
+    }): Promise<Product[]>;
+    /**
+     * Product recommendations for a given product ID using Shopify Ajax API.
+     */
+    recommendations(productId: number, options?: {
+        limit?: number;
+        intent?: "related" | "complementary";
+        locale?: string;
+        currency?: CurrencyCode;
+    }): Promise<Product[] | null>;
 }
 /**
  * Creates product operations for a store instance

package/dist/products.mjs

@@ -1,6 +1,6 @@
 import {
   createProductOperations
-} from "./chunk-CNJRHWIK.mjs";
+} from "./chunk-ZF4M6GMB.mjs";
 import "./chunk-D5MTUWFO.mjs";
 import "./chunk-U3RQRBXZ.mjs";
 export {

package/dist/store.d.ts

@@ -1,4 +1,4 @@
-import { J as JsonLdEntry, d as CountryDetectionResult } from './types-luPg5O08.js';
+import { J as JsonLdEntry, d as CountryDetectionResult, f as CurrencyCode } from './types-luPg5O08.js';
 
 /**
  * Store operations interface for managing store-related functionality.
@@ -36,6 +36,7 @@ interface StoreInfo {
         subDomain: string | null;
     };
     country: CountryDetectionResult["country"];
+    currency: CurrencyCode | null;
 }
 /**
  * Creates store operations for a ShopClient instance.

package/dist/store.mjs

@@ -1,6 +1,6 @@
 import {
   createStoreOperations
-} from "./chunk-MSIVKUGN.mjs";
+} from "./chunk-VK5666EK.mjs";
 import "./chunk-D5MTUWFO.mjs";
 import "./chunk-G7OCMGA6.mjs";
 import "./chunk-U3RQRBXZ.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shop-client",
-  "version": "3.10.0",
+  "version": "3.12.0",
   "type": "module",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",