shop-client 3.14.1 → 3.15.0

package/dist/{chunk-ZF4M6GMB.mjs → chunk-ESTBP7AD.mjs}

@@ -7,7 +7,7 @@ import {
 
 // src/products.ts
 import { filter, isNonNullish } from "remeda";
-function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDto, productDto, getStoreInfo, findProduct) {
+function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDto, productDto, getStoreInfo, findProduct, ai) {
   const cacheExpiryMs = 5 * 60 * 1e3;
   const findCache = /* @__PURE__ */ new Map();
   const getCached = (key) => {
@@ -242,12 +242,6 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
       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;
@@ -255,7 +249,8 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
       const handle = baseProduct.handle;
       const { enrichProduct } = await import("./ai/enrich.mjs");
       const enriched = await enrichProduct(storeDomain, handle, {
-        apiKey,
+        apiKey: options == null ? void 0 : options.apiKey,
+        openRouter: ai == null ? void 0 : ai.openRouter,
         useGfm: options == null ? void 0 : options.useGfm,
         inputType: options == null ? void 0 : options.inputType,
         model: options == null ? void 0 : options.model,
@@ -266,18 +261,28 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
         enriched_content: enriched.mergedMarkdown
       };
     },
-    classify: async (productHandle, options) => {
+    enrichedPrompts: 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) {
+        throw new Error("Product not found");
+      }
+      const handle = baseProduct.handle;
+      const { buildEnrichPromptForProduct } = await import("./ai/enrich.mjs");
+      return buildEnrichPromptForProduct(storeDomain, handle, {
+        useGfm: options == null ? void 0 : options.useGfm,
+        inputType: options == null ? void 0 : options.inputType,
+        outputFormat: options == null ? void 0 : options.outputFormat
+      });
+    },
+    classify: async (productHandle, options) => {
+      if (!productHandle || typeof productHandle !== "string") {
+        throw new Error("Product handle is required and must be a string");
       }
       const enrichedProduct = await operations.enriched(productHandle, {
-        apiKey,
+        apiKey: options == null ? void 0 : options.apiKey,
         inputType: "html",
         model: options == null ? void 0 : options.model,
         outputFormat: "json"
@@ -304,20 +309,30 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
       }
       const { classifyProduct } = await import("./ai/enrich.mjs");
       const classification = await classifyProduct(productContent, {
-        apiKey,
+        apiKey: options == null ? void 0 : options.apiKey,
+        openRouter: ai == null ? void 0 : ai.openRouter,
         model: options == null ? void 0 : options.model
       });
       return classification;
     },
-    generateSEOContent: async (productHandle, options) => {
+    classifyPrompts: 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) {
+        throw new Error("Product not found");
+      }
+      const handle = baseProduct.handle;
+      const { buildClassifyPromptForProduct } = await import("./ai/enrich.mjs");
+      return buildClassifyPromptForProduct(storeDomain, handle, {
+        useGfm: options == null ? void 0 : options.useGfm,
+        inputType: options == null ? void 0 : options.inputType
+      });
+    },
+    generateSEOContent: async (productHandle, options) => {
+      if (!productHandle || typeof productHandle !== "string") {
+        throw new Error("Product handle is required and must be a string");
       }
       const baseProduct = await operations.find(productHandle);
       if (!baseProduct) return null;
@@ -330,7 +345,8 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
       };
       const { generateSEOContent: generateSEOContentLLM } = await import("./ai/enrich.mjs");
       const seo = await generateSEOContentLLM(payload, {
-        apiKey,
+        apiKey: options == null ? void 0 : options.apiKey,
+        openRouter: ai == null ? void 0 : ai.openRouter,
         model: options == null ? void 0 : options.model
       });
       return seo;
@@ -355,10 +371,19 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
      */
     showcased: async () => {
       const storeInfo = await getStoreInfo();
+      const normalizedHandles = storeInfo.showcase.products.map((h) => {
+        var _a;
+        return (_a = h.split("?")[0]) == null ? void 0 : _a.replace(/^\/|\/$/g, "");
+      }).filter((base) => Boolean(base));
+      const seen = /* @__PURE__ */ new Set();
+      const uniqueHandles = [];
+      for (const base of normalizedHandles) {
+        if (seen.has(base)) continue;
+        seen.add(base);
+        uniqueHandles.push(base);
+      }
       const products = await Promise.all(
-        storeInfo.showcase.products.map(
-          (productHandle) => findProduct(productHandle)
-        )
+        uniqueHandles.map((productHandle) => findProduct(productHandle))
       );
       return filter(products, isNonNullish);
     },

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

@@ -171,6 +171,19 @@ async function getInfoForShop(args, options) {
       (handle) => Boolean(handle)
     );
   }
