shop-client 3.9.0 → 3.9.1

package/dist/chunk-RR6YTQWP.js

@@ -0,0 +1,90 @@
+// src/checkout.ts
+function createCheckoutOperations(baseUrl) {
+  return {
+    /**
+     * Creates a Shopify checkout URL with pre-filled customer information and cart items.
+     *
+     * @param params - Checkout parameters
+     * @param params.email - Customer's email address (must be valid email format)
+     * @param params.items - Array of products to add to cart
+     * @param params.items[].productVariantId - Shopify product variant ID
+     * @param params.items[].quantity - Quantity as string (must be positive number)
+     * @param params.address - Customer's shipping address
+     * @param params.address.firstName - Customer's first name
+     * @param params.address.lastName - Customer's last name
+     * @param params.address.address1 - Street address
+     * @param params.address.city - City name
+     * @param params.address.zip - Postal/ZIP code
+     * @param params.address.country - Country name
+     * @param params.address.province - State/Province name
+     * @param params.address.phone - Phone number
+     *
+     * @returns {string} Complete Shopify checkout URL with pre-filled information
+     *
+     * @throws {Error} When email is invalid, items array is empty, or required address fields are missing
+     *
+     * @example
+     * ```typescript
+     * const shop = new ShopClient('https://exampleshop.com');
+     * const checkoutUrl = await shop.checkout.create([
+     *   { variantId: '123', quantity: 2 },
+     *   { variantId: '456', quantity: 1 }
+     * ]);
+     * console.log(checkoutUrl);
+     * ```
+     */
+    createUrl: ({
+      email,
+      items,
+      address
+    }) => {
+      if (!email || !email.includes("@")) {
+        throw new Error("Invalid email address");
+      }
+      if (!items || items.length === 0) {
+        throw new Error("Items array cannot be empty");
+      }
+      for (const item of items) {
+        if (!item.productVariantId || !item.quantity) {
+          throw new Error("Each item must have productVariantId and quantity");
+        }
+        const qty = Number.parseInt(item.quantity, 10);
+        if (Number.isNaN(qty) || qty <= 0) {
+          throw new Error("Quantity must be a positive number");
+        }
+      }
+      const requiredFields = [
+        "firstName",
+        "lastName",
+        "address1",
+        "city",
+        "zip",
+        "country"
+      ];
+      for (const field of requiredFields) {
+        if (!address[field]) {
+          throw new Error(`Address field '${field}' is required`);
+        }
+      }
+      const cartPath = items.map(
+        (item) => `${encodeURIComponent(item.productVariantId)}:${encodeURIComponent(item.quantity)}`
+      ).join(",");
+      const params = new URLSearchParams({
+        "checkout[email]": email,
+        "checkout[shipping_address][first_name]": address.firstName,
+        "checkout[shipping_address][last_name]": address.lastName,
+        "checkout[shipping_address][address1]": address.address1,
+        "checkout[shipping_address][city]": address.city,
+        "checkout[shipping_address][zip]": address.zip,
+        "checkout[shipping_address][country]": address.country,
+        "checkout[shipping_address][province]": address.province,
+        "checkout[shipping_address][phone]": address.phone
+      });
+      return `${baseUrl}cart/${cartPath}?${params.toString()}`;
+    }
+  };
+}
+
+export {
+  createCheckoutOperations
+};

package/dist/chunk-V52MFQZE.js

