shop-client 3.8.2

package/dist/products.js

@@ -0,0 +1,1206 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/products.ts
+var products_exports = {};
+__export(products_exports, {
+  createProductOperations: () => createProductOperations
+});
+module.exports = __toCommonJS(products_exports);
+var import_remeda = require("remeda");
+
+// src/ai/enrich.ts
+var import_turndown = __toESM(require("turndown"));
+var import_turndown_plugin_gfm = require("turndown-plugin-gfm");
+
+// src/utils/rate-limit.ts
+var RateLimiter = class {
+  constructor(options) {
+    this.queue = [];
+    this.inFlight = 0;
+    this.refillTimer = null;
+    this.options = options;
+    this.tokens = options.maxRequestsPerInterval;
+  }
+  startRefill() {
+    if (this.refillTimer) return;
+    this.refillTimer = setInterval(() => {
+      this.tokens = this.options.maxRequestsPerInterval;
+      this.tryRun();
+    }, this.options.intervalMs);
+    if (this.refillTimer && typeof this.refillTimer.unref === "function") {
+      this.refillTimer.unref();
+    }
+  }
+  stopRefill() {
+    if (this.refillTimer) {
+      clearInterval(this.refillTimer);
+      this.refillTimer = null;
+    }
+  }
+  ensureRefillStarted() {
+    if (!this.refillTimer) {
+      this.startRefill();
+    }
+  }
+  configure(next) {
+    this.options = { ...this.options, ...next };
+    this.options.maxRequestsPerInterval = Math.max(
+      1,
+      this.options.maxRequestsPerInterval
+    );
+    this.options.intervalMs = Math.max(10, this.options.intervalMs);
+    this.options.maxConcurrency = Math.max(1, this.options.maxConcurrency);
+  }
+  schedule(fn) {
+    return new Promise((resolve, reject) => {
+      this.ensureRefillStarted();
+      this.queue.push({ fn, resolve, reject });
+      this.tryRun();
+    });
+  }
+  tryRun() {
+    while (this.queue.length > 0 && this.inFlight < this.options.maxConcurrency && this.tokens > 0) {
+      const task = this.queue.shift();
+      this.tokens -= 1;
+      this.inFlight += 1;
+      Promise.resolve().then(task.fn).then((result) => task.resolve(result)).catch((err) => task.reject(err)).finally(() => {
+        this.inFlight -= 1;
+        setTimeout(() => this.tryRun(), 0);
+      });
+    }
+  }
+};
+var enabled = false;
+var defaultOptions = {
+  maxRequestsPerInterval: 5,
+  // 5 requests
+  intervalMs: 1e3,
+  // per second
+  maxConcurrency: 5
+  // up to 5 in parallel
+};
+var limiter = new RateLimiter(defaultOptions);
+var hostLimiters = /* @__PURE__ */ new Map();
+var classLimiters = /* @__PURE__ */ new Map();
+function getHost(input) {
+  try {
+    if (typeof input === "string") {
+      return new URL(input).host;
+    }
+    if (input instanceof URL) {
+      return input.host;
+    }
+    const url = input.url;
+    if (url) {
+      return new URL(url).host;
+    }
+  } catch {
+  }
+  return void 0;
+}
+function getHostLimiter(host) {
+  if (!host) return void 0;
+  const exact = hostLimiters.get(host);
+  if (exact) return exact;
+  for (const [key, lim] of hostLimiters.entries()) {
+    if (key.startsWith("*.") && host.endsWith(key.slice(2))) {
+      return lim;
+    }
+  }
+  return void 0;
+}
+async function rateLimitedFetch(input, init) {
+  var _a;
+  if (!enabled) {
+    return fetch(input, init);
+  }
+  const klass = init == null ? void 0 : init.rateLimitClass;
+  const byClass = klass ? classLimiters.get(klass) : void 0;
+  const byHost = getHostLimiter(getHost(input));
+  const eff = (_a = byClass != null ? byClass : byHost) != null ? _a : limiter;
+  return eff.schedule(() => fetch(input, init));
+}
+
+// src/ai/enrich.ts
+function ensureOpenRouter(apiKey) {
+  const key = apiKey || process.env.OPENROUTER_API_KEY;
+  if (!key) {
+    throw new Error(
+      "Missing OpenRouter API key. Set OPENROUTER_API_KEY or pass apiKey."
+    );
+  }
+  return key;
+}
+function normalizeDomainToBase(domain) {
+  if (domain.startsWith("http://") || domain.startsWith("https://")) {
+    try {
+      const u = new URL(domain);
+      return `${u.protocol}//${u.hostname}`;
+    } catch {
+      return domain;
+    }
+  }
+  return `https://${domain}`;
+}
+async function fetchAjaxProduct(domain, handle) {
+  const base = normalizeDomainToBase(domain);
+  const url = `${base}/products/${handle}.js`;
+  const res = await rateLimitedFetch(url);
+  if (!res.ok) throw new Error(`Failed to fetch AJAX product: ${url}`);
+  const data = await res.json();
+  return data;
+}
+async function fetchProductPage(domain, handle) {
+  const base = normalizeDomainToBase(domain);
+  const url = `${base}/products/${handle}`;
+  const res = await rateLimitedFetch(url);
+  if (!res.ok) throw new Error(`Failed to fetch product page: ${url}`);
+  return res.text();
+}
+function extractMainSection(html) {
+  const startMatch = html.match(
+    /<section[^>]*id="shopify-section-template--.*?__main"[^>]*>/
+  );
+  if (!startMatch) return null;
+  const startIndex = html.indexOf(startMatch[0]);
+  if (startIndex === -1) return null;
+  const endIndex = html.indexOf("</section>", startIndex);
+  if (endIndex === -1) return null;
+  return html.substring(startIndex, endIndex + "</section>".length);
+}
+function htmlToMarkdown(html, options) {
+  var _a;
+  if (!html) return "";
+  const td = new import_turndown.default({
+    headingStyle: "atx",
+    codeBlockStyle: "fenced",
+    bulletListMarker: "-",
+    emDelimiter: "*",
+    strongDelimiter: "**",
+    linkStyle: "inlined"
+  });
+  const useGfm = (_a = options == null ? void 0 : options.useGfm) != null ? _a : true;
+  if (useGfm) {
+    td.use(import_turndown_plugin_gfm.gfm);
+  }
+  ["script", "style", "nav", "footer"].forEach((tag) => {
+    td.remove((node) => {
+      var _a2;
+      return ((_a2 = node.nodeName) == null ? void 0 : _a2.toLowerCase()) === tag;
+    });
+  });
+  const removeByClass = (className) => td.remove((node) => {
+    const cls = typeof node.getAttribute === "function" ? node.getAttribute("class") || "" : "";
+    return cls.split(/\s+/).includes(className);
+  });
+  [
+    "product-form",
+    "shopify-payment-button",
+    "shopify-payment-buttons",
+    "product__actions",
+    "product__media-wrapper",
+    "loox-rating",
+    "jdgm-widget",
+    "stamped-reviews"
+  ].forEach(removeByClass);
+  ["button", "input", "select", "label"].forEach((tag) => {
+    td.remove((node) => {
+      var _a2;
+      return ((_a2 = node.nodeName) == null ? void 0 : _a2.toLowerCase()) === tag;
+    });
+  });
+  ["quantity-selector", "product-atc-wrapper"].forEach(removeByClass);
+  return td.turndown(html);
+}
+async function mergeWithLLM(bodyInput, pageInput, options) {
+  var _a, _b;
+  const inputType = (_a = options == null ? void 0 : options.inputType) != null ? _a : "markdown";
+  const bodyLabel = inputType === "html" ? "BODY HTML" : "BODY MARKDOWN";
+  const pageLabel = inputType === "html" ? "PAGE HTML" : "PAGE MARKDOWN";
+  const prompt = (options == null ? void 0 : options.outputFormat) === "json" ? `You are extracting structured buyer-useful information from Shopify product content.
+
+Inputs:
+1) ${bodyLabel}: ${inputType === "html" ? "Raw Shopify product body_html" : "Cleaned version of Shopify product body_html"}
+2) ${pageLabel}: ${inputType === "html" ? "Raw product page HTML (main section)" : "Extracted product page HTML converted to markdown"}
+
+Return ONLY valid JSON (no markdown, no code fences) with this shape:
+{
+  "title": null | string,
+  "description": null | string,
+  "materials": string[] | [],
+  "care": string[] | [],
+  "fit": null | string,
+  "images": null | string[],
+  "returnPolicy": null | string
+}
+
+Rules:
+- Do not invent facts; if a field is unavailable, use null or []
+- Prefer concise, factual statements
+ - Do NOT include product gallery/hero images in "images"; include only documentation images like size charts or measurement guides. If none, set "images": null.
+
+${bodyLabel}:
+${bodyInput}
+
+${pageLabel}:
+${pageInput}
+` : `
+You are enriching a Shopify product for a modern shopping-discovery app.
+
+Inputs:
+1) ${bodyLabel}: ${inputType === "html" ? "Raw Shopify product body_html" : "Cleaned version of Shopify product body_html"}
+2) ${pageLabel}: ${inputType === "html" ? "Raw product page HTML (main section)" : "Extracted product page HTML converted to markdown"}
+
+Your tasks:
+- Merge them into a single clean markdown document
+- Remove duplicate content
+- Remove product images
+- Remove UI text, buttons, menus, review widgets, theme junk
+- Remove product options
+- Keep only available buyer-useful info: features, materials, care, fit, size chart, return policy, size chart, care instructions
+- Include image of size-chart if present
+- Don't include statements like information not available.
+- Maintain structured headings (## Description, ## Materials, etc.)
+- Output ONLY markdown (no commentary)
+
+${bodyLabel}:
+${bodyInput}
+
+${pageLabel}:
+${pageInput}
+`;
+  const apiKey = ensureOpenRouter(options == null ? void 0 : options.apiKey);
+  const defaultModel = process.env.OPENROUTER_MODEL || "openai/gpt-4o-mini";
+  const model = (_b = options == null ? void 0 : options.model) != null ? _b : defaultModel;
+  const result = await callOpenRouter(model, prompt, apiKey);
+  if ((options == null ? void 0 : options.outputFormat) === "json") {
+    const cleaned = result.replace(/```json|```/g, "").trim();
+    const obj = safeParseJson(cleaned);
+    if (!obj.ok) {
+      throw new Error(`LLM returned invalid JSON: ${obj.error}`);
+    }
+    const schema = validateStructuredJson(obj.value);
+    if (!schema.ok) {
+      throw new Error(`LLM JSON schema invalid: ${schema.error}`);
+    }
+    const value = obj.value;
+    if (Array.isArray(value.images)) {
+      const filtered = value.images.filter((url) => {
+        if (typeof url !== "string") return false;
+        const u = url.toLowerCase();
+        const productPatterns = [
+          "cdn.shopify.com",
+          "/products/",
+          "%2Fproducts%2F",
+          "_large",
+          "_grande",
+          "_1024x1024",
+          "_2048x"
+        ];
+        const looksLikeProductImage = productPatterns.some(
+          (p) => u.includes(p)
+        );
+        return !looksLikeProductImage;
+      });
+      value.images = filtered.length > 0 ? filtered : null;
+    }
+    return JSON.stringify(value);
+  }
+  return result;
+}
+function safeParseJson(input) {
+  try {
+    const v = JSON.parse(input);
+    return { ok: true, value: v };
+  } catch (err) {
+    return { ok: false, error: (err == null ? void 0 : err.message) || "Failed to parse JSON" };
+  }
+}
+function validateStructuredJson(obj) {
+  if (!obj || typeof obj !== "object" || Array.isArray(obj)) {
+    return { ok: false, error: "Top-level must be a JSON object" };
+  }
+  const o = obj;
+  if ("title" in o && !(o.title === null || typeof o.title === "string")) {
+    return { ok: false, error: "title must be null or string" };
+  }
+  if ("description" in o && !(o.description === null || typeof o.description === "string")) {
+    return { ok: false, error: "description must be null or string" };
+  }
+  if ("fit" in o && !(o.fit === null || typeof o.fit === "string")) {
+    return { ok: false, error: "fit must be null or string" };
+  }
+  if ("returnPolicy" in o && !(o.returnPolicy === null || typeof o.returnPolicy === "string")) {
+    return { ok: false, error: "returnPolicy must be null or string" };
+  }
+  const validateStringArray = (arr, field) => {
+    if (!Array.isArray(arr))
+      return { ok: false, error: `${field} must be an array` };
+    for (const item of arr) {
+      if (typeof item !== "string")
+        return { ok: false, error: `${field} items must be strings` };
+    }
+    return { ok: true };
+  };
+  if ("materials" in o) {
+    const res = validateStringArray(o.materials, "materials");
+    if (!res.ok) return res;
+  }
+  if ("care" in o) {
+    const res = validateStringArray(o.care, "care");
+    if (!res.ok) return res;
+  }
+  if ("images" in o) {
+    if (!(o.images === null || Array.isArray(o.images))) {
+      return { ok: false, error: "images must be null or an array" };
+    }
+    if (Array.isArray(o.images)) {
+      const res = validateStringArray(o.images, "images");
+      if (!res.ok) return res;
+    }
+  }
+  return { ok: true };
+}
+async function callOpenRouter(model, prompt, apiKey) {
+  var _a, _b, _c;
+  if (process.env.OPENROUTER_OFFLINE === "1") {
+    return mockOpenRouterResponse(prompt);
+  }
+  const headers = {
+    "Content-Type": "application/json",
+    Authorization: `Bearer ${apiKey}`
+  };
+  const referer = process.env.OPENROUTER_SITE_URL || process.env.SITE_URL;
+  const title = process.env.OPENROUTER_APP_TITLE || "Shop Search";
+  if (referer) headers["HTTP-Referer"] = referer;
+  if (title) headers["X-Title"] = title;
+  const buildPayload = (m) => ({
+    model: m,
+    messages: [{ role: "user", content: prompt }],
+    temperature: 0.2
+  });
+  const base = (process.env.OPENROUTER_BASE_URL || "https://openrouter.ai/api/v1").replace(/\/$/, "");
+  const endpoints = [`${base}/chat/completions`];
+  const fallbackEnv = (process.env.OPENROUTER_FALLBACK_MODELS || "").split(",").map((s) => s.trim()).filter(Boolean);
+  const defaultModel = process.env.OPENROUTER_MODEL || "openai/gpt-4o-mini";
+  const modelsToTry = Array.from(
+    /* @__PURE__ */ new Set([model, ...fallbackEnv, defaultModel])
+  ).filter(Boolean);
+  let lastErrorText = "";
+  for (const m of modelsToTry) {
+    for (const url of endpoints) {
+      try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 15e3);
+        const response = await rateLimitedFetch(url, {
+          method: "POST",
+          headers,
+          body: JSON.stringify(buildPayload(m)),
+          signal: controller.signal
+        });
+        clearTimeout(timeout);
+        if (!response.ok) {
+          const text = await response.text();
+          lastErrorText = text || `${url}: HTTP ${response.status}`;
+          await new Promise((r) => setTimeout(r, 300));
+          continue;
+        }
+        const data = await response.json();
+        const content = (_c = (_b = (_a = data == null ? void 0 : data.choices) == null ? void 0 : _a[0]) == null ? void 0 : _b.message) == null ? void 0 : _c.content;
+        if (typeof content === "string") return content;
+        lastErrorText = JSON.stringify(data);
+        await new Promise((r) => setTimeout(r, 200));
+      } catch (err) {
+        lastErrorText = `${url}: ${(err == null ? void 0 : err.message) || String(err)}`;
+        await new Promise((r) => setTimeout(r, 200));
+      }
+    }
+  }
+  throw new Error(`OpenRouter request failed: ${lastErrorText}`);
+}
+function mockOpenRouterResponse(prompt) {
+  const p = prompt.toLowerCase();
+  if (p.includes("return only valid json") && p.includes('"audience":')) {
+    return JSON.stringify({
+      audience: "generic",
+      vertical: "clothing",
+      category: null,
+      subCategory: null
+    });
+  }
+  if (p.includes("return only valid json") && p.includes('"materials":')) {
+    return JSON.stringify({
+      title: null,
+      description: null,
+      materials: [],
+      care: [],
+      fit: null,
+      images: null,
+      returnPolicy: null
+    });
+  }
+  return [
+    "## Description",
+    "Offline merge of product body and page.",
+    "",
+    "## Materials",
+    "- Not available"
+  ].join("\n");
+}
+async function enrichProduct(domain, handle, options) {
+  var _a;
+  const ajaxProduct = await fetchAjaxProduct(domain, handle);
+  const bodyHtml = ajaxProduct.description || "";
+  const pageHtml = await fetchProductPage(domain, handle);
+  const extractedHtml = extractMainSection(pageHtml);
+  const inputType = (_a = options == null ? void 0 : options.inputType) != null ? _a : "markdown";
+  const bodyInput = inputType === "html" ? bodyHtml : htmlToMarkdown(bodyHtml, { useGfm: options == null ? void 0 : options.useGfm });
+  const pageInput = inputType === "html" ? extractedHtml || pageHtml : htmlToMarkdown(extractedHtml, { useGfm: options == null ? void 0 : options.useGfm });
+  const mergedMarkdown = await mergeWithLLM(bodyInput, pageInput, {
+    apiKey: options == null ? void 0 : options.apiKey,
+    inputType,
+    model: options == null ? void 0 : options.model,
+    outputFormat: options == null ? void 0 : options.outputFormat
+  });
+  if ((options == null ? void 0 : options.outputFormat) === "json") {
+    try {
+      const obj = JSON.parse(mergedMarkdown);
+      if (obj && Array.isArray(obj.images)) {
+        const productImageCandidates = [];
+        if (ajaxProduct.featured_image) {
+          productImageCandidates.push(String(ajaxProduct.featured_image));
+        }
+        if (Array.isArray(ajaxProduct.images)) {
+          for (const img of ajaxProduct.images) {
+            if (typeof img === "string" && img.length > 0) {
+              productImageCandidates.push(img);
+            }
+          }
+        }
+        if (Array.isArray(ajaxProduct.media)) {
+          for (const m of ajaxProduct.media) {
+            if (m == null ? void 0 : m.src) productImageCandidates.push(String(m.src));
+          }
+        }
+        if (Array.isArray(ajaxProduct.variants)) {
+          for (const v of ajaxProduct.variants) {
+            const fi = v == null ? void 0 : v.featured_image;
+            if (fi == null ? void 0 : fi.src) productImageCandidates.push(String(fi.src));
+          }
+        }
+        const productSet = new Set(
+          productImageCandidates.map((u) => String(u).toLowerCase())
+        );
+        const filtered = obj.images.filter((url) => {
+          if (typeof url !== "string") return false;
+          const u = url.toLowerCase();
+          if (productSet.has(u)) return false;
+          const productPatterns = [
+            "cdn.shopify.com",
+            "/products/",
+            "%2Fproducts%2F",
+            "_large",
+            "_grande",
+            "_1024x1024",
+            "_2048x"
+          ];
+          const looksLikeProductImage = productPatterns.some(
+            (p) => u.includes(p)
+          );
+          return !looksLikeProductImage;
+        });
+        obj.images = filtered.length > 0 ? filtered : null;
+        const sanitized = JSON.stringify(obj);
+        return {
+          bodyHtml,
+          pageHtml,
+          extractedMainHtml: extractedHtml || "",
+          mergedMarkdown: sanitized
+        };
+      }
+    } catch {
+    }
+  }
+  return {
+    bodyHtml,
+    pageHtml,
+    extractedMainHtml: extractedHtml || "",
+    mergedMarkdown
+  };
+}
+async function classifyProduct(productContent, options) {
+  var _a;
+  const apiKey = ensureOpenRouter(options == null ? void 0 : options.apiKey);
+  const defaultModel = process.env.OPENROUTER_MODEL || "openai/gpt-4o-mini";
+  const model = (_a = options == null ? void 0 : options.model) != null ? _a : defaultModel;
+  const prompt = `Classify the following product using a three-tiered hierarchy:
+
+Product Content:
+${productContent}
+
+Classification Rules:
+1. First determine the vertical (main product category)
+2. Then determine the category (specific type within that vertical)
+3. Finally determine the subCategory (sub-type within that category)
+
+Vertical must be one of: clothing, beauty, accessories, home-decor, food-and-beverages
+Audience must be one of: adult_male, adult_female, kid_male, kid_female, generic
+
+Hierarchy Examples:
+- Clothing \u2192 tops \u2192 t-shirts
+- Clothing \u2192 footwear \u2192 sneakers
+- Beauty \u2192 skincare \u2192 moisturizers
+- Accessories \u2192 bags \u2192 backpacks
+- Home-decor \u2192 furniture \u2192 chairs
+- Food-and-beverages \u2192 snacks \u2192 chips
+
+IMPORTANT CONSTRAINTS:
+- Category must be relevant to the chosen vertical
+- subCategory must be relevant to both vertical and category
+- subCategory must be a single word or hyphenated words (no spaces)
+- subCategory should NOT be material (e.g., "cotton", "leather") or color (e.g., "red", "blue")
+- Focus on product type/function, not attributes
+
+If you're not confident about category or sub-category, you can leave them optional.
+
+Return ONLY valid JSON (no markdown, no code fences) with keys:
+{
+  "audience": "adult_male" | "adult_female" | "kid_male" | "kid_female" | "generic",
+  "vertical": "clothing" | "beauty" | "accessories" | "home-decor" | "food-and-beverages",
+  "category": null | string,
+  "subCategory": null | string
+}`;
+  const raw = await callOpenRouter(model, prompt, apiKey);
+  const cleaned = raw.replace(/```json|```/g, "").trim();
+  const parsed = safeParseJson(cleaned);
+  if (!parsed.ok) {
+    throw new Error(`LLM returned invalid JSON: ${parsed.error}`);
+  }
+  const validated = validateClassification(parsed.value);
+  if (!validated.ok) {
+    throw new Error(`LLM JSON schema invalid: ${validated.error}`);
+  }
+  return validated.value;
+}
+function validateClassification(obj) {
+  var _a, _b;
+  if (!obj || typeof obj !== "object" || Array.isArray(obj)) {
+    return { ok: false, error: "Top-level must be a JSON object" };
+  }
+  const o = obj;
+  const audienceValues = [
+    "adult_male",
+    "adult_female",
+    "kid_male",
+    "kid_female",
+    "generic"
+  ];
+  if (typeof o.audience !== "string" || !audienceValues.includes(o.audience)) {
+    return {
+      ok: false,
+      error: "audience must be one of: adult_male, adult_female, kid_male, kid_female, generic"
+    };
+  }
+  const verticalValues = [
+    "clothing",
+    "beauty",
+    "accessories",
+    "home-decor",
+    "food-and-beverages"
+  ];
+  if (typeof o.vertical !== "string" || !verticalValues.includes(o.vertical)) {
+    return {
+      ok: false,
+      error: "vertical must be one of: clothing, beauty, accessories, home-decor, food-and-beverages"
+    };
+  }
+  if ("category" in o && !(o.category === null || typeof o.category === "string")) {
+    return { ok: false, error: "category must be null or string" };
+  }
+  if ("subCategory" in o && !(o.subCategory === null || typeof o.subCategory === "string")) {
+    return { ok: false, error: "subCategory must be null or string" };
+  }
+  if (typeof o.subCategory === "string") {
+    const sc = o.subCategory.trim();
+    if (!/^[A-Za-z0-9-]+$/.test(sc)) {
+      return {
+        ok: false,
+        error: "subCategory must be single word or hyphenated, no spaces"
+      };
+    }
+  }
+  return {
+    ok: true,
+    value: {
+      audience: o.audience,
+      vertical: o.vertical,
+      category: typeof o.category === "string" ? o.category : (_a = o.category) != null ? _a : null,
+      subCategory: typeof o.subCategory === "string" ? o.subCategory : (_b = o.subCategory) != null ? _b : null
+    }
+  };
+}
+async function generateSEOContent(product, options) {
+  var _a;
+  const apiKey = ensureOpenRouter(options == null ? void 0 : options.apiKey);
+  const defaultModel = process.env.OPENROUTER_MODEL || "openai/gpt-4o-mini";
+  const model = (_a = options == null ? void 0 : options.model) != null ? _a : defaultModel;
+  if (process.env.OPENROUTER_OFFLINE === "1") {
+    const baseTags = Array.isArray(product.tags) ? product.tags.slice(0, 6) : [];
+    const titlePart = product.title.trim().slice(0, 50);
+    const vendorPart = (product.vendor || "").trim();
+    const pricePart = typeof product.price === "number" ? `$${product.price}` : "";
+    const metaTitle = vendorPart ? `${titlePart} | ${vendorPart}` : titlePart;
+    const metaDescription = `Discover ${product.title}. ${pricePart ? `Priced at ${pricePart}. ` : ""}Crafted to delight customers with quality and style.`.slice(
+      0,
+      160
+    );
+    const shortDescription = `${product.title} \u2014 ${vendorPart || "Premium"} quality, designed to impress.`;
+    const longDescription = product.description || `Introducing ${product.title}, combining performance and style for everyday use.`;
+    const marketingCopy = `Get ${product.title} today${pricePart ? ` for ${pricePart}` : ""}. Limited availability \u2014 don\u2019t miss out!`;
+    const res = {
+      metaTitle,
+      metaDescription,
+      shortDescription,
+      longDescription,
+      tags: baseTags.length ? baseTags : ["new", "featured", "popular"],
+      marketingCopy
+    };
+    const validated2 = validateSEOContent(res);
+    if (!validated2.ok)
+      throw new Error(`Offline SEO content invalid: ${validated2.error}`);
+    return validated2.value;
+  }
+  const prompt = `Generate SEO-optimized content for this product:
+
+Title: ${product.title}
+Description: ${product.description || "N/A"}
+Vendor: ${product.vendor || "N/A"}
+Price: ${typeof product.price === "number" ? `$${product.price}` : "N/A"}
+Tags: ${Array.isArray(product.tags) && product.tags.length ? product.tags.join(", ") : "N/A"}
+
+Create compelling, SEO-friendly content that will help this product rank well and convert customers.
+
+Return ONLY valid JSON (no markdown, no code fences) with keys: {
+  "metaTitle": string,
+  "metaDescription": string,
+  "shortDescription": string,
+  "longDescription": string,
+  "tags": string[],
+  "marketingCopy": string
+}`;
+  const raw = await callOpenRouter(model, prompt, apiKey);
+  const cleaned = raw.replace(/```json|```/g, "").trim();
+  const parsed = safeParseJson(cleaned);
+  if (!parsed.ok) {
+    throw new Error(`LLM returned invalid JSON: ${parsed.error}`);
+  }
+  const validated = validateSEOContent(parsed.value);
+  if (!validated.ok) {
+    throw new Error(`LLM JSON schema invalid: ${validated.error}`);
+  }
+  return validated.value;
+}
+function validateSEOContent(obj) {
+  if (!obj || typeof obj !== "object" || Array.isArray(obj)) {
+    return { ok: false, error: "Top-level must be a JSON object" };
+  }
+  const o = obj;
+  const requiredStrings = [
+    "metaTitle",
+    "metaDescription",
+    "shortDescription",
+    "longDescription",
+    "marketingCopy"
+  ];
+  for (const key of requiredStrings) {
+    if (typeof o[key] !== "string" || !o[key].trim()) {
+      return { ok: false, error: `${key} must be a non-empty string` };
+    }
+  }
+  if (!Array.isArray(o.tags)) {
+    return { ok: false, error: "tags must be an array" };
+  }
+  for (const t of o.tags) {
+    if (typeof t !== "string")
+      return { ok: false, error: "tags items must be strings" };
+  }
+  return {
+    ok: true,
+    value: {
+      metaTitle: String(o.metaTitle),
+      metaDescription: String(o.metaDescription),
+      shortDescription: String(o.shortDescription),
+      longDescription: String(o.longDescription),
+      tags: o.tags,
+      marketingCopy: String(o.marketingCopy)
+    }
+  };
+}
+
+// src/utils/func.ts
+var import_tldts = require("tldts");
+function formatPrice(amountInCents, currency) {
+  try {
+    return new Intl.NumberFormat(void 0, {
+      style: "currency",
+      currency
+    }).format((amountInCents || 0) / 100);
+  } catch {
+    const val = (amountInCents || 0) / 100;
+    return `${val} ${currency}`;
+  }
+}
+
+// src/products.ts
+function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDto, productDto, getStoreInfo, findProduct) {
+  function applyCurrencyOverride(product, currency) {
+    var _a, _b, _c, _d, _e, _f;
+    const priceMin = (_b = (_a = product.priceMin) != null ? _a : product.price) != null ? _b : 0;
+    const priceMax = (_d = (_c = product.priceMax) != null ? _c : product.price) != null ? _d : 0;
+    const compareAtMin = (_f = (_e = product.compareAtPriceMin) != null ? _e : product.compareAtPrice) != null ? _f : 0;
+    return {
+      ...product,
+      currency,
+      localizedPricing: {
+        currency,
+        priceFormatted: formatPrice(priceMin, currency),
+        priceMinFormatted: formatPrice(priceMin, currency),
+        priceMaxFormatted: formatPrice(priceMax, currency),
+        compareAtPriceFormatted: formatPrice(compareAtMin, currency)
+      }
+    };
+  }
+  function maybeOverrideProductsCurrency(products, currency) {
+    if (!products || !currency) return products;
+    return products.map((p) => applyCurrencyOverride(p, currency));
+  }
+  const operations = {
+    /**
+     * Fetches all products from the store across all pages.
+     *
+     * @returns {Promise<Product[] | null>} Array of all products or null if error occurs
+     *
+     * @throws {Error} When there's a network error or API failure
+     *
+     * @example
+     * ```typescript
+     * const shop = new ShopClient('https://exampleshop.com');
+     * const allProducts = await shop.products.all();
+     *
+     * console.log(`Found ${allProducts?.length} products`);
+     * allProducts?.forEach(product => {
+     *   console.log(product.title, product.price);
+     * });
+     * ```
+     */
+    all: async (options) => {
+      const limit = 250;
+      const allProducts = [];
+      async function fetchAll() {
+        let currentPage = 1;
+        while (true) {
+          const products = await fetchProducts(currentPage, limit);
+          if (!products || products.length === 0 || products.length < limit) {
+            if (products && products.length > 0) {
+              allProducts.push(...products);
+            }
+            break;
+          }
+          allProducts.push(...products);
+          currentPage++;
+        }
+        return allProducts;
+      }
+      try {
+        const products = await fetchAll();
+        return maybeOverrideProductsCurrency(products, options == null ? void 0 : options.currency);
+      } catch (error) {
+        console.error("Failed to fetch all products:", storeDomain, error);
+        throw error;
+      }
+    },
+    /**
+     * Fetches products with pagination support.
+     *
+     * @param options - Pagination options
+     * @param options.page - Page number (default: 1)
+     * @param options.limit - Number of products per page (default: 250, max: 250)
+     *
+     * @returns {Promise<Product[] | null>} Array of products for the specified page or null if error occurs
+     *
+     * @throws {Error} When there's a network error or API failure
+     *
+     * @example
+     * ```typescript
+     * const shop = new ShopClient('https://example.myshopify.com');
+     *
+     * // Get first page with default limit (250)
+     * const firstPage = await shop.products.paginated();
+     *
+     * // Get second page with custom limit
+     * const secondPage = await shop.products.paginated({ page: 2, limit: 50 });
+     * ```
+     */
+    paginated: async (options) => {
+      var _a, _b;
+      const page = (_a = options == null ? void 0 : options.page) != null ? _a : 1;
+      const limit = Math.min((_b = options == null ? void 0 : options.limit) != null ? _b : 250, 250);
+      const url = `${baseUrl}products.json?limit=${limit}&page=${page}`;
+      try {
+        const response = await rateLimitedFetch(url);
+        if (!response.ok) {
+          console.error(
+            `HTTP error! status: ${response.status} for ${storeDomain} page ${page}`
+          );
+          throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        const data = await response.json();
+        if (data.products.length === 0) {
+          return [];
+        }
+        const normalized = productsDto(data.products);
+        return maybeOverrideProductsCurrency(normalized, options == null ? void 0 : options.currency);
+      } catch (error) {
+        console.error(
+          `Error fetching products for ${storeDomain} page ${page} with limit ${limit}:`,
+          error
+        );
+        return null;
+      }
+    },
+    /**
+     * Finds a specific product by its handle.
+     *
+     * @param productHandle - The product handle (URL slug) to search for
+     *
+     * @returns {Promise<Product | null>} The product if found, null if not found
+     *
+     * @throws {Error} When the handle is invalid or there's a network error
+     *
+     * @example
+     * ```typescript
+     * const shop = new ShopClient('https://exampleshop.com');
+     *
+     * // Find product by handle
+     * const product = await shop.products.find('awesome-t-shirt');
+     *
+     * if (product) {
+     *   console.log(product.title, product.price);
+     *   console.log('Available variants:', product.variants.length);
+     * }
+     *
+     * // Handle with query string
+     * const productWithVariant = await shop.products.find('t-shirt?variant=123');
+     * ```
+     */
+    find: async (productHandle, options) => {
+      var _a, _b;
+      if (!productHandle || typeof productHandle !== "string") {
+        throw new Error("Product handle is required and must be a string");
+      }
+      try {
+        let qs = null;
+        if (productHandle.includes("?")) {
+          const parts = productHandle.split("?");
+          const handlePart = (_a = parts[0]) != null ? _a : productHandle;
+          const qsPart = (_b = parts[1]) != null ? _b : null;
+          productHandle = handlePart;
+          qs = qsPart;
+        }
+        const sanitizedHandle = productHandle.trim().replace(/[^a-zA-Z0-9\-_]/g, "");
+        if (!sanitizedHandle) {
+          throw new Error("Invalid product handle format");
+        }
+        if (sanitizedHandle.length > 255) {
+          throw new Error("Product handle is too long");
+        }
+        let finalHandle = sanitizedHandle;
+        try {
+          const htmlResp = await rateLimitedFetch(
+            `${baseUrl}products/${encodeURIComponent(sanitizedHandle)}`
+          );
+          if (htmlResp.ok) {
+            const finalUrl = htmlResp.url;
+            if (finalUrl) {
+              const pathname = new URL(finalUrl).pathname.replace(/\/$/, "");
+              const parts = pathname.split("/").filter(Boolean);
+              const idx = parts.indexOf("products");
+              const maybeHandle = idx >= 0 ? parts[idx + 1] : void 0;
+              if (typeof maybeHandle === "string" && maybeHandle.length) {
+                finalHandle = maybeHandle;
+              }
+            }
+          }
+        } catch {
+        }
+        const url = `${baseUrl}products/${encodeURIComponent(finalHandle)}.js${qs ? `?${qs}` : ""}`;
+        const response = await rateLimitedFetch(url);
+        if (!response.ok) {
+          if (response.status === 404) {
+            return null;
+          }
+          throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        const product = await response.json();
+        const productData = productDto(product);
+        return (options == null ? void 0 : options.currency) ? applyCurrencyOverride(productData, options.currency) : productData;
+      } catch (error) {
+        if (error instanceof Error) {
+          console.error(
+            `Error fetching product ${productHandle}:`,
+            baseUrl,
+            error.message
+          );
+        }
+        throw error;
+      }
+    },
+    /**
+     * Enrich a product by generating merged markdown from body_html and product page.
+     * Adds `enriched_content` to the returned product.
+     */
+    enriched: async (productHandle, options) => {
+      if (!productHandle || typeof productHandle !== "string") {
+        throw new Error("Product handle is required and must be a string");
+      }
+      const apiKey = (options == null ? void 0 : options.apiKey) || process.env.OPENROUTER_API_KEY;
+      if (!apiKey) {
+        throw new Error(
+          "Missing OpenRouter API key. Pass options.apiKey or set OPENROUTER_API_KEY."
+        );
+      }
+      const baseProduct = await operations.find(productHandle);
+      if (!baseProduct) {
+        return null;
+      }
+      const handle = baseProduct.handle;
+      const enriched = await enrichProduct(storeDomain, handle, {
+        apiKey,
+        useGfm: options == null ? void 0 : options.useGfm,
+        inputType: options == null ? void 0 : options.inputType,
+        model: options == null ? void 0 : options.model,
+        outputFormat: options == null ? void 0 : options.outputFormat
+      });
+      return {
+        ...baseProduct,
+        enriched_content: enriched.mergedMarkdown
+      };
+    },
+    classify: async (productHandle, options) => {
+      if (!productHandle || typeof productHandle !== "string") {
+        throw new Error("Product handle is required and must be a string");
+      }
+      const apiKey = (options == null ? void 0 : options.apiKey) || process.env.OPENROUTER_API_KEY;
+      if (!apiKey) {
+        throw new Error(
+          "Missing OpenRouter API key. Pass options.apiKey or set OPENROUTER_API_KEY."
+        );
+      }
+      const enrichedProduct = await operations.enriched(productHandle, {
+        apiKey,
+        inputType: "html",
+        model: options == null ? void 0 : options.model,
+        outputFormat: "json"
+      });
+      if (!enrichedProduct || !enrichedProduct.enriched_content) return null;
+      let productContent = enrichedProduct.enriched_content;
+      try {
+        const obj = JSON.parse(enrichedProduct.enriched_content);
+        const lines = [];
+        if (obj.title && typeof obj.title === "string")
+          lines.push(`Title: ${obj.title}`);
+        if (obj.description && typeof obj.description === "string")
+          lines.push(`Description: ${obj.description}`);
+        if (Array.isArray(obj.materials) && obj.materials.length)
+          lines.push(`Materials: ${obj.materials.join(", ")}`);
+        if (Array.isArray(obj.care) && obj.care.length)
+          lines.push(`Care: ${obj.care.join(", ")}`);
+        if (obj.fit && typeof obj.fit === "string")
+          lines.push(`Fit: ${obj.fit}`);
+        if (obj.returnPolicy && typeof obj.returnPolicy === "string")
+          lines.push(`ReturnPolicy: ${obj.returnPolicy}`);
+        productContent = lines.join("\n");
+      } catch {
+      }
+      const classification = await classifyProduct(productContent, {
+        apiKey,
+        model: options == null ? void 0 : options.model
+      });
+      return classification;
+    },
+    generateSEOContent: async (productHandle, options) => {
+      if (!productHandle || typeof productHandle !== "string") {
+        throw new Error("Product handle is required and must be a string");
+      }
+      const apiKey = (options == null ? void 0 : options.apiKey) || process.env.OPENROUTER_API_KEY;
+      if (!apiKey) {
+        throw new Error(
+          "Missing OpenRouter API key. Pass options.apiKey or set OPENROUTER_API_KEY."
+        );
+      }
+      const baseProduct = await operations.find(productHandle);
+      if (!baseProduct) return null;
+      const payload = {
+        title: baseProduct.title,
+        description: baseProduct.bodyHtml || void 0,
+        vendor: baseProduct.vendor,
+        price: baseProduct.price,
+        tags: baseProduct.tags
+      };
+      const seo = await generateSEOContent(payload, {
+        apiKey,
+        model: options == null ? void 0 : options.model
+      });
+      return seo;
+    },
+    /**
+     * Fetches products that are showcased/featured on the store's homepage.
+     *
+     * @returns {Promise<Product[]>} Array of showcased products found on the homepage
+     *
+     * @throws {Error} When there's a network error or API failure
+     *
+     * @example
+     * ```typescript
+     * const shop = new ShopClient('https://exampleshop.com');
+     * const showcasedProducts = await shop.products.showcased();
+     *
+     * console.log(`Found ${showcasedProducts.length} showcased products`);
+     * showcasedProducts.forEach(product => {
+     *   console.log(`Featured: ${product.title} - ${product.price}`);
+     * });
+     * ```
+     */
+    showcased: async () => {
+      const storeInfo = await getStoreInfo();
+      const products = await Promise.all(
+        storeInfo.showcase.products.map(
+          (productHandle) => findProduct(productHandle)
+        )
+      );
+      return (0, import_remeda.filter)(products, import_remeda.isNonNullish);
+    },
+    /**
+     * Creates a filter map of variant options and their distinct values from all products.
+     *
+     * @returns {Promise<Record<string, string[]> | null>} Map of option names to their distinct values or null if error occurs
+     *
+     * @throws {Error} When there's a network error or API failure
+     *
+     * @example
+     * ```typescript
+     * const shop = new ShopClient('https://exampleshop.com');
+     * const filters = await shop.products.filter();
+     *
+     * console.log('Available filters:', filters);
+     * // Output: { "Size": ["S", "M", "L", "XL"], "Color": ["Red", "Blue", "Green"] }
+     *
+     * // Use filters for UI components
+     * Object.entries(filters || {}).forEach(([optionName, values]) => {
+     *   console.log(`${optionName}: ${values.join(', ')}`);
+     * });
+     * ```
+     */
+    filter: async () => {
+      try {
+        const products = await operations.all();
+        if (!products || products.length === 0) {
+          return {};
+        }
+        const filterMap = {};
+        products.forEach((product) => {
+          if (product.variants && product.variants.length > 0) {
+            if (product.options && product.options.length > 0) {
+              product.options.forEach((option) => {
+                const lowercaseOptionName = option.name.toLowerCase();
+                if (!filterMap[lowercaseOptionName]) {
+                  filterMap[lowercaseOptionName] = /* @__PURE__ */ new Set();
+                }
+                option.values.forEach((value) => {
+                  const trimmed = value == null ? void 0 : value.trim();
+                  if (trimmed) {
+                    let set = filterMap[lowercaseOptionName];
+                    if (!set) {
+                      set = /* @__PURE__ */ new Set();
+                      filterMap[lowercaseOptionName] = set;
+                    }
+                    set.add(trimmed.toLowerCase());
+                  }
+                });
+              });
+            }
+            product.variants.forEach((variant) => {
+              var _a, _b, _c, _d, _e, _f;
+              if (variant.option1) {
+                const optionName = (((_b = (_a = product.options) == null ? void 0 : _a[0]) == null ? void 0 : _b.name) || "Option 1").toLowerCase();
+                let set1 = filterMap[optionName];
+                if (!set1) {
+                  set1 = /* @__PURE__ */ new Set();
+                  filterMap[optionName] = set1;
+                }
+                set1.add(variant.option1.trim().toLowerCase());
+              }
+              if (variant.option2) {
+                const optionName = (((_d = (_c = product.options) == null ? void 0 : _c[1]) == null ? void 0 : _d.name) || "Option 2").toLowerCase();
+                let set2 = filterMap[optionName];
+                if (!set2) {
+                  set2 = /* @__PURE__ */ new Set();
+                  filterMap[optionName] = set2;
+                }
+                set2.add(variant.option2.trim().toLowerCase());
+              }
+              if (variant.option3) {
+                const optionName = (((_f = (_e = product.options) == null ? void 0 : _e[2]) == null ? void 0 : _f.name) || "Option 3").toLowerCase();
+                if (!filterMap[optionName]) {
+                  filterMap[optionName] = /* @__PURE__ */ new Set();
+                }
+                filterMap[optionName].add(variant.option3.trim().toLowerCase());
+              }
+            });
+          }
+        });
+        const result = {};
+        Object.entries(filterMap).forEach(([optionName, valueSet]) => {
+          result[optionName] = Array.from(valueSet).sort();
+        });
+        return result;
+      } catch (error) {
+        console.error("Failed to create product filters:", storeDomain, error);
+        throw error;
+      }
+    }
+  };
+  return operations;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createProductOperations
+});
+//# sourceMappingURL=products.js.map