shop-client 3.23.0 → 3.24.0

package/README.md

@@ -359,7 +359,7 @@ Fetches all products from the store with automatic pagination handling.
 const allProducts = await shop.products.all();
 ```
 
-**Returns:** `ProductResult[] | null`
+**Returns:** `ProductResult[] | null` (typed based on `columns`, defaults to minimal)
 
 #### `products.paginated(options)`
 
@@ -379,7 +379,7 @@ const products = await shop.products.paginated({
 - `limit` (number, optional): Products per page (default: 250, max: 250)
  - `currency` (CurrencyCode, optional): ISO 4217 code aligned with `Intl.NumberFormatOptions['currency']` (e.g., `"USD"`, `"EUR"`, `"JPY"`)
 
-**Returns:** `ProductResult[] | null`
+**Returns:** `ProductResult[] | null` (typed based on `columns`, defaults to minimal)
 
 #### `products.find(handle)`
 
@@ -397,7 +397,26 @@ const productEur = await shop.products.find("product-handle", { currency: "EUR"
  - `options` (object, optional): Additional options
    - `currency` (CurrencyCode, optional): ISO 4217 code aligned with `Intl.NumberFormatOptions['currency']`
 
-**Returns:** `ProductResult | null`
+**Returns:** `ProductResult | null` (typed based on `columns`, defaults to minimal)
+
+#### `products.findEnhanced(handle, options)`
+
+Finds a product by handle and returns the product plus AI enrichment from the worker endpoint. The `product` field is typed the same way as `products.find()` based on `columns`.
+
+```typescript
+const enhanced = await shop.products.findEnhanced("product-handle", {
+  apiKey: process.env.ENRICH_API_KEY!,
+  columns: { mode: "full", images: "full", options: "full" },
+});
+
+if (enhanced) {
+  console.log(enhanced.cache); // e.g. "hit" | "miss"
+  console.log(enhanced.enrichment.markdown);
+  console.log(enhanced.product.handle); // available when mode: "full"
+}
+```
+
+**Returns:** `EnhancedProductResponse<ProductResult> | null` (typed based on `columns`)
 
 #### `products.showcased()`
 
@@ -475,7 +494,7 @@ const results = await shop.products.predictiveSearch("dress", {
 - Extracts handles from Ajax results, fetches full products via `find`
 - Falls back to non-locale path when locale returns 404/417
 
-**Returns:** `ProductResult[]`
+**Returns:** `ProductResult[]` (typed based on `columns`, defaults to minimal)
 
 ### Recommendations
 
@@ -497,7 +516,7 @@ const recos = await shop.products.recommendations(1234567890, {
 
 ### Product Columns
 
-Default product payload is minimal. Use `columns` to override the product payload shape (full vs minimal):
+Default product payload is minimal. Use `columns` to override the product payload shape, and TypeScript will reflect the shape in the returned type:
 
 ```typescript
 // Minimal products (default)
