shop-client 3.18.0 → 3.19.0

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-B4WDm14E.js';
+import { O as OpenRouterConfig, l as ProductClassification, m as SEOContent, n as SystemUserPrompt, a as ShopifySingleProduct } from '../types-BzKSPzbj.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-6XDBGOFZ.mjs → chunk-5DGSCBYT.mjs}

@@ -1,6 +1,6 @@
 import {
   rateLimitedFetch
-} from "./chunk-O77Z6OBJ.mjs";
+} from "./chunk-4GPP2KXF.mjs";
 import {
   formatPrice
 } from "./chunk-U3RQRBXZ.mjs";
@@ -300,7 +300,7 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
   }
   async function findEnhancedInternal(productHandle, options) {
     var _a;
-    const apiKey = options == null ? void 0 : options.apiKey;
+    const apiKey = options.apiKey;
     if (!apiKey || typeof apiKey !== "string" || !apiKey.trim()) {
       throw new Error("apiKey is required");
     }
@@ -328,7 +328,7 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
         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";
+    const endpoint = typeof options.endpoint === "string" && options.endpoint.trim() || "https://shopify-product-enrichment-worker.ninjacode.workers.dev";
     let hostname = storeDomain;
     try {
       hostname = new URL(storeDomain).hostname;
@@ -365,7 +365,126 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
     if (!("shopify" in o) || !("enrichment" in o) || !("cache" in o)) {
       throw new Error("Invalid enhanced product response");
     }
-    return data;
+    const parsed = data;
+    let mappedProduct = baseProduct;
+    try {
+      const raw = parsed.shopify;
+      if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+        if ("body_html" in raw) {
+          const mapped = productsDto([raw], {
+            minimal: false
+          });
+          const first = Array.isArray(mapped) ? mapped[0] : null;
+          if (first) mappedProduct = first;
+        } else if ("description" in raw) {
+          mappedProduct = productDto(raw, {
+            minimal: false
+          });
+        }
+      }
+    } catch {
+    }
+    return {
+      enrichment: parsed.enrichment,
+      cache: parsed.cache,
+      product: mappedProduct
+    };
+  }
+  async function findEnhancedMinimalInternal(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.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");
+    }
+    const parsed = data;
+    let mappedMinimal = null;
+    try {
+      const raw = parsed.shopify;
+      if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+        if ("body_html" in raw) {
+          const mapped = productsDto([raw], {
+            minimal: true
+          });
+          const first = Array.isArray(mapped) ? mapped[0] : null;
+          mappedMinimal = first || null;
+        } else if ("description" in raw) {
+          mappedMinimal = productDto(raw, {
+            minimal: true
+          });
+        }
+      }
+    } catch {
+    }
+    if (!mappedMinimal) {
+      mappedMinimal = await findInternal(baseProduct.handle, { minimal: true });
+    }
+    if (!mappedMinimal) return null;
+    return {
+      enrichment: parsed.enrichment,
+      cache: parsed.cache,
+      product: mappedMinimal
+    };
   }
   const operations = {
     /**
@@ -750,6 +869,9 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
           currency: options == null ? void 0 : options.currency
         });
       },
+      findEnhanced: async (productHandle, options) => {
+        return findEnhancedMinimalInternal(productHandle, options);
+      },
       showcased: async () => {
         const res = await operations.showcase.minimal();
         return res || [];

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-B4WDm14E.js';
+import { C as Collection, f as CurrencyCode, P as Product, M as MinimalProduct, b as ShopifyCollection } from './types-BzKSPzbj.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-B4WDm14E.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-B4WDm14E.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-BzKSPzbj.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-BzKSPzbj.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-6XDBGOFZ.mjs";
+} from "./chunk-5DGSCBYT.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, E as EnhancedProductResponse, l as ProductClassification, m as SEOContent, M as MinimalProduct, S as ShopifyProduct, a as ShopifySingleProduct, O as OpenRouterConfig } from './types-B4WDm14E.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-BzKSPzbj.js';
 
 /**
  * Interface for product operations
@@ -33,11 +33,11 @@ interface ProductOperations {
      *
      * @param productHandle - The handle of the product to find.
      * @param options - Options for the request.
-     * @param options.apiKey - API key for the enhancement service.
+     * @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;
+    findEnhanced(productHandle: string, options: {
+        apiKey: string;
         endpoint?: string;
     }): Promise<EnhancedProductResponse | null>;
     /**
@@ -139,6 +139,10 @@ interface ProductOperations {
         find(productHandle: string, options?: {
             currency?: CurrencyCode;
         }): Promise<MinimalProduct | null>;
+        findEnhanced(productHandle: string, options: {
+            apiKey: string;
+            endpoint?: string;
+        }): Promise<EnhancedProductResponse<MinimalProduct> | null>;
         showcased(): Promise<MinimalProduct[]>;
         predictiveSearch(query: string, options?: {
             limit?: number;

package/dist/products.mjs

@@ -1,7 +1,7 @@
 import {
   createProductOperations
-} from "./chunk-6XDBGOFZ.mjs";
-import "./chunk-O77Z6OBJ.mjs";
+} from "./chunk-5DGSCBYT.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-B4WDm14E.js';
+import { J as JsonLdEntry, d as CountryDetectionResult, f as CurrencyCode } from './types-BzKSPzbj.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-B4WDm14E.d.ts → types-BzKSPzbj.d.ts}

@@ -435,32 +435,55 @@ 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;
+type EnhancedProductResponse<TProduct = Product> = {
+    /** The product data after DTO transformations. */
+    product: TProduct;
     /** The AI-enriched content. */
     enrichment: EnhancedProductEnrichment;
     /** Cache status of the response (e.g., 'hit', 'miss'). */

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

@@ -1,4 +1,4 @@
-import { d as CountryDetectionResult } from '../types-B4WDm14E.js';
+import { d as CountryDetectionResult } from '../types-BzKSPzbj.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-B4WDm14E.js';
+import { f as CurrencyCode } from '../types-BzKSPzbj.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.18.0",
+  "version": "3.19.0",
   "type": "module",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",