shop-client 3.13.0 → 3.14.1

package/README.md

@@ -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).

package/dist/{chunk-CUL7ZM2W.mjs → chunk-7IMI76JZ.mjs}

@@ -12,7 +12,7 @@ import {
 
 // src/client/get-info.ts
 import { unique } from "remeda";
-async function getInfoForStore(args, options) {
+async function getInfoForShop(args, options) {
   var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p;
   const {
     baseUrl,
@@ -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
     },
@@ -200,7 +206,7 @@ async function getInfoForStore(args, options) {
 }
 
 // src/store.ts
-function createStoreOperations(context) {
+function createShopOperations(context) {
   return {
     /**
      * Fetches comprehensive store information including metadata, social links, and showcase content.
@@ -236,7 +242,7 @@ function createStoreOperations(context) {
      */
     info: async () => {
       try {
-        const { info } = await getInfoForStore({
+        const { info } = await getInfoForShop({
           baseUrl: context.baseUrl,
           storeDomain: context.storeDomain,
           validateProductExists: context.validateProductExists,
@@ -247,11 +253,134 @@ function createStoreOperations(context) {
       } catch (error) {
         context.handleFetchError(error, "fetching store info", context.baseUrl);
       }
+    },
+    getMetaData: async () => {
+      try {
+        const response = await rateLimitedFetch(context.baseUrl, {
+          rateLimitClass: "store:metadata",
+          timeoutMs: 7e3
+        });
+        if (!response.ok) {
+          throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        const html = await response.text();
+        const getPropertyMetaTag = (property) => {
+          const regex = new RegExp(
+            `<meta[^>]*property=["']${property}["'][^>]*content=["'](.*?)["']`
+          );
+          const match = html.match(regex);
+          return match ? match[1] : null;
+        };
+        const siteName = getPropertyMetaTag("og:site_name");
+        const title = getPropertyMetaTag("og:title");
+        const description = getPropertyMetaTag("og:description");
+        const url = getPropertyMetaTag("og:url");
+        const type = getPropertyMetaTag("og:type");
+        const image = getPropertyMetaTag("og:image");
+        const imageSecureUrl = getPropertyMetaTag("og:image:secure_url");
+        return {
+          siteName: siteName != null ? siteName : null,
+          title: title != null ? title : null,
+          description: description != null ? description : null,
+          url: url != null ? url : null,
+          type: type != null ? type : null,
+          image: image != null ? image : null,
+          imageSecureUrl: imageSecureUrl != null ? imageSecureUrl : null
+        };
+      } catch (error) {
+        context.handleFetchError(
+          error,
+          "fetching store metadata",
+          context.baseUrl
+        );
+      }
+    },
+    getJsonLd: async () => {
+      var _a, _b;
+      try {
+        const response = await rateLimitedFetch(context.baseUrl, {
+          rateLimitClass: "store:jsonld",
+          timeoutMs: 7e3
+        });
+        if (!response.ok) {
+          throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        const html = await response.text();
+        const scripts = (_b = (_a = html.match(
+          /<script[^>]*type="application\/ld\+json"[^>]*>([\s\S]*?)<\/script>/g
+        )) == null ? void 0 : _a.map(
+          (match) => match.replace(/^.*?>/, "").replace(/<\/script>$/i, "")
+        )) != null ? _b : [];
+        const parsed = scripts.map((json) => {
+          try {
+            return JSON.parse(json);
+          } catch {
+            return void 0;
+          }
+        }).filter((x) => !!x);
+        return parsed.length ? parsed : void 0;
+      } catch (error) {
+        context.handleFetchError(
+          error,
+          "fetching store JSON-LD",
+          context.baseUrl
+        );
+      }
+    },
+    getHeaderLinks: async () => {
+      var _a;
+      try {
+        const response = await rateLimitedFetch(context.baseUrl, {
+          rateLimitClass: "store:header",
+          timeoutMs: 7e3
+        });
+        if (!response.ok) {
+          throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        const html = await response.text();
+        const sections = (_a = html.match(
+          /<(header|nav|div|section)\b[^>]*\b(?:id|class)=["'][^"']*(?=.*shopify-section)(?=.*\b(header|navigation|nav|menu)\b)[^"']*["'][^>]*>[\s\S]*?<\/\1>/gi
+        )) != null ? _a : [];
+        const links = sections.flatMap((section) => {
+          var _a2;
+          return (_a2 = section.match(/href=["']([^"']+)["']/g)) != null ? _a2 : [];
+        }).map((link) => {
+          var _a2;
+          return (_a2 = link.match(/href=["']([^"']+)["']/)) == null ? void 0 : _a2[1];
+        }).filter((href) => !!href).filter(
+          (href) => href.includes("/products/") || href.includes("/collections/") || href.includes("/pages/")
+        ).map((href) => {
+          try {
+            if (href.startsWith("//"))
+              return new URL(`https:${href}`).pathname;
+            if (href.startsWith("/"))
+              return new URL(href, context.storeDomain).pathname;
+            return new URL(href).pathname;
+          } catch {
+            return href;
+          }
+        }).map((p) => p.replace(/^\/|\/$/g, ""));
+        const seen = /* @__PURE__ */ new Set();
+        const deduped = [];
+        for (const l of links) {
+          if (!seen.has(l)) {
+            seen.add(l);
+            deduped.push(l);
+          }
+        }
+        return deduped;
+      } catch (error) {
+        context.handleFetchError(
+          error,
+          "fetching header links",
+          context.baseUrl
+        );
+      }
     }
   };
 }
 
 export {
-  getInfoForStore,
-  createStoreOperations
+  getInfoForShop,
+  createShopOperations
 };

package/dist/collections.d.ts

@@ -1,4 +1,4 @@
-import { StoreInfo } from './store.js';
+import { ShopInfo } from './store.js';
 import { C as Collection, f as CurrencyCode, P as Product, b as ShopifyCollection } from './types-luPg5O08.js';
 
 /**
@@ -60,6 +60,6 @@ interface CollectionOperations {
 declare function createCollectionOperations(baseUrl: string, storeDomain: string, fetchCollections: (page: number, limit: number) => Promise<Collection[] | null>, collectionsDto: (collections: ShopifyCollection[]) => Collection[], fetchPaginatedProductsFromCollection: (collectionHandle: string, options?: {
     page?: number;
     limit?: number;
-}) => Promise<Product[] | null>, getStoreInfo: () => Promise<StoreInfo>, findCollection: (handle: string) => Promise<Collection | null>): CollectionOperations;
+}) => Promise<Product[] | null>, getStoreInfo: () => Promise<ShopInfo>, findCollection: (handle: string) => Promise<Collection | null>): CollectionOperations;
 
 export { type CollectionOperations, createCollectionOperations };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
+import { S as ShopifyProduct, P as Product, a as ShopifySingleProduct, b as ShopifyCollection, C as Collection, J as JsonLdEntry, c as StoreTypeBreakdown } from './types-luPg5O08.js';
+export { d as CountryDetectionResult, e as CountryScores, f as CurrencyCode, L as LocalizedPricing, M as MetaTag, g as ProductImage, h as ProductOption, i as ProductVariant, j as ProductVariantImage } from './types-luPg5O08.js';
 import { CheckoutOperations } from './checkout.js';
 import { CollectionOperations } from './collections.js';
 import { ProductOperations } from './products.js';
-import { StoreOperations, StoreInfo } from './store.js';
-import { S as ShopifyProduct, P as Product, a as ShopifySingleProduct, b as ShopifyCollection, C as Collection, c as StoreTypeBreakdown } from './types-luPg5O08.js';
-export { d as CountryDetectionResult, e as CountryScores, f as CurrencyCode, L as LocalizedPricing, M as MetaTag, g as ProductImage, h as ProductOption, i as ProductVariant, j as ProductVariantImage } from './types-luPg5O08.js';
+import { ShopOperations, ShopInfo, OpenGraphMeta } from './store.js';
 export { classifyProduct, generateSEOContent } from './ai/enrich.js';
 export { detectShopCountry } from './utils/detect-country.js';
 export { calculateDiscount, extractDomainWithoutSuffix, genProductSlug, generateStoreSlug, safeParseDate, sanitizeDomain } from './utils/func.js';
@@ -40,10 +40,13 @@ declare class ShopClient {
     private infoCacheValue?;
     private infoCacheTimestamp?;
     private infoInFlight?;
+    private metaCacheValue?;
+    private metaCacheTimestamp?;
+    private metaInFlight?;
     products: ProductOperations;
     collections: CollectionOperations;
     checkout: CheckoutOperations;
-    storeOperations: StoreOperations;
+    shopOperations: ShopOperations;
     /**
      * Creates a new ShopClient instance for interacting with a Shopify store.
      *
@@ -156,12 +159,21 @@ declare class ShopClient {
         force?: boolean;
         validateShowcase?: boolean;
         validationBatchSize?: number;
-    }): Promise<StoreInfo>;
+    }): Promise<ShopInfo>;
     /**
      * Manually clear the cached store info.
      * The next call to `getInfo()` will fetch fresh data regardless of TTL.
      */
     clearInfoCache(): void;
+    /**
+     * Fetch OpenGraph metadata from the store homepage.
+     * Returns only `og:*` fields without additional parsing or validation.
+     */
+    getMetaData(options?: {
+        force?: boolean;
+    }): Promise<OpenGraphMeta>;
+    getJsonLd(): Promise<JsonLdEntry[] | undefined>;
+    getHeaderLinks(): Promise<string[]>;
     /**
      * Determine the store's primary vertical and target audience.
      * Uses `getInfo()` internally; no input required.
@@ -174,4 +186,4 @@ declare class ShopClient {
     }): Promise<StoreTypeBreakdown>;
 }
 
-export { CheckoutOperations, Collection, CollectionOperations, Product, ProductOperations, ShopClient, type ShopClientOptions, StoreInfo, StoreOperations, StoreTypeBreakdown };
+export { CheckoutOperations, Collection, CollectionOperations, OpenGraphMeta, Product, ProductOperations, ShopClient, type ShopClientOptions, ShopInfo, ShopOperations, StoreTypeBreakdown };

package/dist/index.mjs

@@ -8,9 +8,9 @@ import {
   createProductOperations
 } from "./chunk-ZF4M6GMB.mjs";
 import {
-  createStoreOperations,
-  getInfoForStore
-} from "./chunk-CUL7ZM2W.mjs";
+  createShopOperations,
+  getInfoForShop
+} from "./chunk-7IMI76JZ.mjs";
 import {
   classifyProduct,
   determineStoreType,
@@ -353,7 +353,7 @@ var ShopClient = class {
     if (typeof (options == null ? void 0 : options.cacheTTL) === "number" && options.cacheTTL > 0) {
       this.cacheExpiry = options.cacheTTL;
     }
-    this.storeOperations = createStoreOperations({
+    this.shopOperations = createShopOperations({
       baseUrl: this.baseUrl,
       storeDomain: this.storeDomain,
       validateProductExists: this.validateProductExists.bind(this),
@@ -688,7 +688,7 @@ var ShopClient = class {
         return await this.infoInFlight;
       }
       this.infoInFlight = (async () => {
-        const { info, currencyCode } = await getInfoForStore(
+        const { info, currencyCode } = await getInfoForShop(
           {
             baseUrl: this.baseUrl,
             storeDomain: this.storeDomain,
@@ -726,6 +726,60 @@ var ShopClient = class {
     this.infoCacheValue = void 0;
     this.infoCacheTimestamp = void 0;
   }
+  /**
+   * Fetch OpenGraph metadata from the store homepage.
+   * Returns only `og:*` fields without additional parsing or validation.
+   */
+  async getMetaData(options) {
+    try {
+      if ((options == null ? void 0 : options.force) === true) {
+        this.metaCacheValue = void 0;
+        this.metaCacheTimestamp = void 0;
+      }
+      if (this.metaCacheValue && this.metaCacheTimestamp !== void 0 && Date.now() - this.metaCacheTimestamp < this.cacheExpiry) {
+        return this.metaCacheValue;
+      }
+      if (this.metaInFlight) {
+        return await this.metaInFlight;
+      }
+      this.metaInFlight = (async () => {
+        const meta = await this.shopOperations.getMetaData();
+        this.metaCacheValue = meta;
+        this.metaCacheTimestamp = Date.now();
+        return meta;
+      })();
+      try {
+        const result = await this.metaInFlight;
+        return result;
+      } finally {
+        this.metaInFlight = void 0;
+      }
+    } catch (error) {
+      throw this.handleFetchError(
+        error,
+        "fetching store metadata",
+        this.baseUrl
+      );
+    }
+  }
+  async getJsonLd() {
+    try {
+      return await this.shopOperations.getJsonLd();
+    } catch (error) {
+      throw this.handleFetchError(
+        error,
+        "fetching store JSON-LD",
+        this.baseUrl
+      );
+    }
+  }
+  async getHeaderLinks() {
+    try {
+      return await this.shopOperations.getHeaderLinks();
+    } catch (error) {
+      throw this.handleFetchError(error, "fetching header links", this.baseUrl);
+    }
+  }
   /**
    * Determine the store's primary vertical and target audience.
    * Uses `getInfo()` internally; no input required.

package/dist/products.d.ts

@@ -1,4 +1,4 @@
-import { StoreInfo } from './store.js';
+import { ShopInfo } from './store.js';
 import { f as CurrencyCode, P as Product, k as ProductClassification, l as SEOContent, S as ShopifyProduct, a as ShopifySingleProduct } from './types-luPg5O08.js';
 
 /**
@@ -77,6 +77,6 @@ interface ProductOperations {
 /**
  * Creates product operations for a store instance
  */
-declare function createProductOperations(baseUrl: string, storeDomain: string, fetchProducts: (page: number, limit: number) => Promise<Product[] | null>, productsDto: (products: ShopifyProduct[]) => Product[] | null, productDto: (product: ShopifySingleProduct) => Product, getStoreInfo: () => Promise<StoreInfo>, findProduct: (handle: string) => Promise<Product | null>): ProductOperations;
+declare function createProductOperations(baseUrl: string, storeDomain: string, fetchProducts: (page: number, limit: number) => Promise<Product[] | null>, productsDto: (products: ShopifyProduct[]) => Product[] | null, productDto: (product: ShopifySingleProduct) => Product, getStoreInfo: () => Promise<ShopInfo>, findProduct: (handle: string) => Promise<Product | null>): ProductOperations;
 
 export { type ProductOperations, createProductOperations };

package/dist/store.d.ts

@@ -4,14 +4,17 @@ import { J as JsonLdEntry, d as CountryDetectionResult, f as CurrencyCode } from
  * Store operations interface for managing store-related functionality.
  * Provides methods to fetch comprehensive store information and metadata.
  */
-interface StoreOperations {
-    info(): Promise<StoreInfo>;
+interface ShopOperations {
+    info(): Promise<ShopInfo>;
+    getMetaData(): Promise<OpenGraphMeta>;
+    getJsonLd(): Promise<JsonLdEntry[] | undefined>;
+    getHeaderLinks(): Promise<string[]>;
 }
 /**
  * Comprehensive store information structure returned by the info method.
  * Contains all metadata, branding, social links, and showcase content for a Shopify store.
  */
-interface StoreInfo {
+interface ShopInfo {
     name: string;
     domain: string;
     slug: string;
@@ -38,17 +41,26 @@ interface StoreInfo {
     country: CountryDetectionResult["country"];
     currency: CurrencyCode | null;
 }
+interface OpenGraphMeta {
+    siteName: string | null;
+    title: string | null;
+    description: string | null;
+    url: string | null;
+    type: string | null;
+    image: string | null;
+    imageSecureUrl: string | null;
+}
 /**
  * Creates store operations for a ShopClient instance.
  * @param context - ShopClient context containing necessary methods and properties for store operations
  */
-declare function createStoreOperations(context: {
+declare function createShopOperations(context: {
     baseUrl: string;
     storeDomain: string;
     validateProductExists: (handle: string) => Promise<boolean>;
     validateCollectionExists: (handle: string) => Promise<boolean>;
     validateLinksInBatches: <T>(items: T[], validator: (item: T) => Promise<boolean>, batchSize?: number) => Promise<T[]>;
     handleFetchError: (error: unknown, context: string, url: string) => never;
-}): StoreOperations;
+}): ShopOperations;
 
-export { type StoreInfo, type StoreOperations, createStoreOperations };
+export { type OpenGraphMeta, type ShopInfo, type ShopOperations, createShopOperations };

package/dist/store.mjs

@@ -1,9 +1,9 @@
 import {
-  createStoreOperations
-} from "./chunk-CUL7ZM2W.mjs";
+  createShopOperations
+} from "./chunk-7IMI76JZ.mjs";
 import "./chunk-D5MTUWFO.mjs";
 import "./chunk-G7OCMGA6.mjs";
 import "./chunk-U3RQRBXZ.mjs";
 export {
-  createStoreOperations
+  createShopOperations
 };

package/package.json

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