shop-client 3.17.0 → 3.18.1

package/dist/ai/enrich.d.ts

@@ -1,4 +1,4 @@
-import { O as OpenRouterConfig, l as ProductClassification, m as SEOContent, n as SystemUserPrompt, a as ShopifySingleProduct } from '../types-w9n4csBQ.js';
+import { O as OpenRouterConfig, l as ProductClassification, m as SEOContent, n as SystemUserPrompt, a as ShopifySingleProduct } from '../types-BmJArla2.js';
 
 declare function buildEnrichPrompt(args: {
     bodyInput: string;

package/dist/ai/enrich.mjs

@@ -13,8 +13,8 @@ import {
   htmlToMarkdown,
   mergeWithLLM,
   pruneBreakdownForSignals
-} from "../chunk-5TGMDRUF.mjs";
-import "../chunk-O77Z6OBJ.mjs";
+} from "../chunk-OSMMFHDC.mjs";
+import "../chunk-4GPP2KXF.mjs";
 export {
   buildClassifyPrompt,
   buildClassifyPromptForProduct,

package/dist/{chunk-O77Z6OBJ.mjs → chunk-4GPP2KXF.mjs}

@@ -177,6 +177,9 @@ async function rateLimitedFetch(input, init) {
     timeoutMs: _timeoutMs,
     ...fetchInit
   } = effInit;
+  if (fetchInit.redirect === void 0) {
+    fetchInit.redirect = "follow";
+  }
   const klass = init == null ? void 0 : init.rateLimitClass;
   const byClass = klass ? classLimiters.get(klass) : void 0;
   const byHost = getHostLimiter(getHost(input));

package/dist/{chunk-3KRUT5BD.mjs → chunk-64S4UWAH.mjs}

@@ -1,6 +1,6 @@
 import {
   rateLimitedFetch
-} from "./chunk-O77Z6OBJ.mjs";
+} from "./chunk-4GPP2KXF.mjs";
 import {
   formatPrice
 } from "./chunk-U3RQRBXZ.mjs";
@@ -298,6 +298,75 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
     );
     return finalProducts != null ? finalProducts : [];
   }
