shop-client 3.14.1 → 3.16.0

package/dist/{chunk-GNIBTUEK.mjs → chunk-ZX4IG4TY.mjs}

@@ -4,15 +4,250 @@ import {
 
 // src/ai/enrich.ts
 import TurndownService from "turndown";
-import { gfm } from "turndown-plugin-gfm";
-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."
-    );
+var DEFAULT_OPENROUTER_MODEL = "openai/gpt-4o-mini";
+var DEFAULT_OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
+var DEFAULT_OPENROUTER_APP_TITLE = "Shop Client";
+var SHOPIFY_PRODUCT_IMAGE_PATTERNS = [
+  "cdn.shopify.com",
+  "/products/",
+  "%2Fproducts%2F",
+  "_large",
+  "_grande",
+  "_1024x1024",
+  "_2048x"
+];
+var TURNDOWN_REMOVE_TAGS = ["script", "style", "nav", "footer"];
+var TURNDOWN_REMOVE_CLASSNAMES = [
+  "product-form",
+  "shopify-payment-button",
+  "shopify-payment-buttons",
+  "product__actions",
+  "product__media-wrapper",
+  "loox-rating",
+  "jdgm-widget",
+  "stamped-reviews",
+  "quantity-selector",
+  "product-atc-wrapper"
+];
+var TURNDOWN_REMOVE_NODE_NAMES = ["button", "input", "select", "label"];
+var cachedGfmPlugin;
+var gfmPluginPromise;
+var cachedTurndownPlain;
+var cachedTurndownGfm;
+async function loadGfmPlugin() {
+  if (cachedGfmPlugin) return cachedGfmPlugin;
+  if (gfmPluginPromise) return gfmPluginPromise;
+  gfmPluginPromise = import("turndown-plugin-gfm").then((mod) => {
+    var _a, _b, _c, _d;
+    const resolved = (_d = (_c = (_b = mod == null ? void 0 : mod.gfm) != null ? _b : (_a = mod == null ? void 0 : mod.default) == null ? void 0 : _a.gfm) != null ? _c : mod == null ? void 0 : mod.default) != null ? _d : mod;
+    cachedGfmPlugin = resolved;
+    return resolved;
+  }).finally(() => {
+    gfmPluginPromise = void 0;
+  });
+  return gfmPluginPromise;
+}
+function configureTurndown(td) {
+  for (const tag of TURNDOWN_REMOVE_TAGS) {
+    td.remove((node) => {
+      var _a;
+      return ((_a = node.nodeName) == null ? void 0 : _a.toLowerCase()) === tag;
+    });
+  }
+  const removeByClass = (className) => td.remove((node) => {
+    const cls = typeof node.getAttribute === "function" ? node.getAttribute("class") || "" : "";
+    return cls.split(/\s+/).includes(className);
+  });
+  for (const className of TURNDOWN_REMOVE_CLASSNAMES) {
+    removeByClass(className);
+  }
+  for (const nodeName of TURNDOWN_REMOVE_NODE_NAMES) {
+    td.remove((node) => {
+      var _a;
+      return ((_a = node.nodeName) == null ? void 0 : _a.toLowerCase()) === nodeName;
+    });
   }
-  return key;
+}
+async function getTurndownService(useGfm) {
+  if (useGfm && cachedTurndownGfm) return cachedTurndownGfm;
+  if (!useGfm && cachedTurndownPlain) return cachedTurndownPlain;
+  const td = new TurndownService({
+    headingStyle: "atx",
+    codeBlockStyle: "fenced",
+    bulletListMarker: "-",
+    emDelimiter: "*",
+    strongDelimiter: "**",
+    linkStyle: "inlined"
+  });
+  if (useGfm) {
+    const gfm = await loadGfmPlugin();
+    if (gfm) td.use(gfm);
+  }
+  configureTurndown(td);
+  if (useGfm) cachedTurndownGfm = td;
+  else cachedTurndownPlain = td;
+  return td;
+}
+function buildEnrichPrompt(args) {
+  const bodyLabel = args.inputType === "html" ? "BODY HTML" : "BODY MARKDOWN";
+  const pageLabel = args.inputType === "html" ? "PAGE HTML" : "PAGE MARKDOWN";
+  if (args.outputFormat === "json") {
+    return {
+      system: "You are a product-data extraction engine. Combine two sources (Shopify body_html and product page) into a single structured summary. Return ONLY valid JSON (no markdown, no code fences, no extra text).",
+      user: `Inputs:
+1) ${bodyLabel}: ${args.inputType === "html" ? "Raw Shopify product body_html" : "Cleaned version of Shopify product body_html"}
+2) ${pageLabel}: ${args.inputType === "html" ? "Raw product page HTML (main section)" : "Extracted product page HTML converted to markdown"}
+
+Return ONLY valid JSON with this shape (include ALL keys; use null/[] when unknown):
+{
+  "title": null | string,
+  "description": null | string,
+  "highlights": string[] | [],
+  "features": string[] | [],
+  "specs": Record<string, string> | {},
+  "materials": string[] | [],
+  "care": string[] | [],
+  "fit": null | string,
+  "sizeGuide": null | string,
+  "shipping": null | string,
+  "warranty": null | string,
+  "images": null | string[],
+  "returnPolicy": null | string
+}
+
+Rules:
+- Use BOTH sources and deduplicate overlapping content.
+- Prefer the more specific / more recent details when sources differ; never invent facts.
+- Do not invent facts; if a field is unavailable, use null or []
+- Prefer concise, factual statements (avoid marketing fluff).
+- Keep units and measurements as written (e.g., inches/cm); do not convert unless explicitly provided.
+- Do NOT include product gallery/hero images in "images"; include only documentation images like size charts or measurement guides. If none, set "images": null.
+- "specs" is a flat key/value map for concrete attributes (e.g., "Made in": "Portugal", "Weight": "320g"). Use {} if none.
+
+${bodyLabel}:
+${args.bodyInput}
+
+${pageLabel}:
+${args.pageInput}`
+    };
+  }
+  return {
+    system: "You merge Shopify product content into a single buyer-ready markdown description. Output ONLY markdown (no code fences, no commentary).",
+    user: `Inputs:
+1) ${bodyLabel}: ${args.inputType === "html" ? "Raw Shopify product body_html" : "Cleaned version of Shopify product body_html"}
+2) ${pageLabel}: ${args.inputType === "html" ? "Raw product page HTML (main section)" : "Extracted product page HTML converted to markdown"}
+
+Tasks:
+- Merge both sources into a single clean markdown document and deduplicate overlap.
+- Keep only buyer-useful info (concrete details); remove theme/UI junk, menus, buttons, upsells, reviews widgets, legal boilerplate.
+- Do NOT include product gallery/hero images. If documentation images exist (size chart, measurement guide, care diagram), include them.
+- Do NOT list interactive option selectors (e.g., "Choose Size" buttons), but DO keep meaningful option information (e.g., sizing notes, fit guidance, measurement tables, what's included).
+- If sources disagree, prefer the more specific detail; never invent facts.
+- Do not write "information not available" or similar.
+- Use this section order when content exists (omit empty sections):
+  - ## Overview (2\u20134 sentences)
+  - ## Key Features (bullets)
+  - ## Materials
+  - ## Care
+  - ## Fit & Sizing
+  - ## Size Guide (include documentation images + key measurements)
+  - ## Shipping & Returns
+
+${bodyLabel}:
+${args.bodyInput}
+
+${pageLabel}:
+${args.pageInput}`
+  };
+}
+function buildClassifyPrompt(productContent) {
+  return {
+    system: "You classify products using a three-tier hierarchy. Return only valid JSON without markdown or code fences.",
+    user: `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
+}`
+  };
+}
+async function buildEnrichPromptForProduct(domain, handle, options) {
+  var _a, _b;
+  const ajaxProductPromise = fetchAjaxProduct(domain, handle);
+  const pageHtmlPromise = (options == null ? void 0 : options.htmlContent) ? Promise.resolve(options.htmlContent) : fetchProductPage(domain, handle);
+  const [ajaxProduct, pageHtml] = await Promise.all([
+    ajaxProductPromise,
+    pageHtmlPromise
+  ]);
+  const bodyHtml = ajaxProduct.description || "";
+  const extractedHtml = extractMainSection(pageHtml);
+  const inputType = (_a = options == null ? void 0 : options.inputType) != null ? _a : "markdown";
+  const outputFormat = (_b = options == null ? void 0 : options.outputFormat) != null ? _b : "markdown";
+  const bodyInput = inputType === "html" ? bodyHtml : await htmlToMarkdown(bodyHtml, { useGfm: options == null ? void 0 : options.useGfm });
+  const pageInput = inputType === "html" ? extractedHtml || pageHtml : await htmlToMarkdown(extractedHtml || pageHtml, {
+    useGfm: options == null ? void 0 : options.useGfm
+  });
+  return buildEnrichPrompt({ bodyInput, pageInput, inputType, outputFormat });
+}
+async function buildClassifyPromptForProduct(domain, handle, options) {
+  var _a;
+  const ajaxProductPromise = fetchAjaxProduct(domain, handle);
+  const pageHtmlPromise = (options == null ? void 0 : options.htmlContent) ? Promise.resolve(options.htmlContent) : fetchProductPage(domain, handle);
+  const [ajaxProduct, pageHtml] = await Promise.all([
+    ajaxProductPromise,
+    pageHtmlPromise
+  ]);
+  const bodyHtml = ajaxProduct.description || "";
+  const extractedHtml = extractMainSection(pageHtml);
+  const inputType = (_a = options == null ? void 0 : options.inputType) != null ? _a : "markdown";
+  const bodyInput = inputType === "html" ? bodyHtml : await htmlToMarkdown(bodyHtml, { useGfm: options == null ? void 0 : options.useGfm });
+  const pageInput = inputType === "html" ? extractedHtml || pageHtml : await htmlToMarkdown(extractedHtml || pageHtml, {
+    useGfm: options == null ? void 0 : options.useGfm
+  });
+  const header = [
+    `Title: ${String(ajaxProduct.title || "")}`.trim(),
+    ajaxProduct.vendor ? `Vendor: ${String(ajaxProduct.vendor)}` : null,
+    Array.isArray(ajaxProduct.tags) && ajaxProduct.tags.length ? `Tags: ${ajaxProduct.tags.join(", ")}` : null
+  ].filter((s) => Boolean(s && s.trim())).join("\n");
+  const productContent = [
+    header,
+    `Body:
+${bodyInput}`.trim(),
+    `Page:
+${pageInput}`.trim()
+  ].filter((s) => Boolean(s && s.trim())).join("\n\n");
+  return buildClassifyPrompt(productContent);
 }
 function normalizeDomainToBase(domain) {
   if (domain.startsWith("http://") || domain.startsWith("https://")) {
@@ -51,111 +286,41 @@ function extractMainSection(html) {
   if (endIndex === -1) return null;
   return html.substring(startIndex, endIndex + "</section>".length);
 }
-function htmlToMarkdown(html, options) {
+async function htmlToMarkdown(html, options) {
   var _a;
   if (!html) return "";
-  const td = new TurndownService({
-    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(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);
+  const td = await getTurndownService(useGfm);
   return td.turndown(html);
 }
 async function mergeWithLLM(bodyInput, pageInput, options) {
-  var _a, _b;
+  var _a, _b, _c, _d, _e, _f;
   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);
+  const outputFormat = (_b = options == null ? void 0 : options.outputFormat) != null ? _b : "markdown";
+  const prompts = buildEnrichPrompt({
+    bodyInput,
+    pageInput,
+    inputType,
+    outputFormat
+  });
+  const openRouter = options == null ? void 0 : options.openRouter;
+  const offline = (_c = openRouter == null ? void 0 : openRouter.offline) != null ? _c : false;
+  const apiKey = (_d = options == null ? void 0 : options.apiKey) != null ? _d : openRouter == null ? void 0 : openRouter.apiKey;
+  if (!offline && !apiKey) {
+    throw new Error(
+      "Missing OpenRouter API key. Pass apiKey or set ShopClient options.openRouter.apiKey."
+    );
+  }
+  const model = (_f = (_e = options == null ? void 0 : options.model) != null ? _e : openRouter == null ? void 0 : openRouter.model) != null ? _f : DEFAULT_OPENROUTER_MODEL;
+  const result = await callOpenRouter({
+    model,
+    messages: [
+      { role: "system", content: prompts.system },
+      { role: "user", content: prompts.user }
+    ],
+    apiKey,
+    openRouter
+  });
   if ((options == null ? void 0 : options.outputFormat) === "json") {
     const cleaned = result.replace(/```json|```/g, "").trim();
     const obj = safeParseJson(cleaned);
@@ -171,16 +336,7 @@ ${pageInput}
       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(
+        const looksLikeProductImage = SHOPIFY_PRODUCT_IMAGE_PATTERNS.some(
           (p) => u.includes(p)
         );
         return !looksLikeProductImage;
@@ -244,30 +400,44 @@ function validateStructuredJson(obj) {
   }
   return { ok: true };
 }
-async function callOpenRouter(model, prompt, apiKey) {
-  var _a, _b, _c;
-  if (process.env.OPENROUTER_OFFLINE === "1") {
-    return mockOpenRouterResponse(prompt);
+async function callOpenRouter(args) {
+  var _a, _b, _c, _d, _e, _f, _g, _h;
+  const openRouter = args.openRouter;
+  if (openRouter == null ? void 0 : openRouter.offline) {
+    return mockOpenRouterResponse(
+      args.messages.map((m) => m.content).join("\n")
+    );
+  }
+  const apiKey = (_a = args.apiKey) != null ? _a : openRouter == null ? void 0 : openRouter.apiKey;
+  if (!apiKey) {
+    throw new Error(
+      "Missing OpenRouter API key. Pass apiKey or set ShopClient options.openRouter.apiKey."
+    );
   }
   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 Client";
+  const referer = openRouter == null ? void 0 : openRouter.siteUrl;
+  const title = (_b = openRouter == null ? void 0 : openRouter.appTitle) != null ? _b : DEFAULT_OPENROUTER_APP_TITLE;
   if (referer) headers["HTTP-Referer"] = referer;
   if (title) headers["X-Title"] = title;
   const buildPayload = (m) => ({
     model: m,
-    messages: [{ role: "user", content: prompt }],
+    messages: args.messages,
     temperature: 0.2
   });
-  const base = (process.env.OPENROUTER_BASE_URL || "https://openrouter.ai/api/v1").replace(/\/$/, "");
+  const base = ((_c = openRouter == null ? void 0 : openRouter.baseUrl) != null ? _c : DEFAULT_OPENROUTER_BASE_URL).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 fallbackModels = ((_d = openRouter == null ? void 0 : openRouter.fallbackModels) != null ? _d : []).filter(
+    (s) => typeof s === "string" && Boolean(s.trim())
+  );
+  const defaultModel = (_e = openRouter == null ? void 0 : openRouter.model) != null ? _e : DEFAULT_OPENROUTER_MODEL;
   const modelsToTry = Array.from(
-    /* @__PURE__ */ new Set([model, ...fallbackEnv, defaultModel])
+    /* @__PURE__ */ new Set([args.model, ...fallbackModels, defaultModel])
   ).filter(Boolean);
   let lastErrorText = "";
   for (const m of modelsToTry) {
@@ -290,7 +460,7 @@ async function callOpenRouter(model, prompt, apiKey) {
           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;
+        const content = (_h = (_g = (_f = data == null ? void 0 : data.choices) == null ? void 0 : _f[0]) == null ? void 0 : _g.message) == null ? void 0 : _h.content;
         if (typeof content === "string") return content;
         lastErrorText = JSON.stringify(data);
         await new Promise((r) => setTimeout(r, 200));
@@ -333,18 +503,25 @@ function mockOpenRouterResponse(prompt) {
 }
 async function enrichProduct(domain, handle, options) {
   var _a;
-  const ajaxProduct = await fetchAjaxProduct(domain, handle);
+  const ajaxProductPromise = fetchAjaxProduct(domain, handle);
+  const pageHtmlPromise = (options == null ? void 0 : options.htmlContent) ? Promise.resolve(options.htmlContent) : fetchProductPage(domain, handle);
+  const [ajaxProduct, pageHtml] = await Promise.all([
+    ajaxProductPromise,
+    pageHtmlPromise
+  ]);
   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 bodyInput = inputType === "html" ? bodyHtml : await htmlToMarkdown(bodyHtml, { useGfm: options == null ? void 0 : options.useGfm });
+  const pageInput = inputType === "html" ? extractedHtml || pageHtml : await htmlToMarkdown(extractedHtml || pageHtml, {
+    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
+    outputFormat: options == null ? void 0 : options.outputFormat,
+    openRouter: options == null ? void 0 : options.openRouter
   });
   if ((options == null ? void 0 : options.outputFormat) === "json") {
     try {
@@ -379,16 +556,7 @@ async function enrichProduct(domain, handle, options) {
           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(
+          const looksLikeProductImage = SHOPIFY_PRODUCT_IMAGE_PATTERNS.some(
             (p) => u.includes(p)
           );
           return !looksLikeProductImage;
@@ -413,48 +581,26 @@ async function enrichProduct(domain, handle, options) {
   };
 }
 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);
+  var _a, _b, _c, _d;
+  const openRouter = options == null ? void 0 : options.openRouter;
+  const offline = (_a = openRouter == null ? void 0 : openRouter.offline) != null ? _a : false;
+  const apiKey = (_b = options == null ? void 0 : options.apiKey) != null ? _b : openRouter == null ? void 0 : openRouter.apiKey;
+  if (!offline && !apiKey) {
+    throw new Error(
+      "Missing OpenRouter API key. Pass apiKey or set ShopClient options.openRouter.apiKey."
+    );
+  }
+  const model = (_d = (_c = options == null ? void 0 : options.model) != null ? _c : openRouter == null ? void 0 : openRouter.model) != null ? _d : DEFAULT_OPENROUTER_MODEL;
+  const prompts = buildClassifyPrompt(productContent);
+  const raw = await callOpenRouter({
+    model,
+    messages: [
+      { role: "system", content: prompts.system },
+      { role: "user", content: prompts.user }
+    ],
+    apiKey,
+    openRouter
+  });
   const cleaned = raw.replace(/```json|```/g, "").trim();
   const parsed = safeParseJson(cleaned);
   if (!parsed.ok) {
@@ -524,11 +670,12 @@ function validateClassification(obj) {
   };
 }
 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") {
+  var _a, _b, _c, _d;
+  const openRouter = options == null ? void 0 : options.openRouter;
+  const offline = (_a = openRouter == null ? void 0 : openRouter.offline) != null ? _a : false;
+  const apiKey = (_b = options == null ? void 0 : options.apiKey) != null ? _b : openRouter == null ? void 0 : openRouter.apiKey;
+  const model = (_d = (_c = options == null ? void 0 : options.model) != null ? _c : openRouter == null ? void 0 : openRouter.model) != null ? _d : DEFAULT_OPENROUTER_MODEL;
+  if (offline) {
     const baseTags = Array.isArray(product.tags) ? product.tags.slice(0, 6) : [];
     const titlePart = product.title.trim().slice(0, 50);
     const vendorPart = (product.vendor || "").trim();
@@ -572,7 +719,23 @@ Return ONLY valid JSON (no markdown, no code fences) with keys: {
   "tags": string[],
   "marketingCopy": string
 }`;
-  const raw = await callOpenRouter(model, prompt, apiKey);
+  if (!apiKey) {
+    throw new Error(
+      "Missing OpenRouter API key. Pass apiKey or set ShopClient options.openRouter.apiKey."
+    );
+  }
+  const raw = await callOpenRouter({
+    model,
+    messages: [
+      {
+        role: "system",
+        content: "You generate SEO content and return only valid JSON without markdown or code fences."
+      },
+      { role: "user", content: prompt }
+    ],
+    apiKey,
+    openRouter
+  });
   const cleaned = raw.replace(/```json|```/g, "").trim();
   const parsed = safeParseJson(cleaned);
   if (!parsed.ok) {
@@ -621,10 +784,11 @@ function validateSEOContent(obj) {
   };
 }
 async function determineStoreType(storeInfo, options) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
-  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;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
+  const openRouter = options == null ? void 0 : options.openRouter;
+  const offline = (_a = openRouter == null ? void 0 : openRouter.offline) != null ? _a : false;
+  const apiKey = (_b = options == null ? void 0 : options.apiKey) != null ? _b : openRouter == null ? void 0 : openRouter.apiKey;
+  const model = (_d = (_c = options == null ? void 0 : options.model) != null ? _c : openRouter == null ? void 0 : openRouter.model) != null ? _d : DEFAULT_OPENROUTER_MODEL;
   const productLines = Array.isArray(storeInfo.showcase.products) ? storeInfo.showcase.products.slice(0, 10).map((p) => {
     if (typeof p === "string") return `- ${p}`;
     const pt = typeof (p == null ? void 0 : p.productType) === "string" && p.productType.trim() ? p.productType : "N/A";
@@ -635,16 +799,16 @@ async function determineStoreType(storeInfo, options) {
     return `- ${String((c == null ? void 0 : c.title) || "N/A")}`;
   }) : [];
   const storeContent = `Store Title: ${storeInfo.title}
-Store Description: ${(_b = storeInfo.description) != null ? _b : "N/A"}
+Store Description: ${(_e = storeInfo.description) != null ? _e : "N/A"}
 
 Sample Products:
 ${productLines.join("\n") || "- N/A"}
 
 Sample Collections:
 ${collectionLines.join("\n") || "- N/A"}`;
-  const textNormalized = `${storeInfo.title} ${(_c = storeInfo.description) != null ? _c : ""} ${productLines.join(" ")} ${collectionLines.join(" ")}`.toLowerCase();
-  if (process.env.OPENROUTER_OFFLINE === "1") {
-    const text = `${storeInfo.title} ${(_d = storeInfo.description) != null ? _d : ""} ${productLines.join(" ")} ${collectionLines.join(" ")}`.toLowerCase();
+  const textNormalized = `${storeInfo.title} ${(_f = storeInfo.description) != null ? _f : ""} ${productLines.join(" ")} ${collectionLines.join(" ")}`.toLowerCase();
+  if (offline) {
+    const text = `${storeInfo.title} ${(_g = storeInfo.description) != null ? _g : ""} ${productLines.join(" ")} ${collectionLines.join(" ")}`.toLowerCase();
     const verticalKeywords = {
       clothing: /(dress|shirt|pant|jean|hoodie|tee|t[- ]?shirt|sneaker|apparel|clothing)/,
       beauty: /(skincare|moisturizer|serum|beauty|cosmetic|makeup)/,
@@ -660,14 +824,14 @@ ${collectionLines.join("\n") || "- N/A"}`;
       adult_female: /\bwomen\b|\bfemale\b|\bwoman\b|\bwomens\b/
     };
     const audiences = [];
-    if ((_e = audienceKeywords.kid) == null ? void 0 : _e.test(text)) {
-      if ((_f = audienceKeywords.kid_male) == null ? void 0 : _f.test(text)) audiences.push("kid_male");
-      if ((_g = audienceKeywords.kid_female) == null ? void 0 : _g.test(text)) audiences.push("kid_female");
-      if (!((_h = audienceKeywords.kid_male) == null ? void 0 : _h.test(text)) && !((_i = audienceKeywords.kid_female) == null ? void 0 : _i.test(text)))
+    if ((_h = audienceKeywords.kid) == null ? void 0 : _h.test(text)) {
+      if ((_i = audienceKeywords.kid_male) == null ? void 0 : _i.test(text)) audiences.push("kid_male");
+      if ((_j = audienceKeywords.kid_female) == null ? void 0 : _j.test(text)) audiences.push("kid_female");
+      if (!((_k = audienceKeywords.kid_male) == null ? void 0 : _k.test(text)) && !((_l = audienceKeywords.kid_female) == null ? void 0 : _l.test(text)))
         audiences.push("generic");
     } else {
-      if ((_j = audienceKeywords.adult_male) == null ? void 0 : _j.test(text)) audiences.push("adult_male");
-      if ((_k = audienceKeywords.adult_female) == null ? void 0 : _k.test(text))
+      if ((_m = audienceKeywords.adult_male) == null ? void 0 : _m.test(text)) audiences.push("adult_male");
+      if ((_n = audienceKeywords.adult_female) == null ? void 0 : _n.test(text))
         audiences.push("adult_female");
       if (audiences.length === 0) audiences.push("generic");
     }
@@ -713,7 +877,23 @@ Rules:
 - Nested keys MUST be vertical: "clothing" | "beauty" | "accessories" | "home-decor" | "food-and-beverages".
 - Values MUST be non-empty arrays of category strings.
 `;
-  const raw = await callOpenRouter(model, prompt, apiKey);
+  if (!apiKey) {
+    throw new Error(
+      "Missing OpenRouter API key. Pass apiKey or set ShopClient options.openRouter.apiKey."
+    );
+  }
+  const raw = await callOpenRouter({
+    model,
+    messages: [
+      {
+        role: "system",
+        content: "You analyze a Shopify store and return only valid JSON without markdown or code fences."
+      },
+      { role: "user", content: prompt }
+    ],
+    apiKey,
+    openRouter
+  });
   const cleaned = raw.replace(/```json|```/g, "").trim();
   const parsed = safeParseJson(cleaned);
   if (!parsed.ok) {
@@ -852,6 +1032,10 @@ function pruneBreakdownForSignals(breakdown, text) {
 }
 
 export {
+  buildEnrichPrompt,
+  buildClassifyPrompt,
+  buildEnrichPromptForProduct,
+  buildClassifyPromptForProduct,
   fetchAjaxProduct,
   fetchProductPage,
   extractMainSection,