shop-client 3.12.0 → 3.14.0

package/README.md

@@ -1,4 +1,4 @@
-# Shop Search
+# Shop Client
 
 [![npm version](https://badge.fury.io/js/shop-client.svg)](https://badge.fury.io/js/shop-client)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
@@ -31,8 +31,9 @@
 
 ## 🧠 Store Info Caching & Concurrency
 
-`getInfo()` uses time-based caching and in-flight request deduping to avoid redundant network calls:
+`getInfo()` validates the store URL and uses time-based caching and in-flight request deduping to avoid redundant network calls:
 
+- Validation: Ensures the URL points to a valid Shopify store (checks for specific meta tags and scripts). Throws an error if invalid.
 - Cache window: `5 minutes` (`cacheExpiry`). Fresh cached results return immediately.
   - You can configure this TTL via the `ShopClient` constructor option `cacheTTL` (milliseconds).
 - Cached fields: `infoCacheValue` (last `StoreInfo`) and `infoCacheTimestamp` (last fetch time).
@@ -205,17 +206,8 @@ Notes:
 
 ### Migration: Barrel → Subpath Imports
 
-#### Package Rename: `shop-search` → `shop-client` (v3.8.2)
-- Install: `npm i shop-client` (replaces `shop-search`)
-- Update imports to `shop-client` (API unchanged)
-
 TypeScript:
 ```ts
-// Before (pre-rename: shop-search)
-import { Store } from 'shop-search';
-const store = new Store("your-store.myshopify.com");
-
-// After (post-rename: shop-client v3.8.2+)
 import { ShopClient } from 'shop-client';
 const client = new ShopClient("your-store.myshopify.com");
 ```
@@ -354,6 +346,8 @@ const storeInfo = await shop.getInfo();
 - `headerLinks`: Navigation menu links
 - `showcase`: Featured products and collections
 - `jsonLdData`: Structured data from the store
+- `country`: ISO 3166-1 alpha-2 code (e.g., `US`, `GB`)
+- `currency`: ISO 4217 currency code (e.g., `USD`, `EUR`)
 
 ### Products
 
@@ -444,6 +438,43 @@ Object.entries(filters || {}).forEach(([optionName, values]) => {
 - Handles products with multiple variant options
 - Returns empty object `{}` if no products have variants
 
+### Predictive Search
+
+#### `products.predictiveSearch(query, options?)`
+
+Locale-aware Shopify Ajax predictive search for products.
+
+```typescript
+const results = await shop.products.predictiveSearch("dress", {
+  limit: 10,           // clamps 1–10
+  locale: "en",        // defaults to "en"
+  // unavailableProducts defaults to "hide"
+  currency: "USD",     // optional override
+});
+```
+
+- Hides unavailable items by default
+- Extracts handles from Ajax results, fetches full products via `find`
+- Falls back to non-locale path when locale returns 404/417
+
+### Recommendations
+
+#### `products.recommendations(productId, options?)`
+
+Shopify Ajax product recommendations for a given product.
+
+```typescript
+const recos = await shop.products.recommendations(1234567890, {
+  limit: 6,                 // clamps 1–10 (default 10)
+  intent: "related",        // or "complementary" (default: related)
+  locale: "en",             // defaults to "en"
+  currency: "USD",          // optional override
+});
+```
+
+- Returns normalized `Product[]`
+- Locale-aware endpoint `/{locale}/recommendations/products.json`
+
 ### Collections
 
 #### `collections.all()`

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

@@ -36,6 +36,13 @@ async function getInfoForStore(args, options) {
     const match = html.match(regex);
     return match ? match[1] : null;
   };
+  const shopifyWalletId = (_a = getMetaTag("shopify-digital-wallet")) == null ? void 0 : _a.split("/")[1];
+  const isShopifyStore = html.includes("cdn.shopify.com") || html.includes("myshopify.com") || html.includes("shopify-digital-wallet") || html.includes("Shopify.shop") || html.includes("Shopify.currency") || html.includes("shopify-section");
+  if (!isShopifyStore || !shopifyWalletId) {
+    throw new Error(
+      "The provided URL does not appear to be a valid Shopify store."
+    );
+  }
   const getPropertyMetaTag = (property) => {
     const regex = new RegExp(
       `<meta[^>]*property=["']${property}["'][^>]*content=["'](.*?)["']`
@@ -43,10 +50,9 @@ async function getInfoForStore(args, options) {
     const match = html.match(regex);
     return match ? match[1] : null;
   };
-  const name = (_a = getMetaTag("og:site_name")) != null ? _a : extractDomainWithoutSuffix(baseUrl);
-  const title = (_b = getMetaTag("og:title")) != null ? _b : getMetaTag("twitter:title");
+  const name = (_b = getMetaTag("og:site_name")) != null ? _b : extractDomainWithoutSuffix(baseUrl);
+  const title = (_c = getMetaTag("og:title")) != null ? _c : getMetaTag("twitter:title");
   const description = getMetaTag("description") || getPropertyMetaTag("og:description");
-  const shopifyWalletId = (_c = getMetaTag("shopify-digital-wallet")) == null ? void 0 : _c.split("/")[1];
   const myShopifySubdomainMatch = html.match(/['"](.*?\.myshopify\.com)['"]/);
   const myShopifySubdomain = myShopifySubdomainMatch ? myShopifySubdomainMatch[1] : null;
   let logoUrl = getPropertyMetaTag("og:image") || getPropertyMetaTag("og:image:secure_url");
@@ -188,7 +194,7 @@ async function getInfoForStore(args, options) {
       }
     )) == null ? void 0 : _p.map((json) => json ? JSON.parse(json) : null)) || [],
     techProvider: {
-      name: "shopify",
+      name: shopifyWalletId ? "shopify" : "",
       walletId: shopifyWalletId,
       subDomain: myShopifySubdomain != null ? myShopifySubdomain : null
     },
@@ -219,6 +225,7 @@ function createStoreOperations(context) {
      * - `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
      *

package/dist/index.mjs

@@ -10,7 +10,7 @@ import {
 import {
   createStoreOperations,
   getInfoForStore
-} from "./chunk-VK5666EK.mjs";
+} from "./chunk-RLVH7LEG.mjs";
 import {
   classifyProduct,
   determineStoreType,

package/dist/store.mjs

@@ -1,6 +1,6 @@
 import {
   createStoreOperations
-} from "./chunk-VK5666EK.mjs";
+} from "./chunk-RLVH7LEG.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.12.0",
+  "version": "3.14.0",
   "type": "module",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",