+  async function findEnhancedInternal(productHandle, options) {
+    var _a;
+    const apiKey = options.apiKey;
+    if (!apiKey || typeof apiKey !== "string" || !apiKey.trim()) {
+      throw new Error("apiKey is required");
+    }
+    const baseProduct = await findInternal(productHandle, { minimal: false });
+    if (!baseProduct) return null;
+    let updatedAt = (_a = baseProduct.updatedAt) == null ? void 0 : _a.toISOString();
+    if (updatedAt == null ? void 0 : updatedAt.endsWith(".000Z")) {
+      updatedAt = updatedAt.replace(".000Z", "Z");
+    }
+    if (!updatedAt) {
+      const url = `${baseUrl}products/${encodeURIComponent(baseProduct.handle)}.js`;
+      const resp2 = await rateLimitedFetch(url, {
+        rateLimitClass: "products:single",
+        timeoutMs: 7e3,
+        retry: { maxRetries: 1, baseDelayMs: 200 }
+      });
+      if (!resp2.ok) {
+        if (resp2.status === 404) return null;
+        throw new Error(`HTTP ${resp2.status}: ${resp2.statusText}`);
+      }
+      const raw = await resp2.json();
+      if (typeof raw.updated_at === "string" && raw.updated_at.trim()) {
+        updatedAt = raw.updated_at;
+      } else {
+        throw new Error("updatedAt missing for product");
+      }
+    }
+    const endpoint = typeof (options == null ? void 0 : options.endpoint) === "string" && options.endpoint.trim() || "https://shopify-product-enrichment-worker.ninjacode.workers.dev";
+    let hostname = storeDomain;
+    try {
+      hostname = new URL(storeDomain).hostname;
+    } catch {
+      hostname = storeDomain.replace(/^https?:\/\//, "").replace(/\/.*$/, "");
+    }
+    const resp = await rateLimitedFetch(endpoint, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        "x-api-key": apiKey
+      },
+      body: JSON.stringify({
+        storeDomain: hostname,
+        handle: baseProduct.handle,
+        updatedAt
+      }),
+      rateLimitClass: "products:enhanced",
+      timeoutMs: 15e3,
+      retry: {
+        maxRetries: 2,
+        baseDelayMs: 300,
+        retryOnStatuses: [429, 500, 502, 503, 504]
+      }
+    });
+    if (!resp.ok) {
+      throw new Error(`HTTP ${resp.status}: ${resp.statusText}`);
+    }
+    const data = await resp.json();
+    if (!data || typeof data !== "object" || Array.isArray(data)) {
+      throw new Error("Invalid enhanced product response");
+    }
+    const o = data;
+    if (!("shopify" in o) || !("enrichment" in o) || !("cache" in o)) {
+      throw new Error("Invalid enhanced product response");
+    }
+    return data;
+  }
   const operations = {
     /**
      * Fetches all products from the store across all pages.
@@ -375,6 +444,7 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
       minimal: false,
       currency: options == null ? void 0 : options.currency
     }),
+    findEnhanced: async (productHandle, options) => findEnhancedInternal(productHandle, options),
     /**
      * Enrich a product by generating merged markdown from body_html and product page.
      * Adds `enriched_content` to the returned product.

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

@@ -1,6 +1,6 @@
 import {
   rateLimitedFetch
-} from "./chunk-O77Z6OBJ.mjs";
+} from "./chunk-4GPP2KXF.mjs";
 import {
   detectShopCountry
 } from "./chunk-SBHTEKLB.mjs";

package/dist/{chunk-242GBM2V.mjs → chunk-GYQQU54C.mjs}

@@ -1,6 +1,6 @@
 import {
   rateLimitedFetch
-} from "./chunk-O77Z6OBJ.mjs";
+} from "./chunk-4GPP2KXF.mjs";
 import {
   formatPrice
 } from "./chunk-U3RQRBXZ.mjs";

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

@@ -1,6 +1,6 @@
 import {
   rateLimitedFetch
-} from "./chunk-O77Z6OBJ.mjs";
+} from "./chunk-4GPP2KXF.mjs";
 
 // src/ai/enrich.ts
 import TurndownService from "turndown";

package/dist/collections.d.ts

@@ -1,5 +1,5 @@
 import { ShopInfo } from './store.js';
-import { C as Collection, f as CurrencyCode, P as Product, M as MinimalProduct, b as ShopifyCollection } from './types-w9n4csBQ.js';
+import { C as Collection, f as CurrencyCode, P as Product, M as MinimalProduct, b as ShopifyCollection } from './types-BmJArla2.js';
 
 /**
  * Interface for collection operations

package/dist/collections.mjs

@@ -1,7 +1,7 @@
 import {
   createCollectionOperations
-} from "./chunk-242GBM2V.mjs";
-import "./chunk-O77Z6OBJ.mjs";
+} from "./chunk-GYQQU54C.mjs";
+import "./chunk-4GPP2KXF.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, 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 { 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-BmJArla2.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-BmJArla2.js';
 import { CheckoutOperations } from './checkout.js';
 import { CollectionOperations } from './collections.js';
 import { ProductOperations } from './products.js';

package/dist/index.mjs

@@ -3,23 +3,23 @@ import {
 } from "./chunk-W4SF6W2P.mjs";
 import {
   createCollectionOperations
-} from "./chunk-242GBM2V.mjs";
+} from "./chunk-GYQQU54C.mjs";
 import {
   createProductOperations
-} from "./chunk-3KRUT5BD.mjs";
+} from "./chunk-64S4UWAH.mjs";
 import {
   createShopOperations,
   getInfoForShop
-} from "./chunk-YWAW6C74.mjs";
+} from "./chunk-BNTNHHDI.mjs";
 import {
   classifyProduct,
   determineStoreType,
   generateSEOContent
-} from "./chunk-5TGMDRUF.mjs";
+} from "./chunk-OSMMFHDC.mjs";
 import {
   configureRateLimit,
   rateLimitedFetch
-} from "./chunk-O77Z6OBJ.mjs";
+} from "./chunk-4GPP2KXF.mjs";
 import {
   detectShopCountry
 } from "./chunk-SBHTEKLB.mjs";

package/dist/products.d.ts

@@ -1,5 +1,5 @@
 import { ShopInfo } from './store.js';
-import { f as CurrencyCode, P as Product, l as ProductClassification, m as SEOContent, M as MinimalProduct, S as ShopifyProduct, a as ShopifySingleProduct, O as OpenRouterConfig } from './types-w9n4csBQ.js';
+import { f as CurrencyCode, P as Product, E as EnhancedProductResponse, l as ProductClassification, m as SEOContent, M as MinimalProduct, S as ShopifyProduct, a as ShopifySingleProduct, O as OpenRouterConfig } from './types-BmJArla2.js';
 
 /**
  * Interface for product operations
@@ -28,6 +28,18 @@ interface ProductOperations {
     find(productHandle: string, options?: {
         currency?: CurrencyCode;
     }): Promise<Product | null>;
+    /**
+     * Finds a product and enhances it with AI-generated content using an external service.
+     *
+     * @param productHandle - The handle of the product to find.
+     * @param options - Options for the request.
+     * @param options.apiKey - API key for the enhancement service. Required for authentication via x-api-key header.
+     * @param options.endpoint - Optional custom endpoint URL for the enhancement service. Defaults to the standard worker URL.
+     */
+    findEnhanced(productHandle: string, options: {
+        apiKey: string;
+        endpoint?: string;
+    }): Promise<EnhancedProductResponse | null>;
     /**
      * Finds a product by handle and enriches its content using LLM.
      * Requires an OpenRouter API key via options.apiKey or ShopClient options.

package/dist/products.mjs

@@ -1,7 +1,7 @@
 import {
   createProductOperations
-} from "./chunk-3KRUT5BD.mjs";
-import "./chunk-O77Z6OBJ.mjs";
+} from "./chunk-64S4UWAH.mjs";
+import "./chunk-4GPP2KXF.mjs";
 import "./chunk-U3RQRBXZ.mjs";
 export {
   createProductOperations

package/dist/store.d.ts

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

package/dist/store.mjs

@@ -1,7 +1,7 @@
 import {
   createShopOperations
-} from "./chunk-YWAW6C74.mjs";
-import "./chunk-O77Z6OBJ.mjs";
+} from "./chunk-BNTNHHDI.mjs";
+import "./chunk-4GPP2KXF.mjs";
 import "./chunk-SBHTEKLB.mjs";
 import "./chunk-U3RQRBXZ.mjs";
 export {

package/dist/{types-w9n4csBQ.d.ts → types-BmJArla2.d.ts}

@@ -435,6 +435,60 @@ type SEOContent = {
     tags: string[];
     marketingCopy: string;
 };
+/**
+ * Contextual image information extracted from product content.
+ */
+type EnhancedProductImage = {
+    /** The text surrounding the image reference. */
+    textContext: string;
+    /** The image URL. */
+    url: string;
+    /** The image alt text. */
+    alt: string;
+};
+/**
+ * Structured canonical product data extracted by AI.
+ */
+type EnhancedProductCanonical = {
+    /** The product title. */
+    title: string;
+    /** A brief summary of the product. */
+    summary: string;
+    /** Key highlights or features of the product. */
+    highlights: string[];
+    /** Material information (array of strings or object). */
+    materials: unknown;
+    /** Fit and sizing information. */
+    fit_and_size: unknown;
+    /** Care instructions. */
+    care: unknown;
+    /** Unique selling points. */
+    what_makes_it_special: unknown;
+    /** Information that was looked for but not found. */
+    missing_info: unknown[];
+    /** List of contextual images found in the description. */
+    images: EnhancedProductImage[];
+};
+/**
+ * The full enrichment result containing both structured and markdown formats.
+ */
+type EnhancedProductEnrichment = {
+    /** The structured canonical data. */
+    canonical: EnhancedProductCanonical;
+    /** The generated markdown content. */
+    markdown: string;
+};
+/**
+ * The response object from the enhanced product search.
+ */
+type EnhancedProductResponse = {
+    /** The original Shopify product data. */
+    shopify: ShopifyProduct;
+    /** The AI-enriched content. */
+    enrichment: EnhancedProductEnrichment;
+    /** Cache status of the response (e.g., 'hit', 'miss'). */
+    cache: string;
+};
 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, MinimalProduct 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, MetaTag as g, ProductImage as h, ProductOption as i, ProductVariant as j, ProductVariantImage as k, ProductClassification as l, SEOContent as m, SystemUserPrompt as n };
+export type { Collection as C, EnhancedProductResponse as E, JsonLdEntry as J, LocalizedPricing as L, MinimalProduct 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, MetaTag as g, ProductImage as h, ProductOption as i, ProductVariant as j, ProductVariantImage as k, ProductClassification as l, SEOContent as m, SystemUserPrompt as n };

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

@@ -1,4 +1,4 @@
-import { d as CountryDetectionResult } from '../types-w9n4csBQ.js';
+import { d as CountryDetectionResult } from '../types-BmJArla2.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-w9n4csBQ.js';
+import { f as CurrencyCode } from '../types-BmJArla2.js';
 
 declare function extractDomainWithoutSuffix(domain: string): string | null;
 declare function generateStoreSlug(domain: string): string;

package/dist/utils/rate-limit.mjs

@@ -2,7 +2,7 @@ import {
   configureRateLimit,
   getRateLimitStatus,
   rateLimitedFetch
-} from "../chunk-O77Z6OBJ.mjs";
+} from "../chunk-4GPP2KXF.mjs";
 export {
   configureRateLimit,
   getRateLimitStatus,

package/package.json

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