+  const dedupeByNormalized = (arr) => {
+    var _a2;
+    const out = [];
+    const seen = /* @__PURE__ */ new Set();
+    for (const h of arr) {
+      const base = (_a2 = h == null ? void 0 : h.split("?")[0]) == null ? void 0 : _a2.replace(/^\/|\/$/g, "");
+      if (!base) continue;
+      if (seen.has(base)) continue;
+      seen.add(base);
+      out.push(base);
+    }
+    return out;
+  };
   const info = {
     name: name || slug,
     domain: sanitizeDomain(baseUrl),
@@ -182,8 +195,8 @@ async function getInfoForShop(args, options) {
     contactLinks,
     headerLinks,
     showcase: {
-      products: unique(homePageProductLinks != null ? homePageProductLinks : []),
-      collections: unique(homePageCollectionLinks != null ? homePageCollectionLinks : [])
+      products: dedupeByNormalized(homePageProductLinks != null ? homePageProductLinks : []),
+      collections: dedupeByNormalized(homePageCollectionLinks != null ? homePageCollectionLinks : [])
     },
     jsonLdData: ((_p = (_o = html.match(
       /<script[^>]*type="application\/ld\+json"[^>]*>([^<]+)<\/script>/g

package/dist/{chunk-554O5ED6.mjs → chunk-QCB3U4AO.mjs}

@@ -230,8 +230,19 @@ function createCollectionOperations(baseUrl, storeDomain, fetchCollections, coll
      */
     showcased: async () => {
       const storeInfo = await getStoreInfo();
+      const normalizedHandles = storeInfo.showcase.collections.map((h) => {
+        var _a;
+        return (_a = h.split("?")[0]) == null ? void 0 : _a.replace(/^\/|\/$/g, "");
+      }).filter((base) => Boolean(base));
+      const seen = /* @__PURE__ */ new Set();
+      const uniqueHandles = [];
+      for (const base of normalizedHandles) {
+        if (seen.has(base)) continue;
+        seen.add(base);
+        uniqueHandles.push(base);
+      }
       const collections = await Promise.all(
-        storeInfo.showcase.collections.map(
+        uniqueHandles.map(
           (collectionHandle) => findCollection(collectionHandle)
         )
       );

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-luPg5O08.js';
+import { C as Collection, f as CurrencyCode, P as Product, b as ShopifyCollection } from './types-BRXamZMS.js';
 
 /**
  * Interface for collection operations

package/dist/collections.mjs

@@ -1,6 +1,6 @@
 import {
   createCollectionOperations
-} from "./chunk-554O5ED6.mjs";
+} from "./chunk-QCB3U4AO.mjs";
 import "./chunk-D5MTUWFO.mjs";
 import "./chunk-U3RQRBXZ.mjs";
 export {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as ShopifyProduct, P as Product, a as ShopifySingleProduct, b as ShopifyCollection, C as Collection, J as JsonLdEntry, c as StoreTypeBreakdown } from './types-luPg5O08.js';
-export { d as CountryDetectionResult, e as CountryScores, f as CurrencyCode, L as LocalizedPricing, M as MetaTag, g as ProductImage, h as ProductOption, i as ProductVariant, j as ProductVariantImage } from './types-luPg5O08.js';
+import { 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 { CheckoutOperations } from './checkout.js';
 import { CollectionOperations } from './collections.js';
 import { ProductOperations } from './products.js';
@@ -27,11 +27,13 @@ export { configureRateLimit } from './utils/rate-limit.js';
  */
 type ShopClientOptions = {
     cacheTTL?: number;
+    openRouter?: OpenRouterConfig;
 };
 declare class ShopClient {
     private storeDomain;
     private baseUrl;
     private storeSlug;
+    private openRouter?;
     private validationCache;
     private cacheExpiry;
     private cacheTimestamps;
@@ -186,4 +188,4 @@ declare class ShopClient {
     }): Promise<StoreTypeBreakdown>;
 }
 
-export { CheckoutOperations, Collection, CollectionOperations, OpenGraphMeta, Product, ProductOperations, ShopClient, type ShopClientOptions, ShopInfo, ShopOperations, StoreTypeBreakdown };
+export { CheckoutOperations, Collection, CollectionOperations, OpenGraphMeta, OpenRouterConfig, Product, ProductOperations, ShopClient, type ShopClientOptions, ShopInfo, ShopOperations, StoreTypeBreakdown };

package/dist/index.mjs

@@ -3,19 +3,19 @@ import {
 } from "./chunk-W4SF6W2P.mjs";
 import {
   createCollectionOperations
-} from "./chunk-554O5ED6.mjs";
+} from "./chunk-QCB3U4AO.mjs";
 import {
   createProductOperations
-} from "./chunk-ZF4M6GMB.mjs";
+} from "./chunk-ESTBP7AD.mjs";
 import {
   createShopOperations,
   getInfoForShop
-} from "./chunk-7IMI76JZ.mjs";
+} from "./chunk-OA76XD32.mjs";
 import {
   classifyProduct,
   determineStoreType,
   generateSEOContent
-} from "./chunk-GNIBTUEK.mjs";
+} from "./chunk-2W623LCW.mjs";
 import {
   configureRateLimit,
   rateLimitedFetch
@@ -55,7 +55,7 @@ async function determineStoreTypeForStore(args) {
         collections: collectionsSample
       }
     },
-    { apiKey: args.apiKey, model: args.model }
+    { apiKey: args.apiKey, model: args.model, openRouter: args.openRouter }
   );
   return breakdown;
 }
@@ -353,6 +353,7 @@ var ShopClient = class {
     if (typeof (options == null ? void 0 : options.cacheTTL) === "number" && options.cacheTTL > 0) {
       this.cacheExpiry = options.cacheTTL;
     }
+    this.openRouter = options == null ? void 0 : options.openRouter;
     this.shopOperations = createShopOperations({
       baseUrl: this.baseUrl,
       storeDomain: this.storeDomain,
@@ -368,7 +369,8 @@ var ShopClient = class {
       this.productsDto.bind(this),
       this.productDto.bind(this),
       () => this.getInfo(),
-      (handle) => this.products.find(handle)
+      (handle) => this.products.find(handle),
+      { openRouter: this.openRouter }
     );
     this.collections = createCollectionOperations(
       this.baseUrl,
@@ -786,12 +788,14 @@ var ShopClient = class {
    */
   async determineStoreType(options) {
     try {
+      const openRouter = this.openRouter;
       const breakdown = await determineStoreTypeForStore({
         baseUrl: this.baseUrl,
         getInfo: () => this.getInfo(),
         findProduct: (handle) => this.products.find(handle),
         apiKey: options == null ? void 0 : options.apiKey,
         model: options == null ? void 0 : options.model,
+        openRouter,
         maxShowcaseProducts: options == null ? void 0 : options.maxShowcaseProducts,
         maxShowcaseCollections: options == null ? void 0 : options.maxShowcaseCollections
       });

package/dist/products.d.ts

@@ -1,5 +1,5 @@
 import { ShopInfo } from './store.js';
-import { f as CurrencyCode, P as Product, k as ProductClassification, l as SEOContent, S as ShopifyProduct, a as ShopifySingleProduct } from './types-luPg5O08.js';
+import { f as CurrencyCode, P as Product, k as ProductClassification, l as SEOContent, S as ShopifyProduct, a as ShopifySingleProduct, O as OpenRouterConfig } from './types-BRXamZMS.js';
 
 /**
  * Interface for product operations
@@ -27,7 +27,7 @@ interface ProductOperations {
     }): Promise<Product | null>;
     /**
      * Finds a product by handle and enriches its content using LLM.
-     * Requires an OpenAI API key via options.apiKey or process.env.OPENAI_API_KEY.
+     * Requires an OpenRouter API key via options.apiKey or ShopClient options.
      */
     enriched(productHandle: string, options?: {
         apiKey?: string;
@@ -36,10 +36,25 @@ interface ProductOperations {
         model?: string;
         outputFormat?: "markdown" | "json";
     }): Promise<Product | null>;
+    enrichedPrompts(productHandle: string, options?: {
+        useGfm?: boolean;
+        inputType?: "markdown" | "html";
+        outputFormat?: "markdown" | "json";
+    }): Promise<{
+        system: string;
+        user: string;
+    }>;
     classify(productHandle: string, options?: {
         apiKey?: string;
         model?: string;
     }): Promise<ProductClassification | null>;
+    classifyPrompts(productHandle: string, options?: {
+        useGfm?: boolean;
+        inputType?: "markdown" | "html";
+    }): Promise<{
+        system: string;
+        user: string;
+    }>;
     /**
      * Generate SEO and marketing content for a product.
      */
@@ -77,6 +92,8 @@ interface ProductOperations {
 /**
  * Creates product operations for a store instance
  */
-declare function createProductOperations(baseUrl: string, storeDomain: string, fetchProducts: (page: number, limit: number) => Promise<Product[] | null>, productsDto: (products: ShopifyProduct[]) => Product[] | null, productDto: (product: ShopifySingleProduct) => Product, getStoreInfo: () => Promise<ShopInfo>, findProduct: (handle: string) => Promise<Product | null>): ProductOperations;
+declare function createProductOperations(baseUrl: string, storeDomain: string, fetchProducts: (page: number, limit: number) => Promise<Product[] | null>, productsDto: (products: ShopifyProduct[]) => Product[] | null, productDto: (product: ShopifySingleProduct) => Product, getStoreInfo: () => Promise<ShopInfo>, findProduct: (handle: string) => Promise<Product | null>, ai?: {
+    openRouter?: OpenRouterConfig;
+}): ProductOperations;
 
 export { type ProductOperations, createProductOperations };

package/dist/products.mjs

@@ -1,6 +1,6 @@
 import {
   createProductOperations
-} from "./chunk-ZF4M6GMB.mjs";
+} from "./chunk-ESTBP7AD.mjs";
 import "./chunk-D5MTUWFO.mjs";
 import "./chunk-U3RQRBXZ.mjs";
 export {

package/dist/store.d.ts

@@ -1,4 +1,4 @@
-import { J as JsonLdEntry, d as CountryDetectionResult, f as CurrencyCode } from './types-luPg5O08.js';
+import { J as JsonLdEntry, d as CountryDetectionResult, f as CurrencyCode } from './types-BRXamZMS.js';
 
 /**
  * Store operations interface for managing store-related functionality.

package/dist/store.mjs

@@ -1,6 +1,6 @@
 import {
   createShopOperations
-} from "./chunk-7IMI76JZ.mjs";
+} from "./chunk-OA76XD32.mjs";
 import "./chunk-D5MTUWFO.mjs";
 import "./chunk-G7OCMGA6.mjs";
 import "./chunk-U3RQRBXZ.mjs";

package/dist/{types-luPg5O08.d.ts → types-BRXamZMS.d.ts}

@@ -1,3 +1,16 @@
+type OpenRouterConfig = {
+    apiKey?: string;
+    model?: string;
+    fallbackModels?: string[];
+    baseUrl?: string;
+    siteUrl?: string;
+    appTitle?: string;
+    offline?: boolean;
+};
+type SystemUserPrompt = {
+    system: string;
+    user: string;
+};
 /**
  * Base timestamp fields used across Shopify entities.
  */
@@ -398,4 +411,4 @@ type SEOContent = {
 };
 type StoreTypeBreakdown = Partial<Record<"adult_male" | "adult_female" | "kid_male" | "kid_female" | "generic", Partial<Record<"clothing" | "beauty" | "accessories" | "home-decor" | "food-and-beverages", string[]>>>>;
 
-export type { Collection as C, JsonLdEntry as J, LocalizedPricing as L, MetaTag as M, Product as P, ShopifyProduct as S, ShopifySingleProduct as a, ShopifyCollection as b, StoreTypeBreakdown as c, CountryDetectionResult as d, CountryScores as e, CurrencyCode as f, ProductImage as g, ProductOption as h, ProductVariant as i, ProductVariantImage as j, ProductClassification as k, SEOContent as l };
+export type { Collection as C, JsonLdEntry as J, LocalizedPricing as L, MetaTag as M, OpenRouterConfig as O, Product as P, ShopifyProduct as S, ShopifySingleProduct as a, ShopifyCollection as b, StoreTypeBreakdown as c, CountryDetectionResult as d, CountryScores as e, CurrencyCode as f, ProductImage as g, ProductOption as h, ProductVariant as i, ProductVariantImage as j, ProductClassification as k, SEOContent as l, SystemUserPrompt as m };

package/dist/utils/detect-country.d.ts

@@ -1,4 +1,4 @@
-import { d as CountryDetectionResult } from '../types-luPg5O08.js';
+import { d as CountryDetectionResult } from '../types-BRXamZMS.js';
 
 /**
  * Detects the country of a Shopify store by analyzing various signals in the HTML content.

package/dist/utils/func.d.ts

@@ -1,4 +1,4 @@
-import { f as CurrencyCode } from '../types-luPg5O08.js';
+import { f as CurrencyCode } from '../types-BRXamZMS.js';
 
 declare function extractDomainWithoutSuffix(domain: string): string | null;
 declare function generateStoreSlug(domain: string): string;

package/package.json

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