@@ -514,6 +533,11 @@ const minimalOne = await shop.products.find("product-handle", {
 });
 ```
 
+Quick mental model:
+- `mode: "minimal"` returns a minimal product shape (no `handle`, no `priceMin/priceMax`, no `currency` field)
+- `mode: "full"` returns a full product shape (includes `handle`, pricing range fields, `currency`, variants, etc.)
+- `images: "full"` and `options: "full"` expand those subfields while keeping the chosen `mode`
+
 ### Collections
 
 #### `collections.all()`
@@ -579,7 +603,7 @@ const products = await shop.collections.products.all("collection-handle");
 **Parameters:**
 - `handle` (string): The collection handle
 
-**Returns:** `ProductResult[] | null`
+**Returns:** `ProductResult[] | null` (typed based on `columns`, defaults to minimal)
 
 #### `collections.products.paginated(handle, options)`
 
@@ -600,7 +624,7 @@ const products = await shop.collections.products.paginated("collection-handle",
   - `limit` (number, optional): Products per page (default: 250)
   - `currency` (CurrencyCode, optional): ISO 4217 code aligned with `Intl.NumberFormatOptions['currency']`
 
-**Returns:** `ProductResult[] | null`
+**Returns:** `ProductResult[] | null` (typed based on `columns`, defaults to minimal)
 
 Collection products also default to minimal. To request full products from collections, pass `columns`:
 
@@ -616,6 +640,7 @@ By default, pricing is formatted using the store’s detected currency.
 You can override the currency for product and collection queries by passing a `currency` option.
 This override updates pricing display fields only:
 - `ProductResult.localizedPricing` formatted strings
+ - For full products (`mode: "full"`), `ProductResult.currency` is also set to the override
 
 ### Showcased Products
 

package/dist/ai/enrich.d.ts

@@ -1,4 +1,4 @@
-import { O as OpenRouterConfig, n as ProductClassification, o as SEOContent, p as SystemUserPrompt, b as ShopifySingleProduct } from '../types-C0NvqVL-.js';
+import { O as OpenRouterConfig, q as ProductClassification, r as SEOContent, s as SystemUserPrompt, e as ShopifySingleProduct } from '../types-gQvOWe1Z.js';
 
 declare function buildEnrichPrompt(args: {
     bodyInput: string;

package/dist/{chunk-LAJWR2GQ.mjs → chunk-2BRLCC3V.mjs}

@@ -21,12 +21,10 @@ function createCollectionOperations(baseUrl, storeDomain, fetchCollections, coll
     findCache.set(key, { ts: Date.now(), value });
   };
   function applyCurrencyOverride(product, currency) {
-    var _a, _b, _c, _d, _e;
     if ("priceMin" in product) {
-      const p = product;
-      const priceMin = typeof p.priceMin === "number" ? p.priceMin : (_a = p.price) != null ? _a : 0;
-      const priceMax = typeof p.priceMax === "number" ? p.priceMax : (_b = p.price) != null ? _b : 0;
-      const compareAtMin = typeof p.compareAtPriceMin === "number" ? p.compareAtPriceMin : (_c = p.compareAtPrice) != null ? _c : 0;
+      const priceMin = product.priceMin;
+      const priceMax = product.priceMax;
+      const compareAtMin = product.compareAtPriceMin;
       return {
         ...product,
         currency,
@@ -39,12 +37,11 @@ function createCollectionOperations(baseUrl, storeDomain, fetchCollections, coll
         }
       };
     }
-    const compareAtPrice = (_d = product.compareAtPrice) != null ? _d : 0;
     return {
       ...product,
       localizedPricing: {
-        priceFormatted: formatPrice((_e = product.price) != null ? _e : 0, currency),
-        compareAtPriceFormatted: formatPrice(compareAtPrice, currency)
+        priceFormatted: formatPrice(product.price, currency),
+        compareAtPriceFormatted: formatPrice(product.compareAtPrice, currency)
       }
     };
   }

package/dist/{chunk-HEQDULXV.mjs → chunk-YUS7GIF2.mjs}

@@ -21,12 +21,10 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
     findCache.set(key, { ts: Date.now(), value });
   };
   function applyCurrencyOverride(product, currency) {
-    var _a, _b, _c, _d, _e;
     if ("priceMin" in product) {
-      const p = product;
-      const priceMin = typeof p.priceMin === "number" ? p.priceMin : (_a = p.price) != null ? _a : 0;
-      const priceMax = typeof p.priceMax === "number" ? p.priceMax : (_b = p.price) != null ? _b : 0;
-      const compareAtMin = typeof p.compareAtPriceMin === "number" ? p.compareAtPriceMin : (_c = p.compareAtPrice) != null ? _c : 0;
+      const priceMin = product.priceMin;
+      const priceMax = product.priceMax;
+      const compareAtMin = product.compareAtPriceMin;
       return {
         ...product,
         currency,
@@ -39,12 +37,11 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
         }
       };
     }
-    const compareAtPrice = (_d = product.compareAtPrice) != null ? _d : 0;
     return {
       ...product,
       localizedPricing: {
-        priceFormatted: formatPrice((_e = product.price) != null ? _e : 0, currency),
-        compareAtPriceFormatted: formatPrice(compareAtPrice, currency)
+        priceFormatted: formatPrice(product.price, currency),
+        compareAtPriceFormatted: formatPrice(product.compareAtPrice, currency)
       }
     };
   }
@@ -237,10 +234,7 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
       handles.map((h) => findInternal(h, { columns }))
     );
     const results = filter(fetched, isNonNullish);
-    return (_e = maybeOverrideProductsCurrency(
-      results,
-      options.currency
-    )) != null ? _e : [];
+    return (_e = maybeOverrideProductsCurrency(results, options.currency)) != null ? _e : [];
   }
   async function recommendationsInternal(productId, options) {
     var _a, _b;
@@ -268,10 +262,7 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
     const isRecord = (v) => typeof v === "object" && v !== null;
     const productsArray = Array.isArray(data) ? data : isRecord(data) && Array.isArray(data.products) ? data.products : [];
     const normalized = productsDto(productsArray, { columns }) || [];
-    return maybeOverrideProductsCurrency(
-      normalized,
-      options.currency
-    );
+    return maybeOverrideProductsCurrency(normalized, options.currency);
   }
   async function findEnhancedInternal(productHandle, options) {
     var _a;
@@ -279,12 +270,11 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
     if (!apiKey || typeof apiKey !== "string" || !apiKey.trim()) {
       throw new Error("apiKey is required");
     }
-    const updatedAt = options.updatedAt;
     let updatedAtTrimmed;
-    if (typeof updatedAt === "string") {
-      const trimmed = updatedAt.trim();
+    if (typeof options.updatedAt === "string") {
+      const trimmed = options.updatedAt.trim();
       updatedAtTrimmed = trimmed ? trimmed : void 0;
-    } else if (updatedAt != null) {
+    } else if (options.updatedAt != null) {
       throw new Error("updatedAt must be a string");
     }
     const columns = resolveColumns(options.columns);
@@ -396,10 +386,13 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
      * });
      * ```
      */
