shop-client 3.15.0 → 3.17.0

package/dist/{chunk-2W623LCW.mjs → chunk-5TGMDRUF.mjs}

@@ -1,6 +1,6 @@
 import {
   rateLimitedFetch
-} from "./chunk-D5MTUWFO.mjs";
+} from "./chunk-O77Z6OBJ.mjs";
 
 // src/ai/enrich.ts
 import TurndownService from "turndown";
@@ -30,6 +30,42 @@ var TURNDOWN_REMOVE_CLASSNAMES = [
   "product-atc-wrapper"
 ];
 var TURNDOWN_REMOVE_NODE_NAMES = ["button", "input", "select", "label"];
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isOneOf(values, value) {
+  return typeof value === "string" && values.includes(value);
+}
+function toOptionalStringOrNull(value) {
+  return typeof value === "string" ? value : null;
+}
+function getErrorMessage(err) {
+  if (err instanceof Error) return err.message;
+  return String(err);
+}
+function resolveGfmPlugin(mod) {
+  if (!isRecord(mod)) return mod;
+  const gfm = mod.gfm;
+  if (typeof gfm === "function" || isRecord(gfm)) return gfm;
+  const def = mod.default;
+  if (isRecord(def)) {
+    const defGfm = def.gfm;
+    if (typeof defGfm === "function" || isRecord(defGfm)) return defGfm;
+    return def;
+  }
+  return mod;
+}
+function extractOpenRouterContent(data) {
+  if (!isRecord(data)) return null;
+  const choices = data.choices;
+  if (!Array.isArray(choices) || choices.length === 0) return null;
+  const first = choices[0];
+  if (!isRecord(first)) return null;
+  const message = first.message;
+  if (!isRecord(message)) return null;
+  const content = message.content;
+  return typeof content === "string" ? content : null;
+}
 var cachedGfmPlugin;
 var gfmPluginPromise;
 var cachedTurndownPlain;
@@ -38,8 +74,7 @@ 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;
+    const resolved = resolveGfmPlugin(mod);
     cachedGfmPlugin = resolved;
     return resolved;
   }).finally(() => {
@@ -55,7 +90,7 @@ function configureTurndown(td) {
     });
   }
   const removeByClass = (className) => td.remove((node) => {
-    const cls = typeof node.getAttribute === "function" ? node.getAttribute("class") || "" : "";
+    const cls = isRecord(node) && typeof node.getAttribute === "function" ? String(node.getAttribute("class") || "") : "";
     return cls.split(/\s+/).includes(className);
   });
   for (const className of TURNDOWN_REMOVE_CLASSNAMES) {
@@ -204,9 +239,11 @@ Return ONLY valid JSON (no markdown, no code fences) with keys:
 }
 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([
-    fetchAjaxProduct(domain, handle),
-    fetchProductPage(domain, handle)
+    ajaxProductPromise,
+    pageHtmlPromise
   ]);
   const bodyHtml = ajaxProduct.description || "";
   const extractedHtml = extractMainSection(pageHtml);
@@ -220,9 +257,11 @@ async function buildEnrichPromptForProduct(domain, handle, options) {
 }
 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([
-    fetchAjaxProduct(domain, handle),
-    fetchProductPage(domain, handle)
+    ajaxProductPromise,
+    pageHtmlPromise
   ]);
   const bodyHtml = ajaxProduct.description || "";
   const extractedHtml = extractMainSection(pageHtml);
@@ -328,16 +367,18 @@ async function mergeWithLLM(bodyInput, pageInput, options) {
       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 looksLikeProductImage = SHOPIFY_PRODUCT_IMAGE_PATTERNS.some(
-          (p) => u.includes(p)
-        );
-        return !looksLikeProductImage;
-      });
-      value.images = filtered.length > 0 ? filtered : null;
+    if (isRecord(value)) {
+      const images = value.images;
+      if (Array.isArray(images)) {
+        const filtered = images.filter((url) => typeof url === "string").filter((url) => {
+          const u = url.toLowerCase();
+          const looksLikeProductImage = SHOPIFY_PRODUCT_IMAGE_PATTERNS.some(
+            (p) => u.includes(p)
+          );
+          return !looksLikeProductImage;
+        });
+        value.images = filtered.length > 0 ? filtered : null;
+      }
     }
     return JSON.stringify(value);
   }
