shop-client 3.17.0 → 3.18.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-w9n4csBQ.js';
+import { O as OpenRouterConfig, l as ProductClassification, m as SEOContent, n as SystemUserPrompt, a as ShopifySingleProduct } from '../types-B4WDm14E.js';
 
 declare function buildEnrichPrompt(args: {
     bodyInput: string;

package/dist/{chunk-3KRUT5BD.mjs → chunk-6XDBGOFZ.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 == null ? void 0 : 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/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-B4WDm14E.js';
 
 /**
  * Interface for collection operations

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-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 { CheckoutOperations } from './checkout.js';
 import { CollectionOperations } from './collections.js';
 import { ProductOperations } from './products.js';

package/dist/index.mjs

@@ -6,7 +6,7 @@ import {
 } from "./chunk-242GBM2V.mjs";
 import {
   createProductOperations
-} from "./chunk-3KRUT5BD.mjs";
+} from "./chunk-6XDBGOFZ.mjs";
 import {
   createShopOperations,
   getInfoForShop

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-B4WDm14E.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.
+     * @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,6 +1,6 @@
 import {
   createProductOperations
-} from "./chunk-3KRUT5BD.mjs";
+} from "./chunk-6XDBGOFZ.mjs";
 import "./chunk-O77Z6OBJ.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-w9n4csBQ.js';
+import { J as JsonLdEntry, d as CountryDetectionResult, f as CurrencyCode } from './types-B4WDm14E.js';
 
 /**
  * Store operations interface for managing store-related functionality.

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

@@ -435,6 +435,37 @@ type SEOContent = {
     tags: string[];
     marketingCopy: string;
 };
+type EnhancedProductImage = {
+    textContext: string;
+    url: string;
+    alt: string;
+};
+type EnhancedProductCanonical = {
+    title: string;
+    summary: string;
+    highlights: string[];
+    materials: unknown;
+    fit_and_size: unknown;
+    care: unknown;
+    what_makes_it_special: unknown;
+    missing_info: unknown[];
+    images: EnhancedProductImage[];
+};
+type EnhancedProductEnrichment = {
+    canonical: EnhancedProductCanonical;
+    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-B4WDm14E.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-B4WDm14E.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.17.0",
+  "version": "3.18.0",
   "type": "module",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",