@@ -0,0 +1,233 @@
+import {
+  rateLimitedFetch
+} from "./chunk-2MF53V33.js";
+import {
+  detectShopCountry
+} from "./chunk-ROH545KI.js";
+import {
+  extractDomainWithoutSuffix,
+  generateStoreSlug,
+  sanitizeDomain
+} from "./chunk-CN7L3BHG.js";
+
+// 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;
+  const {
+    baseUrl,
+    storeDomain,
+    validateProductExists,
+    validateCollectionExists,
+    validateLinksInBatches
+  } = args;
+  const response = await rateLimitedFetch(baseUrl, {
+    rateLimitClass: "store:info"
+  });
+  if (!response.ok) {
+    throw new Error(`HTTP error! status: ${response.status}`);
+  }
+  const html = await response.text();
+  const getMetaTag = (name2) => {
+    const regex = new RegExp(
+      `<meta[^>]*name=["']${name2}["'][^>]*content=["'](.*?)["']`
+    );
+    const match = html.match(regex);
+    return match ? match[1] : null;
+  };
+  const getPropertyMetaTag = (property) => {
+    const regex = new RegExp(
+      `<meta[^>]*property=["']${property}["'][^>]*content=["'](.*?)["']`
+    );
+    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 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");
+  if (!logoUrl) {
+    const logoMatch = html.match(
+      /<img[^>]+src=["']([^"']+\/cdn\/shop\/[^"']+)["']/
+    );
+    const matchedUrl = logoMatch == null ? void 0 : logoMatch[1];
+    logoUrl = matchedUrl ? matchedUrl.replace("http://", "https://") : null;
+  } else {
+    logoUrl = logoUrl.replace("http://", "https://");
+  }
+  const socialLinks = {};
+  const socialRegex = /<a[^>]+href=["']([^"']*(?:facebook|twitter|instagram|pinterest|youtube|linkedin|tiktok|vimeo)\.com[^"']*)["']/g;
+  for (const match of html.matchAll(socialRegex)) {
+    const str = match[1];
+    if (!str) continue;
+    let href = str;
+    try {
+      if (href.startsWith("//")) {
+        href = `https:${href}`;
+      } else if (href.startsWith("/")) {
+        href = new URL(href, baseUrl).toString();
+      }
+      const parsed = new URL(href);
+      const domain = parsed.hostname.replace("www.", "").split(".")[0];
+      if (domain) {
+        socialLinks[domain] = parsed.toString();
+      }
+    } catch {
+    }
+  }
+  const contactLinks = {
+    tel: null,
+    email: null,
+    contactPage: null
+  };
+  for (const match of html.matchAll(/href=["']tel:([^"']+)["']/g)) {
+    contactLinks.tel = ((_d = match == null ? void 0 : match[1]) == null ? void 0 : _d.trim()) || null;
+  }
+  for (const match of html.matchAll(/href=["']mailto:([^"']+)["']/g)) {
+    contactLinks.email = ((_e = match == null ? void 0 : match[1]) == null ? void 0 : _e.trim()) || null;
+  }
+  for (const match of html.matchAll(
+    /href=["']([^"']*(?:\/contact|\/pages\/contact)[^"']*)["']/g
+  )) {
+    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 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) => {
+    var _a2, _b2;
+    const links = (_a2 = header.match(/href=["']([^"']+)["']/g)) == null ? void 0 : _a2.filter(
+      (link) => link.includes("/products/") || link.includes("/collections/") || link.includes("/pages/")
+    );
+    return (_b2 = links == null ? void 0 : links.map((link) => {
+      var _a3;
+      const href = (_a3 = link.match(/href=["']([^"']+)["']/)) == null ? void 0 : _a3[1];
+      if (href && !href.startsWith("#") && !href.startsWith("javascript:")) {
+        try {
+          const url = new URL(href, storeDomain);
+          return url.pathname.replace(/^\/|\/$/g, "");
+        } catch {
+          return href.replace(/^\/|\/$/g, "");
+        }
+      }
+      return null;
+    }).filter((item) => Boolean(item))) != null ? _b2 : [];
+  })) != null ? _k : [];
+  const slug = generateStoreSlug(baseUrl);
+  const countryDetection = await detectShopCountry(html);
+  const [homePageProductLinks, homePageCollectionLinks] = await Promise.all([
+    validateLinksInBatches(
+      extractedProductLinks.filter(
+        (handle) => Boolean(handle)
+      ),
+      (handle) => validateProductExists(handle)
+    ),
+    validateLinksInBatches(
+      extractedCollectionLinks.filter(
+        (handle) => Boolean(handle)
+      ),
+      (handle) => validateCollectionExists(handle)
+    )
+  ]);
+  const info = {
+    name: name || slug,
+    domain: sanitizeDomain(baseUrl),
+    slug,
+    title: title || null,
+    description: description || null,
+    logoUrl,
+    socialLinks,
+    contactLinks,
+    headerLinks,
+    showcase: {
+      products: unique(homePageProductLinks != null ? homePageProductLinks : []),
+      collections: unique(homePageCollectionLinks != null ? homePageCollectionLinks : [])
+    },
+    jsonLdData: ((_m = (_l = html.match(
+      /<script[^>]*type="application\/ld\+json"[^>]*>([^<]+)<\/script>/g
+    )) == null ? void 0 : _l.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)) || [],
+    techProvider: {
+      name: "shopify",
+      walletId: shopifyWalletId,
+      subDomain: myShopifySubdomain != null ? myShopifySubdomain : null
+    },
+    country: countryDetection.country
+  };
+  const currencyCode = countryDetection == null ? void 0 : countryDetection.currencyCode;
+  return { info, currencyCode };
+}
+
+// src/store.ts
+function createStoreOperations(context) {
+  return {
+    /**
+     * Fetches comprehensive store information including metadata, social links, and showcase content.
+     *
+     * @returns {Promise<StoreInfo>} Store information object containing:
+     * - `name` - Store name from meta tags or domain
+     * - `domain` - Store domain URL
+     * - `slug` - Generated store slug
+     * - `title` - Store title from meta tags
+     * - `description` - Store description from meta tags
+     * - `logoUrl` - Store logo URL from Open Graph or CDN
+     * - `socialLinks` - Object with social media links (facebook, twitter, instagram, etc.)
+     * - `contactLinks` - Object with contact information (tel, email, contactPage)
+     * - `headerLinks` - Array of navigation links from header
+     * - `showcase` - Object with featured products and collections from homepage
+     * - `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")
+     *
+     * @throws {Error} When the store URL is unreachable or returns an error
+     *
+     * @example
+     * ```typescript
+     * const shop = new ShopClient('https://exampleshop.com');
+     * const storeInfo = await shop.getInfo();
+     *
+     * console.log(storeInfo.name); // "Example Store"
+     * console.log(storeInfo.socialLinks.instagram); // "https://instagram.com/example"
+     * console.log(storeInfo.showcase.products); // ["product-handle-1", "product-handle-2"]
+     * console.log(storeInfo.country); // "US"
+     * ```
+     */
+    info: async () => {
+      try {
+        const { info } = await getInfoForStore({
+          baseUrl: context.baseUrl,
+          storeDomain: context.storeDomain,
+          validateProductExists: context.validateProductExists,
+          validateCollectionExists: context.validateCollectionExists,
+          validateLinksInBatches: context.validateLinksInBatches
+        });
+        return info;
+      } catch (error) {
+        context.handleFetchError(error, "fetching store info", context.baseUrl);
+      }
+    }
+  };
+}
+
+export {
+  getInfoForStore,
+  createStoreOperations
+};