-    all: async (options) => allInternal({
-      currency: options == null ? void 0 : options.currency,
-      columns: options == null ? void 0 : options.columns
-    }),
+    all: async (options) => {
+      const res = await allInternal({
+        currency: options == null ? void 0 : options.currency,
+        columns: options == null ? void 0 : options.columns
+      });
+      return res;
+    },
     /**
      * Fetches products with pagination support.
      *
@@ -422,12 +415,15 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
      * const secondPage = await shop.products.paginated({ page: 2, limit: 50 });
      * ```
      */
-    paginated: async (options) => paginatedInternal({
-      page: options == null ? void 0 : options.page,
-      limit: options == null ? void 0 : options.limit,
-      currency: options == null ? void 0 : options.currency,
-      columns: options == null ? void 0 : options.columns
-    }),
+    paginated: async (options) => {
+      const res = await paginatedInternal({
+        page: options == null ? void 0 : options.page,
+        limit: options == null ? void 0 : options.limit,
+        currency: options == null ? void 0 : options.currency,
+        columns: options == null ? void 0 : options.columns
+      });
+      return res;
+    },
     /**
      * Finds a specific product by its handle.
      *
@@ -453,10 +449,13 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
      * const productWithVariant = await shop.products.find('t-shirt?variant=123');
      * ```
      */