@@ -348,7 +389,7 @@ function safeParseJson(input) {
     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" };
+    return { ok: false, error: getErrorMessage(err) || "Failed to parse JSON" };
   }
 }
 function validateStructuredJson(obj) {
@@ -356,16 +397,16 @@ function validateStructuredJson(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")) {
+  if ("title" in o && !(o.title === null || typeof o.title === "string" || o.title === void 0)) {
     return { ok: false, error: "title must be null or string" };
   }
-  if ("description" in o && !(o.description === null || typeof o.description === "string")) {
+  if ("description" in o && !(o.description === null || typeof o.description === "string" || o.description === void 0)) {
     return { ok: false, error: "description must be null or string" };
   }
-  if ("fit" in o && !(o.fit === null || typeof o.fit === "string")) {
+  if ("fit" in o && !(o.fit === null || typeof o.fit === "string" || o.fit === void 0)) {
     return { ok: false, error: "fit must be null or string" };
   }
-  if ("returnPolicy" in o && !(o.returnPolicy === null || typeof o.returnPolicy === "string")) {
+  if ("returnPolicy" in o && !(o.returnPolicy === null || typeof o.returnPolicy === "string" || o.returnPolicy === void 0)) {
     return { ok: false, error: "returnPolicy must be null or string" };
   }
   const validateStringArray = (arr, field) => {
@@ -397,7 +438,7 @@ function validateStructuredJson(obj) {
   return { ok: true };
 }
 async function callOpenRouter(args) {
-  var _a, _b, _c, _d, _e, _f, _g, _h;
+  var _a, _b, _c, _d, _e;
   const openRouter = args.openRouter;
   if (openRouter == null ? void 0 : openRouter.offline) {
     return mockOpenRouterResponse(
@@ -456,12 +497,12 @@ async function callOpenRouter(args) {
           continue;
         }
         const data = await response.json();
-        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;
+        const content = extractOpenRouterContent(data);
         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)}`;
+        lastErrorText = `${url}: ${getErrorMessage(err)}`;
         await new Promise((r) => setTimeout(r, 200));
       }
     }
@@ -499,9 +540,11 @@ function mockOpenRouterResponse(prompt) {
 }
 async function enrichProduct(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([
-    fetchAjaxProduct(domain, handle),
-    fetchProductPage(domain, handle)
+    ajaxProductPromise,
+    pageHtmlPromise
   ]);
   const bodyHtml = ajaxProduct.description || "";
   const extractedHtml = extractMainSection(pageHtml);
@@ -607,7 +650,6 @@ async function classifyProduct(productContent, options) {
   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" };
   }
@@ -619,7 +661,7 @@ function validateClassification(obj) {
     "kid_female",
     "generic"
   ];
-  if (typeof o.audience !== "string" || !audienceValues.includes(o.audience)) {
+  if (!isOneOf(audienceValues, o.audience)) {
     return {
       ok: false,
       error: "audience must be one of: adult_male, adult_female, kid_male, kid_female, generic"
@@ -632,16 +674,16 @@ function validateClassification(obj) {
     "home-decor",
     "food-and-beverages"
   ];
-  if (typeof o.vertical !== "string" || !verticalValues.includes(o.vertical)) {
+  if (!isOneOf(verticalValues, 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")) {
+  if ("category" in o && !(o.category === null || typeof o.category === "string" || o.category === void 0)) {
     return { ok: false, error: "category must be null or string" };
   }
-  if ("subCategory" in o && !(o.subCategory === null || typeof o.subCategory === "string")) {
+  if ("subCategory" in o && !(o.subCategory === null || typeof o.subCategory === "string" || o.subCategory === void 0)) {
     return { ok: false, error: "subCategory must be null or string" };
   }
   if (typeof o.subCategory === "string") {
@@ -653,13 +695,15 @@ function validateClassification(obj) {
       };
     }
   }
+  const category = toOptionalStringOrNull(o.category);
+  const subCategory = toOptionalStringOrNull(o.subCategory);
   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
+      category,
+      subCategory
     }
   };
 }
@@ -754,7 +798,8 @@ function validateSEOContent(obj) {
     "marketingCopy"
   ];
   for (const key of requiredStrings) {
-    if (typeof o[key] !== "string" || !o[key].trim()) {
+    const v = o[key];
+    if (typeof v !== "string" || !v.trim()) {
       return { ok: false, error: `${key} must be a non-empty string` };
     }
   }
@@ -783,15 +828,15 @@ async function determineStoreType(storeInfo, options) {
   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) => {
+  const productLines = 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";
-    return `- ${String((p == null ? void 0 : p.title) || "N/A")}: ${pt}`;
-  }) : [];
-  const collectionLines = Array.isArray(storeInfo.showcase.collections) ? storeInfo.showcase.collections.slice(0, 5).map((c) => {
+    const pt = typeof p.productType === "string" && p.productType.trim() ? p.productType : "N/A";
+    return `- ${String(p.title || "N/A")}: ${pt}`;
+  });
+  const collectionLines = storeInfo.showcase.collections.slice(0, 5).map((c) => {
     if (typeof c === "string") return `- ${c}`;
-    return `- ${String((c == null ? void 0 : c.title) || "N/A")}`;
-  }) : [];
+    return `- ${String(c.title || "N/A")}`;
+  });
   const storeContent = `Store Title: ${storeInfo.title}
 Store Description: ${(_e = storeInfo.description) != null ? _e : "N/A"}
 
@@ -920,6 +965,8 @@ function validateStoreTypeBreakdown(obj) {
     "home-decor",
     "food-and-beverages"
   ];
+  const audienceKeySet = new Set(audienceKeys);
+  const verticalKeySet = new Set(verticalKeys);
   const o = obj;
   const out = {};
   const keys = Object.keys(o);
@@ -927,7 +974,7 @@ function validateStoreTypeBreakdown(obj) {
     return { ok: false, error: "At least one audience key is required" };
   }
   for (const aKey of keys) {
-    if (!audienceKeys.includes(aKey)) {
+    if (!audienceKeySet.has(aKey)) {
       return { ok: false, error: `Invalid audience key: ${aKey}` };
     }
     const vObj = o[aKey];
@@ -938,14 +985,15 @@ function validateStoreTypeBreakdown(obj) {
       };
     }
     const vOut = {};
-    for (const vKey of Object.keys(vObj)) {
-      if (!verticalKeys.includes(vKey)) {
+    const vRec = vObj;
+    for (const vKey of Object.keys(vRec)) {
+      if (!verticalKeySet.has(vKey)) {
         return {
           ok: false,
           error: `Invalid vertical key ${vKey} for audience ${aKey}`
         };
       }
-      const cats = vObj[vKey];
+      const cats = vRec[vKey];
       if (!Array.isArray(cats) || cats.length === 0 || !cats.every((c) => typeof c === "string" && c.trim())) {
         return {
           ok: false,
@@ -998,14 +1046,16 @@ function pruneBreakdownForSignals(breakdown, text) {
   );
   if (signaledVerticals.size === 0) signaledVerticals.add("accessories");
   const pruned = {};
-  for (const [audience, verticals] of Object.entries(breakdown)) {
+  for (const audience of Object.keys(breakdown)) {
     const a = audience;
     if (!signaledAudiences.has(a)) continue;
+    const verticals = breakdown[a];
     const vOut = {};
-    for (const [vertical, categories] of Object.entries(verticals || {})) {
+    for (const vertical of Object.keys(verticals || {})) {
       const v = vertical;
       if (!signaledVerticals.has(v)) continue;
-      vOut[v] = categories;
+      const categories = verticals == null ? void 0 : verticals[v];
+      if (categories) vOut[v] = categories;
     }
     if (Object.keys(vOut).length > 0) {
       pruned[a] = vOut;

package/dist/{chunk-D5MTUWFO.mjs → chunk-O77Z6OBJ.mjs}

@@ -13,8 +13,12 @@ var RateLimiter = class {
       this.tokens = this.options.maxRequestsPerInterval;
       this.tryRun();
     }, this.options.intervalMs);
-    if (this.refillTimer && typeof this.refillTimer.unref === "function") {
-      this.refillTimer.unref();
+    const t = this.refillTimer;
+    if (t && typeof t === "object") {
+      const rec = t;
+      if (typeof rec.unref === "function") {
+        rec.unref();
+      }
     }
   }
   ensureRefillStarted() {
@@ -34,7 +38,11 @@ var RateLimiter = class {
   schedule(fn) {
     return new Promise((resolve, reject) => {
       this.ensureRefillStarted();
-      this.queue.push({ fn, resolve, reject });
+      this.queue.push({
+        fn,
+        resolve,
+        reject
+      });
       this.tryRun();
     });
   }
@@ -70,7 +78,8 @@ function getHost(input) {
     if (input instanceof URL) {
       return input.host;
     }
-    const url = input.url;
+    const rec = input;
+    const url = typeof rec.url === "string" ? rec.url : void 0;
     if (url) {
       return new URL(url).host;
     }
@@ -162,6 +171,12 @@ async function rateLimitedFetch(input, init) {
     ...init,
     signal: hasSignal ? init == null ? void 0 : init.signal : controller == null ? void 0 : controller.signal
   };
+  const {
+    rateLimitClass: _klass,
+    retry: _retry,
+    timeoutMs: _timeoutMs,
+    ...fetchInit
+  } = effInit;
   const klass = init == null ? void 0 : init.rateLimitClass;
   const byClass = klass ? classLimiters.get(klass) : void 0;
   const byHost = getHostLimiter(getHost(input));
@@ -175,9 +190,9 @@ async function rateLimitedFetch(input, init) {
   while (attempt <= maxRetries) {
     try {
       if (eff) {
-        response = await eff.schedule(() => fetch(input, effInit));
+        response = await eff.schedule(() => fetch(input, fetchInit));
       } else {
-        response = await fetch(input, effInit);
+        response = await fetch(input, fetchInit);
       }
       if (!response || response.ok || !retryOnStatuses.includes(response.status)) {
         if (timer) clearTimeout(timer);

package/dist/{chunk-G7OCMGA6.mjs → chunk-SBHTEKLB.mjs}

@@ -93,7 +93,9 @@ async function detectShopCountry(html) {
     try {
       const raw = currencyJsonMatch[1];
       const obj = JSON.parse(raw || "{}");
-      const activeCode = typeof (obj == null ? void 0 : obj.active) === "string" ? obj.active.toUpperCase() : void 0;
+      const rec = obj && typeof obj === "object" ? obj : null;
+      const active = rec && typeof rec.active === "string" ? rec.active : void 0;
+      const activeCode = active ? active.toUpperCase() : void 0;
       const iso = activeCode ? CURRENCY_CODE_TO_COUNTRY[activeCode] : void 0;
       if (activeCode) {
         detectedCurrencyCode = activeCode;

package/dist/{chunk-OA76XD32.mjs → chunk-YWAW6C74.mjs}

@@ -1,9 +1,9 @@
 import {
   rateLimitedFetch
-} from "./chunk-D5MTUWFO.mjs";
+} from "./chunk-O77Z6OBJ.mjs";
 import {
   detectShopCountry
-} from "./chunk-G7OCMGA6.mjs";
+} from "./chunk-SBHTEKLB.mjs";
 import {
   extractDomainWithoutSuffix,
   generateStoreSlug,
@@ -13,7 +13,7 @@ import {
 // src/client/get-info.ts
 import { unique } from "remeda";
 async function getInfoForShop(args, options) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q;
   const {
     baseUrl,
     storeDomain,
@@ -212,9 +212,9 @@ async function getInfoForShop(args, options) {
       subDomain: myShopifySubdomain != null ? myShopifySubdomain : null
     },
     country: countryDetection.country,
-    currency: (countryDetection == null ? void 0 : countryDetection.currencyCode) || null
+    currency: (_q = countryDetection.currencyCode) != null ? _q : null
   };
-  const currencyCode = countryDetection == null ? void 0 : countryDetection.currencyCode;
+  const currencyCode = countryDetection.currencyCode;
   return { info, currencyCode };
 }
 

package/dist/collections.d.ts

@@ -1,5 +1,5 @@
 import { ShopInfo } from './store.js';
-import { C as Collection, f as CurrencyCode, P as Product, b as ShopifyCollection } from './types-BRXamZMS.js';
+import { C as Collection, f as CurrencyCode, P as Product, M as MinimalProduct, b as ShopifyCollection } from './types-w9n4csBQ.js';
 
 /**
  * Interface for collection operations
@@ -52,6 +52,19 @@ interface CollectionOperations {
          * Fetches all product slugs from a specific collection.
          */
         slugs(collectionHandle: string): Promise<string[] | null>;
+        /**
+         * Convenience minimal namespace to always return MinimalProduct types.
+         */
+        minimal: {
+            paginated(collectionHandle: string, options?: {
+                page?: number;
+                limit?: number;
+                currency?: CurrencyCode;
+            }): Promise<MinimalProduct[] | null>;
+            all(collectionHandle: string, options?: {
+                currency?: CurrencyCode;
+            }): Promise<MinimalProduct[] | null>;
+        };
     };
 }
 /**
@@ -60,6 +73,7 @@ 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<ShopInfo>, findCollection: (handle: string) => Promise<Collection | null>): CollectionOperations;
+    minimal?: boolean;
+}) => Promise<Product[] | MinimalProduct[] | null>, getStoreInfo: () => Promise<ShopInfo>, findCollection: (handle: string) => Promise<Collection | null>): CollectionOperations;
 
 export { type CollectionOperations, createCollectionOperations };

package/dist/collections.mjs

@@ -1,7 +1,7 @@
 import {
   createCollectionOperations
-} from "./chunk-QCB3U4AO.mjs";
-import "./chunk-D5MTUWFO.mjs";
+} from "./chunk-242GBM2V.mjs";
+import "./chunk-O77Z6OBJ.mjs";
 import "./chunk-U3RQRBXZ.mjs";
 export {
   createCollectionOperations

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { O as OpenRouterConfig, S as ShopifyProduct, P as Product, a as ShopifySingleProduct, b as ShopifyCollection, C as Collection, J as JsonLdEntry, c as StoreTypeBreakdown } from './types-BRXamZMS.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-BRXamZMS.js';
+import { O as OpenRouterConfig, S as ShopifyProduct, P as Product, M as MinimalProduct, a as ShopifySingleProduct, b as ShopifyCollection, C as Collection, J as JsonLdEntry, c as StoreTypeBreakdown } from './types-w9n4csBQ.js';
+export { d as CountryDetectionResult, e as CountryScores, f as CurrencyCode, L as LocalizedPricing, g as MetaTag, h as ProductImage, i as ProductOption, j as ProductVariant, k as ProductVariantImage } from './types-w9n4csBQ.js';
 import { CheckoutOperations } from './checkout.js';
 import { CollectionOperations } from './collections.js';
 import { ProductOperations } from './products.js';
@@ -81,8 +81,12 @@ declare class ShopClient {
     /**
      * Transform Shopify products to our Product format
      */
-    productsDto(products: ShopifyProduct[]): Product[] | null;
-    productDto(product: ShopifySingleProduct): Product;
+    productsDto(products: ShopifyProduct[], options?: {
+        minimal?: boolean;
+    }): Product[] | MinimalProduct[] | null;
+    productDto(product: ShopifySingleProduct, options?: {
+        minimal?: boolean;
+    }): Product | MinimalProduct;
     collectionsDto(collections: ShopifyCollection[]): Collection[];
     /**
      * Enhanced error handling with context