-    find: async (productHandle, options) => findInternal(productHandle, {
-      currency: options == null ? void 0 : options.currency,
-      columns: options == null ? void 0 : options.columns
-    }),
+    find: async (productHandle, options) => {
+      const res = await findInternal(productHandle, {
+        currency: options == null ? void 0 : options.currency,
+        columns: options == null ? void 0 : options.columns
+      });
+      return res;
+    },
     findEnhanced: async (productHandle, options) => findEnhancedInternal(productHandle, options),
     /**
      * Enrich a product by generating merged markdown from body_html and product page.
@@ -466,9 +465,12 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
       if (!productHandle || typeof productHandle !== "string") {
         throw new Error("Product handle is required and must be a string");
       }
-      const baseProduct = await findInternal(productHandle, {
-        columns: { mode: "full", images: "full", options: "full" }
-      });
+      const baseProduct = await findInternal(
+        productHandle,
+        {
+          columns: { mode: "full", images: "full", options: "full" }
+        }
+      );
       if (!baseProduct) return null;
       const handle = baseProduct.handle;
       const { enrichProduct } = await import("./ai/enrich.mjs");
@@ -490,9 +492,12 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
       if (!productHandle || typeof productHandle !== "string") {
         throw new Error("Product handle is required and must be a string");
       }
-      const baseProduct = await findInternal(productHandle, {
-        columns: { mode: "full", images: "full", options: "full" }
-      });
+      const baseProduct = await findInternal(
+        productHandle,
+        {
+          columns: { mode: "full", images: "full", options: "full" }
+        }
+      );
       if (!baseProduct) throw new Error("Product not found");
       const handle = baseProduct.handle;
       const { buildEnrichPromptForProduct } = await import("./ai/enrich.mjs");
@@ -546,9 +551,12 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
       if (!productHandle || typeof productHandle !== "string") {
         throw new Error("Product handle is required and must be a string");
       }
-      const baseProduct = await findInternal(productHandle, {
-        columns: { mode: "full", images: "full", options: "full" }
-      });
+      const baseProduct = await findInternal(
+        productHandle,
+        {
+          columns: { mode: "full", images: "full", options: "full" }
+        }
+      );
       if (!baseProduct) throw new Error("Product not found");
       const handle = baseProduct.handle;
       const { buildClassifyPromptForProduct } = await import("./ai/enrich.mjs");
@@ -562,9 +570,12 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
       if (!productHandle || typeof productHandle !== "string") {
         throw new Error("Product handle is required and must be a string");
       }
-      const baseProduct = await findInternal(productHandle, {
-        columns: { mode: "full", images: "full", options: "full" }
-      });
+      const baseProduct = await findInternal(
+        productHandle,
+        {
+          columns: { mode: "full", images: "full", options: "full" }
+        }
+      );
       if (!baseProduct) return null;
       const payload = {
         title: baseProduct.title,
@@ -606,9 +617,12 @@ function createProductOperations(baseUrl, storeDomain, fetchProducts, productsDt
       if (content) {
         return extractMainSection(content);
       }
-      const baseProduct = await findInternal(productHandle, {
-        columns: { mode: "full", images: "full", options: "full" }
-      });
+      const baseProduct = await findInternal(
+        productHandle,
+        {
+          columns: { mode: "full", images: "full", options: "full" }
+        }
+      );
       if (!baseProduct) return null;
       const pageHtml = await fetchProductPage(storeDomain, baseProduct.handle);
       return extractMainSection(pageHtml);

package/dist/collections.d.ts

@@ -1,5 +1,5 @@
 import { ShopInfo } from './store.js';
-import { d as Collection, h as CurrencyCode, P as ProductColumnsConfig, a as ProductResult, c as ShopifyCollection } from './types-C0NvqVL-.js';
+import { g as Collection, a as ProductColumnsMode, b as ProductImagesMode, c as ProductOptionsMode, k as CurrencyCode, P as ProductColumnsConfig, d as ProductResult, f as ShopifyCollection } from './types-gQvOWe1Z.js';
 
 /**
  * Interface for collection operations
@@ -37,19 +37,19 @@ interface CollectionOperations {
         /**
          * Fetches products from a specific collection with pagination support.
          */
-        paginated(collectionHandle: string, options?: {
+        paginated<C extends ProductColumnsMode = "minimal", I extends ProductImagesMode = "minimal", O extends ProductOptionsMode = "minimal">(collectionHandle: string, options?: {
             page?: number;
             limit?: number;
             currency?: CurrencyCode;
-            columns?: ProductColumnsConfig;
-        }): Promise<ProductResult[] | null>;
+            columns?: ProductColumnsConfig<C, I, O>;
+        }): Promise<ProductResult<C, I, O>[] | null>;
         /**
          * Fetches all products from a specific collection.
          */
-        all(collectionHandle: string, options?: {
+        all<C extends ProductColumnsMode = "minimal", I extends ProductImagesMode = "minimal", O extends ProductOptionsMode = "minimal">(collectionHandle: string, options?: {
             currency?: CurrencyCode;
-            columns?: ProductColumnsConfig;
-        }): Promise<ProductResult[] | null>;
+            columns?: ProductColumnsConfig<C, I, O>;
+        }): Promise<ProductResult<C, I, O>[] | null>;
         /**
          * Fetches all product slugs from a specific collection.
          */
@@ -59,10 +59,10 @@ interface CollectionOperations {
 /**
  * Creates collection operations for a store instance
  */
-declare function createCollectionOperations(baseUrl: string, storeDomain: string, fetchCollections: (page: number, limit: number) => Promise<Collection[] | null>, collectionsDto: (collections: ShopifyCollection[]) => Collection[], fetchPaginatedProductsFromCollection: (collectionHandle: string, options?: {
+declare function createCollectionOperations(baseUrl: string, storeDomain: string, fetchCollections: (page: number, limit: number) => Promise<Collection[] | null>, collectionsDto: (collections: ShopifyCollection[]) => Collection[], fetchPaginatedProductsFromCollection: <C extends ProductColumnsMode = "minimal", I extends ProductImagesMode = "minimal", O extends ProductOptionsMode = "minimal">(collectionHandle: string, options?: {
     page?: number;
     limit?: number;
-    columns?: ProductColumnsConfig;
-}) => Promise<ProductResult[] | null>, getStoreInfo: () => Promise<ShopInfo>, findCollection: (handle: string) => Promise<Collection | null>): CollectionOperations;
+    columns?: ProductColumnsConfig<C, I, O>;
+}) => Promise<ProductResult<C, I, O>[] | null>, getStoreInfo: () => Promise<ShopInfo>, findCollection: (handle: string) => Promise<Collection | null>): CollectionOperations;
 
 export { type CollectionOperations, createCollectionOperations };

package/dist/collections.mjs

@@ -1,6 +1,6 @@
 import {
   createCollectionOperations
-} from "./chunk-LAJWR2GQ.mjs";
+} from "./chunk-2BRLCC3V.mjs";
 import "./chunk-4GPP2KXF.mjs";
 import "./chunk-U3RQRBXZ.mjs";
 export {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { O as OpenRouterConfig, P as ProductColumnsConfig, C as CollectionColumnsConfig, S as ShopifyProduct, a as ProductResult, b as ShopifySingleProduct, c as ShopifyCollection, d as Collection, J as JsonLdEntry, e as StoreTypeBreakdown } from './types-C0NvqVL-.js';
-export { f as CountryDetectionResult, g as CountryScores, h as CurrencyCode, L as LocalizedPricing, M as MetaTag, i as Product, j as ProductImage, k as ProductOption, l as ProductVariant, m as ProductVariantImage } from './types-C0NvqVL-.js';
+import { O as OpenRouterConfig, P as ProductColumnsConfig, C as CollectionColumnsConfig, a as ProductColumnsMode, b as ProductImagesMode, c as ProductOptionsMode, S as ShopifyProduct, d as ProductResult, e as ShopifySingleProduct, f as ShopifyCollection, g as Collection, J as JsonLdEntry, h as StoreTypeBreakdown } from './types-gQvOWe1Z.js';
+export { i as CountryDetectionResult, j as CountryScores, k as CurrencyCode, L as LocalizedPricing, M as MetaTag, l as Product, m as ProductImage, n as ProductOption, o as ProductVariant, p as ProductVariantImage } from './types-gQvOWe1Z.js';
 import { CheckoutOperations } from './checkout.js';
 import { CollectionOperations } from './collections.js';
 import { ProductOperations } from './products.js';
@@ -85,12 +85,12 @@ declare class ShopClient {
     /**
      * Transform Shopify products to our Product format
      */
-    productsDto(products: ShopifyProduct[], options?: {
-        columns?: ProductColumnsConfig;
-    }): ProductResult[] | null;
-    productDto(product: ShopifySingleProduct, options?: {
-        columns?: ProductColumnsConfig;
-    }): ProductResult;
+    productsDto<C extends ProductColumnsMode = "minimal", I extends ProductImagesMode = "minimal", O extends ProductOptionsMode = "minimal">(products: ShopifyProduct[], options?: {
+        columns?: ProductColumnsConfig<C, I, O>;
+    }): ProductResult<C, I, O>[] | null;
+    productDto<C extends ProductColumnsMode = "minimal", I extends ProductImagesMode = "minimal", O extends ProductOptionsMode = "minimal">(product: ShopifySingleProduct, options?: {
+        columns?: ProductColumnsConfig<C, I, O>;
+    }): ProductResult<C, I, O>;
     collectionsDto(collections: ShopifyCollection[]): Collection[];
     /**
      * Enhanced error handling with context

package/dist/index.mjs

@@ -3,10 +3,10 @@ import {
 } from "./chunk-W4SF6W2P.mjs";
 import {
   createCollectionOperations
-} from "./chunk-LAJWR2GQ.mjs";
+} from "./chunk-2BRLCC3V.mjs";
 import {
   createProductOperations
-} from "./chunk-HEQDULXV.mjs";
+} from "./chunk-YUS7GIF2.mjs";
 import {
   createShopOperations,
   getInfoForShop
@@ -608,7 +608,9 @@ var ShopClient = class {
         normalizeImageUrl: (url) => this.normalizeImageUrl(url),
         formatPrice: (amount) => this.formatPrice(amount)
       },
-      { columns: (_b = options == null ? void 0 : options.columns) != null ? _b : this.productColumns }
+      {
+        columns: (_b = options == null ? void 0 : options.columns) != null ? _b : this.productColumns
+      }
     );
   }
   productDto(product, options) {
@@ -622,7 +624,9 @@ var ShopClient = class {
         normalizeImageUrl: (url) => this.normalizeImageUrl(url),
         formatPrice: (amount) => this.formatPrice(amount)
       },
-      { columns: (_b = options == null ? void 0 : options.columns) != null ? _b : this.productColumns }
+      {
+        columns: (_b = options == null ? void 0 : options.columns) != null ? _b : this.productColumns
+      }
     );
   }
   collectionsDto(collections) {

package/dist/products.d.ts

@@ -1,5 +1,5 @@
 import { ShopInfo } from './store.js';
-import { h as CurrencyCode, P as ProductColumnsConfig, a as ProductResult, E as EnhancedProductResponse, i as Product, n as ProductClassification, o as SEOContent, S as ShopifyProduct, b as ShopifySingleProduct, O as OpenRouterConfig } from './types-C0NvqVL-.js';
+import { a as ProductColumnsMode, b as ProductImagesMode, c as ProductOptionsMode, k as CurrencyCode, P as ProductColumnsConfig, d as ProductResult, E as EnhancedProductResponse, l as Product, q as ProductClassification, r as SEOContent, S as ShopifyProduct, e as ShopifySingleProduct, O as OpenRouterConfig } from './types-gQvOWe1Z.js';
 
 /**
  * Interface for product operations
@@ -8,26 +8,26 @@ interface ProductOperations {
     /**
      * Fetches all products from the store across all pages.
      */
-    all(options?: {
+    all<C extends ProductColumnsMode = "minimal", I extends ProductImagesMode = "minimal", O extends ProductOptionsMode = "minimal">(options?: {
         currency?: CurrencyCode;
-        columns?: ProductColumnsConfig;
-    }): Promise<ProductResult[] | null>;
+        columns?: ProductColumnsConfig<C, I, O>;
+    }): Promise<ProductResult<C, I, O>[] | null>;
     /**
      * Fetches products with pagination support.
      */
-    paginated(options?: {
+    paginated<C extends ProductColumnsMode = "minimal", I extends ProductImagesMode = "minimal", O extends ProductOptionsMode = "minimal">(options?: {
         page?: number;
         limit?: number;
         currency?: CurrencyCode;
-        columns?: ProductColumnsConfig;
-    }): Promise<ProductResult[] | null>;
+        columns?: ProductColumnsConfig<C, I, O>;
+    }): Promise<ProductResult<C, I, O>[] | null>;
     /**
      * Finds a specific product by its handle.
      */
-    find(productHandle: string, options?: {
+    find<C extends ProductColumnsMode = "minimal", I extends ProductImagesMode = "minimal", O extends ProductOptionsMode = "minimal">(productHandle: string, options?: {
         currency?: CurrencyCode;
-        columns?: ProductColumnsConfig;
-    }): Promise<ProductResult | null>;
+        columns?: ProductColumnsConfig<C, I, O>;
+    }): Promise<ProductResult<C, I, O> | null>;
     /**
      * Finds a product and enhances it with AI-generated content using an external service.
      *
@@ -37,12 +37,12 @@ interface ProductOperations {
      * @param options.updatedAt - Optional product updatedAt timestamp used to cache-bust/invalidate enrichment.
      * @param options.endpoint - Optional custom endpoint URL for the enhancement service. Defaults to the standard worker URL.
      */
-    findEnhanced(productHandle: string, options: {
+    findEnhanced<C extends ProductColumnsMode = "minimal", I extends ProductImagesMode = "minimal", O extends ProductOptionsMode = "minimal">(productHandle: string, options: {
         apiKey: string;
         updatedAt?: string;
         endpoint?: string;
-        columns?: ProductColumnsConfig;
-    }): Promise<EnhancedProductResponse<ProductResult> | null>;
+        columns?: ProductColumnsConfig<C, I, O>;
+    }): Promise<EnhancedProductResponse<ProductResult<C, I, O>> | null>;
     /**
      * Finds a product by handle and enriches its content using LLM.
      * Requires an OpenRouter API key via options.apiKey or ShopClient options.
@@ -93,9 +93,9 @@ interface ProductOperations {
     /**
      * Fetches products that are showcased/featured on the store's homepage.
      */
-    showcased(options?: {
-        columns?: ProductColumnsConfig;
-    }): Promise<ProductResult[]>;
+    showcased<C extends ProductColumnsMode = "minimal", I extends ProductImagesMode = "minimal", O extends ProductOptionsMode = "minimal">(options?: {
+        columns?: ProductColumnsConfig<C, I, O>;
+    }): Promise<ProductResult<C, I, O>[]>;
     /**
      * Creates a filter map of variant options and their distinct values from all products.
      */
@@ -103,36 +103,36 @@ interface ProductOperations {
     /**
      * Predictive product search using Shopify Ajax API.
      */
-    predictiveSearch(query: string, options?: {
+    predictiveSearch<C extends ProductColumnsMode = "minimal", I extends ProductImagesMode = "minimal", O extends ProductOptionsMode = "minimal">(query: string, options?: {
         limit?: number;
         locale?: string;
         currency?: CurrencyCode;
         unavailableProducts?: "show" | "hide" | "last";
-        columns?: ProductColumnsConfig;
-    }): Promise<ProductResult[]>;
+        columns?: ProductColumnsConfig<C, I, O>;
+    }): Promise<ProductResult<C, I, O>[]>;
     /**
      * Product recommendations for a given product ID using Shopify Ajax API.
      */
-    recommendations(productId: number, options?: {
+    recommendations<C extends ProductColumnsMode = "minimal", I extends ProductImagesMode = "minimal", O extends ProductOptionsMode = "minimal">(productId: number, options?: {
         limit?: number;
         intent?: "related" | "complementary";
         locale?: string;
         currency?: CurrencyCode;
-        columns?: ProductColumnsConfig;
-    }): Promise<ProductResult[] | null>;
+        columns?: ProductColumnsConfig<C, I, O>;
+    }): Promise<ProductResult<C, I, O>[] | null>;
 }
 /**
  * Creates product operations for a store instance
  */
-declare function createProductOperations(baseUrl: string, storeDomain: string, fetchProducts: (page: number, limit: number, options?: {
-    columns?: ProductColumnsConfig;
-}) => Promise<ProductResult[] | null>, productsDto: (products: ShopifyProduct[], options?: {
-    columns?: ProductColumnsConfig;
-}) => ProductResult[] | null, productDto: (product: ShopifySingleProduct, options?: {
-    columns?: ProductColumnsConfig;
-}) => ProductResult, getStoreInfo: () => Promise<ShopInfo>, _findProduct: (handle: string, options?: {
-    columns?: ProductColumnsConfig;
-}) => Promise<ProductResult | null>, getDefaultProductColumns: () => ProductColumnsConfig, ai?: {
+declare function createProductOperations(baseUrl: string, storeDomain: string, fetchProducts: <C extends ProductColumnsMode = "minimal", I extends ProductImagesMode = "minimal", O extends ProductOptionsMode = "minimal">(page: number, limit: number, options?: {
+    columns?: ProductColumnsConfig<C, I, O>;
+}) => Promise<ProductResult<C, I, O>[] | null>, productsDto: <C extends ProductColumnsMode = "minimal", I extends ProductImagesMode = "minimal", O extends ProductOptionsMode = "minimal">(products: ShopifyProduct[], options?: {
+    columns?: ProductColumnsConfig<C, I, O>;
+}) => ProductResult<C, I, O>[] | null, productDto: <C extends ProductColumnsMode = "minimal", I extends ProductImagesMode = "minimal", O extends ProductOptionsMode = "minimal">(product: ShopifySingleProduct, options?: {
+    columns?: ProductColumnsConfig<C, I, O>;
+}) => ProductResult<C, I, O>, getStoreInfo: () => Promise<ShopInfo>, _findProduct: <C extends ProductColumnsMode = "minimal", I extends ProductImagesMode = "minimal", O extends ProductOptionsMode = "minimal">(handle: string, options?: {
+    columns?: ProductColumnsConfig<C, I, O>;
+}) => Promise<ProductResult<C, I, O> | null>, getDefaultProductColumns: () => ProductColumnsConfig, ai?: {
     openRouter?: OpenRouterConfig;
 }): ProductOperations;
 

package/dist/products.mjs

@@ -1,6 +1,6 @@
 import {
   createProductOperations
-} from "./chunk-HEQDULXV.mjs";
+} from "./chunk-YUS7GIF2.mjs";
 import "./chunk-4GPP2KXF.mjs";
 import "./chunk-U3RQRBXZ.mjs";
 export {

package/dist/store.d.ts

@@ -1,4 +1,4 @@
-import { J as JsonLdEntry, f as CountryDetectionResult, h as CurrencyCode } from './types-C0NvqVL-.js';
+import { J as JsonLdEntry, i as CountryDetectionResult, k as CurrencyCode } from './types-gQvOWe1Z.js';
 
 /**
  * Store operations interface for managing store-related functionality.

package/dist/{types-C0NvqVL-.d.ts → types-gQvOWe1Z.d.ts}

@@ -519,4 +519,4 @@ type EnhancedProductResponse<TProduct = Product> = {
 };
 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 { CollectionColumnsConfig as C, EnhancedProductResponse as E, JsonLdEntry as J, LocalizedPricing as L, MetaTag as M, OpenRouterConfig as O, ProductColumnsConfig as P, ShopifyProduct as S, ProductResult as a, ShopifySingleProduct as b, ShopifyCollection as c, Collection as d, StoreTypeBreakdown as e, CountryDetectionResult as f, CountryScores as g, CurrencyCode as h, Product as i, ProductImage as j, ProductOption as k, ProductVariant as l, ProductVariantImage as m, ProductClassification as n, SEOContent as o, SystemUserPrompt as p };
+export type { CollectionColumnsConfig as C, EnhancedProductResponse as E, JsonLdEntry as J, LocalizedPricing as L, MetaTag as M, OpenRouterConfig as O, ProductColumnsConfig as P, ShopifyProduct as S, ProductColumnsMode as a, ProductImagesMode as b, ProductOptionsMode as c, ProductResult as d, ShopifySingleProduct as e, ShopifyCollection as f, Collection as g, StoreTypeBreakdown as h, CountryDetectionResult as i, CountryScores as j, CurrencyCode as k, Product as l, ProductImage as m, ProductOption as n, ProductVariant as o, ProductVariantImage as p, ProductClassification as q, SEOContent as r, SystemUserPrompt as s };

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

@@ -1,4 +1,4 @@
-import { f as CountryDetectionResult } from '../types-C0NvqVL-.js';
+import { i as CountryDetectionResult } from '../types-gQvOWe1Z.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 { h as CurrencyCode } from '../types-C0NvqVL-.js';
+import { k as CurrencyCode } from '../types-gQvOWe1Z.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.23.0",
+  "version": "3.24.0",
   "type": "module",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",