@commercengine/storefront-sdk 0.13.2 → 0.13.4

package/dist/index.d.mts

@@ -962,7 +962,7 @@ interface paths {
     patch?: never;
     trace?: never;
   };
-  "/catalog/marketplace/products/{product_id_or_slug}": {
+  "/catalog/marketplace/products/{product_id}": {
     parameters: {
       query?: never;
       header?: never;
@@ -971,7 +971,7 @@ interface paths {
     };
     /**
      * Retrieve a product detail
-     * @description Retrieves the details of an existing product. Supply either the unique product ID or the unique slug, and Commerce Engine will return the corresponding product information.
+     * @description Retrieves the details of an existing marketplace product. Product slug is supported in place of product ID in the path. Commerce Engine returns the corresponding product information.
      */
     get: operations["get-marketplace-product-detail"];
     put?: never;
@@ -1015,7 +1015,7 @@ interface paths {
     };
     /**
      * Retrieve product variants
-     * @description Retrieves the variants of an existing product. Supply the unique product ID, and Commerce Engine will return the corresponding product variants information.
+     * @description Retrieves the variants of an existing marketplace product. Product slug is supported in place of product ID in the path. Commerce Engine returns the corresponding product variants information.
      */
     get: operations["list-marketplace-product-variants"];
     put?: never;
@@ -1035,7 +1035,7 @@ interface paths {
     };
     /**
      * Retrieve variant detail
-     * @description Retrieves the details of a particular variant. Supply the unique product ID, and variant ID.
+     * @description Retrieves the details of a particular marketplace variant. Product slug is supported in place of product ID, and variant slug in place of variant ID, in the path.
      */
     get: operations["get-marketplace-variant-detail"];
     put?: never;
@@ -1166,7 +1166,7 @@ interface paths {
     patch?: never;
     trace?: never;
   };
-  "/catalog/products/{product_id_or_slug}": {
+  "/catalog/products/{product_id}": {
     parameters: {
       query?: never;
       header?: never;
@@ -1175,7 +1175,7 @@ interface paths {
     };
     /**
      * Retrieve a product detail
-     * @description Retrieves the details of an existing product. Supply either the unique product ID or the unique slug, and Commerce Engine will return the corresponding product information.
+     * @description Retrieves the details of an existing product. Product slug is supported in place of product ID in the path. Commerce Engine returns the corresponding product information.
      */
     get: operations["get-product-detail"];
     put?: never;
@@ -1219,7 +1219,7 @@ interface paths {
     };
     /**
      * Retrieve product variants
-     * @description Retrieves the variants of an existing product. Supply the unique product ID, and Commerce Engine will return the corresponding product variants information.
+     * @description Retrieves the variants of an existing product. Product slug is supported in place of product ID in the path. Commerce Engine returns the corresponding product variants information.
      */
     get: operations["list-product-variants"];
     put?: never;
@@ -1239,7 +1239,7 @@ interface paths {
     };
     /**
      * Retrieve variant detail
-     * @description Retrieves the details of a particular variant. Supply the unique product ID, and variant ID.
+     * @description Retrieves the details of a particular variant. Product slug is supported in place of product ID, and variant slug in place of variant ID, in the path.
      */
     get: operations["get-variant-detail"];
     put?: never;
@@ -2575,7 +2575,7 @@ interface paths {
     patch?: never;
     trace?: never;
   };
-  "/pos/catalog/products/{product_id_or_slug}": {
+  "/pos/catalog/products/{product_id}": {
     parameters: {
       query?: never;
       header?: never;
@@ -2584,7 +2584,7 @@ interface paths {
     };
     /**
      * Retrieve a product detail
-     * @description Retrieves the details of an existing product. Supply either the unique product ID or the unique slug, and Commerce Engine will return the corresponding product information.
+     * @description Retrieves the details of an existing product. Product slug is supported in place of product ID in the path. Commerce Engine returns the corresponding product information.
      */
     get: operations["pos-get-product-detail"];
     put?: never;
@@ -2624,7 +2624,7 @@ interface paths {
     };
     /**
      * Retrieve product variants
-     * @description Retrieves the variants of an existing product. Supply the unique product ID, and Commerce Engine will return the corresponding product variants information.
+     * @description Retrieves the variants of an existing product. Product slug is supported in place of product ID in the path. Commerce Engine returns the corresponding product variants information.
      */
     get: operations["pos-list-product-variants"];
     put?: never;
@@ -2644,7 +2644,7 @@ interface paths {
     };
     /**
      * Retrieve variant detail
-     * @description Retrieves the details of a particular variant. Supply the unique product ID, and variant ID.
+     * @description Retrieves the details of a particular variant. Product slug is supported in place of product ID, and variant slug in place of variant ID, in the path.
      */
     get: operations["pos-get-variant-detail"];
     put?: never;
@@ -4065,7 +4065,8 @@ interface components {
       product_id: string;
       variant_id: string | null;
       sku: string;
-      slug: string;
+      product_slug: string;
+      variant_slug: string;
       product_name: string;
       variant_name: string | null;
       /**
@@ -4079,7 +4080,8 @@ interface components {
       backorder?: boolean;
       on_subscription: boolean;
       on_promotion: boolean;
-      category_ids: string[];
+      category_ids: string[]; /** @description Expanded category objects. */
+      categories?: components["schemas"]["Category"][];
       tags: string[] | null;
       reviews_count: number;
       reviews_rating_sum: number | null;
@@ -4475,12 +4477,20 @@ interface components {
      * @description Loyalty Point Activity
      */
     LoyaltyPointActivity: {
-      /** @enum {string} */activity_type?: "earned" | "redeemed"; /** @constant */
-      activity?: "order";
-      reference_number?: string;
+      /**
+       * @description The action that occurred.
+       * @enum {string}
+       */
+      action?: "add" | "remove";
+      /**
+       * @description The activity that occurred.
+       * @enum {string}
+       */
+      activity?: "order-placed" | "credit-note-issued" | "tier-upgrade" | "tier-downgrade" | "points-expired" | "points-carryforward" | "signup" | "bonus" | "other";
+      reference_number?: string | null;
       title?: string;
-      loyalty_point?: number;
-      remarks?: string; /** Format: date-time */
+      loyalty_points?: number;
+      remarks?: string | null; /** Format: date-time */
       created_at?: string; /** Format: date-time */
       modified_at?: string;
     }; /** ManualPaymentMethod */
@@ -5388,17 +5398,55 @@ interface components {
        * @description Maximum number of records returned for a page.
        * @default 25
        */
-      limit: number;
+      limit: number; /** @description provide list of attributes for specific facets or * for all facets. All attributes supported in the filter parameter are also supported here. */
+      facets?: string[];
       /**
-       * @description provide list of attributes for specific facets or * for all facets.
-       *     ```json
-       *     For specific facets: ["size", "color", "brand"]
-       *     ```
-       *     ```json
-       *     For all facets: ["*"]
-       *     ```
+       * @description Filter expression(s) to narrow results. Omit for no filtering.
+       *
+       *     **Syntax:** `attribute OPERATOR value`
+       *
+       *     **Operators:**
+       *
+       *     | Operator | Description | Example |
+       *     |---|---|---|
+       *     | `=` | Equal to | `product_type = physical` |
+       *     | `!=` | Not equal to | `product_type != bundle` |
+       *     | `>`, `>=`, `<`, `<=` | Comparison | `rating > 4` |
+       *     | `TO` | Inclusive range (`>=` AND `<=`) | `pricing.selling_price 100 TO 500` |
+       *     | `IN [...]` | Matches any value in the list | `product_type IN [physical,bundle]` |
+       *     | `NOT IN [...]` | Excludes all values in the list | `product_type NOT IN [physical,bundle]` |
+       *     | `EXISTS` | Attribute is present (even if `null` or empty) | `tags EXISTS` |
+       *     | `NOT EXISTS` | Attribute is absent | `tags NOT EXISTS` |
+       *     | `IS NULL` | Value is `null` | `variant_id IS NULL` |
+       *     | `IS NOT NULL` | Value is not `null` | `variant_id IS NOT NULL` |
+       *     | `IS EMPTY` | Value is `""`, `[]`, or `{}` | `tags IS EMPTY` |
+       *     | `IS NOT EMPTY` | Value is not empty | `tags IS NOT EMPTY` |
+       *     | `AND` | Both conditions must match | `rating > 4 AND product_type = physical` |
+       *     | `OR` | Either condition must match | `product_type = physical OR product_type = bundle` |
+       *     | `NOT` | Negates a condition | `NOT product_type = bundle` |
+       *
+       *     **Important rules:**
+       *     - Operators are **case-sensitive** — must be uppercase (`AND`, not `and`).
+       *     - String value comparison is **case-insensitive** — `product_type = Physical` matches `physical`.
+       *     - Operator precedence: `NOT` > `AND` > `OR`. Use parentheses to override.
+       *     - String values containing whitespace must be wrapped in single quotes.
+       *     - `IN` takes comma-separated values in square brackets.
+       *     - Maximum array nesting depth is **2 levels**.
+       *
+       *     **Supported attributes:** `product_type`, `categories.name`, `attributes.key`, `pricing.listing_price`, `pricing.selling_price`, `pricing.tax_rate`, `product_id`, `variant_id`, `product_name`, `variant_name`, `tags`, `sku`, `stock_available`, `rating`
+       *
+       *     **Combining conditions:**
+       *     - **String:** Use `AND`/`OR` operators inline — `"rating > 4 AND product_type = physical"`
+       *     - **Array of strings:** Conditions are combined with AND — `["rating > 4", "product_type = physical"]`
+       *     - **Nested arrays:** Inner arrays express OR, outer array expresses AND — `["product_type = physical", ["product_type = bundle", "rating > 4"]]`
        */
-      facets?: string[];
+      filter?: string | (string | string[])[];
+      /**
+       * @description Sort results by attributes. Use `asc` for ascending order and `desc` for descending order.
+       * @example product_type:desc
+       * @example product_name:asc
+       */
+      sort?: string[];
     }; /** SellerDetail */
     SellerDetail: components["schemas"]["SellerInfo"] & {
       description?: string;
@@ -5426,7 +5474,6 @@ interface components {
       count?: number;
     }; /** Seo */
     Seo: {
-      slug: string;
       title: string | null;
       description: string | null;
       keywords: string[] | null;
@@ -7868,7 +7915,7 @@ interface operations {
         /** @description This param is used to determine product pricing, promotions, and subscription rates.  If a valid customer group id is provided, pricing details will be retrieved accordingly.  If no matching data is found for the specified customer group id, the system will fall back to the default customer group id.  If no data is found for the default group either, the highest applicable price will be returned. */"x-customer-group-id"?: components["parameters"]["CustomerGroupId"];
       };
       path: {
-        /** @description The unique identifier of the product. Can be either the product ID or the slug. */product_id_or_slug: string;
+        /** @description Product ID or product slug. Either is accepted in the path. */product_id: string;
       };
       cookie?: never;
     };
@@ -7969,7 +8016,7 @@ interface operations {
         /** @description This param is used to determine product pricing, promotions, and subscription rates.  If a valid customer group id is provided, pricing details will be retrieved accordingly.  If no matching data is found for the specified customer group id, the system will fall back to the default customer group id.  If no data is found for the default group either, the highest applicable price will be returned. */"x-customer-group-id"?: components["parameters"]["CustomerGroupId"];
       };
       path: {
-        /** @description ID of a particular product */product_id: string;
+        /** @description Product ID or product slug. Either is accepted in the path. */product_id: string;
       };
       cookie?: never;
     };
@@ -8002,7 +8049,7 @@ interface operations {
         /** @description This param is used to determine product pricing, promotions, and subscription rates.  If a valid customer group id is provided, pricing details will be retrieved accordingly.  If no matching data is found for the specified customer group id, the system will fall back to the default customer group id.  If no data is found for the default group either, the highest applicable price will be returned. */"x-customer-group-id"?: components["parameters"]["CustomerGroupId"];
       };
       path: {
-        /** @description product id */product_id: string; /** @description variant id */
+        /** @description Product ID or product slug. Either is accepted in the path. */product_id: string; /** @description Variant ID or variant slug. Either is accepted in the path. */
         variant_id: string;
       };
       cookie?: never;
@@ -8260,7 +8307,7 @@ interface operations {
         /** @description This param is used to determine product pricing, promotions, and subscription rates.  If a valid customer group id is provided, pricing details will be retrieved accordingly.  If no matching data is found for the specified customer group id, the system will fall back to the default customer group id.  If no data is found for the default group either, the highest applicable price will be returned. */"x-customer-group-id"?: components["parameters"]["CustomerGroupId"];
       };
       path: {
-        /** @description The unique identifier of the product. Can be either the product ID or the slug. */product_id_or_slug: string;
+        /** @description Product ID or product slug. Either is accepted in the path. */product_id: string;
       };
       cookie?: never;
     };
@@ -8361,7 +8408,7 @@ interface operations {
         /** @description This param is used to determine product pricing, promotions, and subscription rates.  If a valid customer group id is provided, pricing details will be retrieved accordingly.  If no matching data is found for the specified customer group id, the system will fall back to the default customer group id.  If no data is found for the default group either, the highest applicable price will be returned. */"x-customer-group-id"?: components["parameters"]["CustomerGroupId"];
       };
       path: {
-        /** @description ID of a particular product */product_id: string;
+        /** @description Product ID or product slug. Either is accepted in the path. */product_id: string;
       };
       cookie?: never;
     };
@@ -8394,7 +8441,7 @@ interface operations {
         /** @description This param is used to determine product pricing, promotions, and subscription rates.  If a valid customer group id is provided, pricing details will be retrieved accordingly.  If no matching data is found for the specified customer group id, the system will fall back to the default customer group id.  If no data is found for the default group either, the highest applicable price will be returned. */"x-customer-group-id"?: components["parameters"]["CustomerGroupId"];
       };
       path: {
-        /** @description product id */product_id: string; /** @description variant id */
+        /** @description Product ID or product slug. Either is accepted in the path. */product_id: string; /** @description Variant ID or variant slug. Either is accepted in the path. */
         variant_id: string;
       };
       cookie?: never;
@@ -8993,7 +9040,6 @@ interface operations {
             success?: boolean;
             content?: {
               loyalty?: components["schemas"]["CustomerLoyalty"];
-              loyalty_point_balance?: number;
             };
           };
         };
@@ -10883,7 +10929,7 @@ interface operations {
         /** @description This param is used to determine product pricing, promotions, and subscription rates.  If a valid customer group id is provided, pricing details will be retrieved accordingly.  If no matching data is found for the specified customer group id, the system will fall back to the default customer group id.  If no data is found for the default group either, the highest applicable price will be returned. */"x-customer-group-id"?: components["parameters"]["CustomerGroupId"];
       };
       path: {
-        /** @description The unique identifier of the product. Can be either the product ID or the slug. */product_id_or_slug: string;
+        /** @description Product ID or product slug. Either is accepted in the path. */product_id: string;
       };
       cookie?: never;
     };
@@ -10953,7 +10999,7 @@ interface operations {
         /** @description This param is used to determine product pricing, promotions, and subscription rates.  If a valid customer group id is provided, pricing details will be retrieved accordingly.  If no matching data is found for the specified customer group id, the system will fall back to the default customer group id.  If no data is found for the default group either, the highest applicable price will be returned. */"x-customer-group-id"?: components["parameters"]["CustomerGroupId"];
       };
       path: {
-        /** @description ID of a particular product */product_id: string;
+        /** @description Product ID or product slug. Either is accepted in the path. */product_id: string;
       };
       cookie?: never;
     };
@@ -10986,7 +11032,7 @@ interface operations {
         /** @description This param is used to determine product pricing, promotions, and subscription rates.  If a valid customer group id is provided, pricing details will be retrieved accordingly.  If no matching data is found for the specified customer group id, the system will fall back to the default customer group id.  If no data is found for the default group either, the highest applicable price will be returned. */"x-customer-group-id"?: components["parameters"]["CustomerGroupId"];
       };
       path: {
-        /** @description product id */product_id: string; /** @description variant id */
+        /** @description Product ID or product slug. Either is accepted in the path. */product_id: string; /** @description Variant ID or variant slug. Either is accepted in the path. */
         variant_id: string;
       };
       cookie?: never;
@@ -12731,11 +12777,11 @@ type ListMarketplaceUpsellProductsResponse = Readable<paths['/catalog/marketplac
 type ListMarketplaceUpsellProductsContent = ListMarketplaceUpsellProductsResponse['content'];
 type ListMarketplaceUpsellProductsQuery = paths['/catalog/marketplace/products/up-sell']['get']['parameters']['query'];
 type ListMarketplaceUpsellProductsHeaderParams = paths['/catalog/marketplace/products/up-sell']['get']['parameters']['header'];
-type GetMarketplaceProductDetailResponse = Readable<paths['/catalog/marketplace/products/{product_id_or_slug}']['get']['responses'][200]['content']['application/json']>;
+type GetMarketplaceProductDetailResponse = Readable<paths['/catalog/marketplace/products/{product_id}']['get']['responses'][200]['content']['application/json']>;
 type GetMarketplaceProductDetailContent = GetMarketplaceProductDetailResponse['content'];
-type GetMarketplaceProductDetailQuery = paths['/catalog/marketplace/products/{product_id_or_slug}']['get']['parameters']['query'];
-type GetMarketplaceProductDetailPathParams = paths['/catalog/marketplace/products/{product_id_or_slug}']['get']['parameters']['path'];
-type GetMarketplaceProductDetailHeaderParams = paths['/catalog/marketplace/products/{product_id_or_slug}']['get']['parameters']['header'];
+type GetMarketplaceProductDetailQuery = paths['/catalog/marketplace/products/{product_id}']['get']['parameters']['query'];
+type GetMarketplaceProductDetailPathParams = paths['/catalog/marketplace/products/{product_id}']['get']['parameters']['path'];
+type GetMarketplaceProductDetailHeaderParams = paths['/catalog/marketplace/products/{product_id}']['get']['parameters']['header'];
 type ListMarketplaceProductReviewsResponse = Readable<paths['/catalog/marketplace/products/{product_id}/reviews']['get']['responses'][200]['content']['application/json']>;
 type ListMarketplaceProductReviewsContent = ListMarketplaceProductReviewsResponse['content'];
 type ListMarketplaceProductReviewsQuery = paths['/catalog/marketplace/products/{product_id}/reviews']['get']['parameters']['query'];
@@ -12777,11 +12823,11 @@ type ListUpsellProductsResponse = Readable<paths['/catalog/products/up-sell']['g
 type ListUpsellProductsContent = ListUpsellProductsResponse['content'];
 type ListUpsellProductsQuery = paths['/catalog/products/up-sell']['get']['parameters']['query'];
 type ListUpsellProductsHeaderParams = paths['/catalog/products/up-sell']['get']['parameters']['header'];
-type GetProductDetailResponse = Readable<paths['/catalog/products/{product_id_or_slug}']['get']['responses'][200]['content']['application/json']>;
+type GetProductDetailResponse = Readable<paths['/catalog/products/{product_id}']['get']['responses'][200]['content']['application/json']>;
 type GetProductDetailContent = GetProductDetailResponse['content'];
-type GetProductDetailQuery = paths['/catalog/products/{product_id_or_slug}']['get']['parameters']['query'];
-type GetProductDetailPathParams = paths['/catalog/products/{product_id_or_slug}']['get']['parameters']['path'];
-type GetProductDetailHeaderParams = paths['/catalog/products/{product_id_or_slug}']['get']['parameters']['header'];
+type GetProductDetailQuery = paths['/catalog/products/{product_id}']['get']['parameters']['query'];
+type GetProductDetailPathParams = paths['/catalog/products/{product_id}']['get']['parameters']['path'];
+type GetProductDetailHeaderParams = paths['/catalog/products/{product_id}']['get']['parameters']['header'];
 type ListProductReviewsResponse = Readable<paths['/catalog/products/{product_id}/reviews']['get']['responses'][200]['content']['application/json']>;
 type ListProductReviewsContent = ListProductReviewsResponse['content'];
 type ListProductReviewsQuery = paths['/catalog/products/{product_id}/reviews']['get']['parameters']['query'];
@@ -13040,11 +13086,11 @@ type PosListUpsellProductsResponse = Readable<paths['/pos/catalog/products/up-se
 type PosListUpsellProductsContent = PosListUpsellProductsResponse['content'];
 type PosListUpsellProductsQuery = paths['/pos/catalog/products/up-sell']['get']['parameters']['query'];
 type PosListUpsellProductsHeaderParams = paths['/pos/catalog/products/up-sell']['get']['parameters']['header'];
-type PosGetProductDetailResponse = Readable<paths['/pos/catalog/products/{product_id_or_slug}']['get']['responses'][200]['content']['application/json']>;
+type PosGetProductDetailResponse = Readable<paths['/pos/catalog/products/{product_id}']['get']['responses'][200]['content']['application/json']>;
 type PosGetProductDetailContent = PosGetProductDetailResponse['content'];
-type PosGetProductDetailQuery = paths['/pos/catalog/products/{product_id_or_slug}']['get']['parameters']['query'];
-type PosGetProductDetailPathParams = paths['/pos/catalog/products/{product_id_or_slug}']['get']['parameters']['path'];
-type PosGetProductDetailHeaderParams = paths['/pos/catalog/products/{product_id_or_slug}']['get']['parameters']['header'];
+type PosGetProductDetailQuery = paths['/pos/catalog/products/{product_id}']['get']['parameters']['query'];
+type PosGetProductDetailPathParams = paths['/pos/catalog/products/{product_id}']['get']['parameters']['path'];
+type PosGetProductDetailHeaderParams = paths['/pos/catalog/products/{product_id}']['get']['parameters']['header'];
 type PosListProductReviewsResponse = Readable<paths['/pos/catalog/products/{product_id}/reviews']['get']['responses'][200]['content']['application/json']>;
 type PosListProductReviewsContent = PosListProductReviewsResponse['content'];
 type PosListProductReviewsQuery = paths['/pos/catalog/products/{product_id}/reviews']['get']['parameters']['query'];
@@ -13229,7 +13275,7 @@ declare class CatalogClient extends StorefrontAPIClient {
   /**
    * Get details for a specific product
    *
-   * @param pathParams - The path parameters (product ID or slug)
+   * @param pathParams - The path parameters. Accepts product ID or product slug.
    * @param headers - Optional header parameters (customer_group_id, etc.)
    * @returns Promise with product details
    *
@@ -13237,7 +13283,7 @@ declare class CatalogClient extends StorefrontAPIClient {
    * ```typescript
    * // Get product by ID
    * const { data, error } = await sdk.catalog.getProductDetail(
-   *   { product_id_or_slug: "prod_123" }
+   *   { product_id: "prod_123" }
    * );
    *
    * if (error) {
@@ -13249,14 +13295,15 @@ declare class CatalogClient extends StorefrontAPIClient {
    * console.log("Price:", data.product.pricing?.selling_price);
    * console.log("Description:", data.product.short_description);
    *
-   * // Get product by slug
+   * // Get product by slug (also accepted in place of product_id)
    * const { data: slugData, error: slugError } = await sdk.catalog.getProductDetail({
-   *   product_id_or_slug: "detox-candy"
+   *   product_id: "detox-candy"
    * });
    *
    * // Override customer group ID for this specific request
    * const { data: overrideData, error: overrideError } = await sdk.catalog.getProductDetail(
-   *   { product_id_or_slug: "detox-candy" },
+   *   { product_id: "detox-candy" },
+   *   undefined,
    *   {
    *     "x-customer-group-id": "premium_customers" // Override default SDK config
    *   }
@@ -13274,12 +13321,13 @@ declare class CatalogClient extends StorefrontAPIClient {
   /**
    * List all variants for a specific product
    *
-   * @param pathParams - The path parameters (product ID)
+   * @param pathParams - The path parameters. Accepts product ID or product slug.
    * @param headers - Optional header parameters (customer_group_id, etc.)
    * @returns Promise with product variants and pagination info
    *
    * @example
    * ```typescript
+   * // By product ID
    * const { data, error } = await sdk.catalog.listProductVariants(
    *   { product_id: "prod_123" }
    * );
@@ -13295,9 +13343,15 @@ declare class CatalogClient extends StorefrontAPIClient {
    *   console.log(`Variant: ${variant.name} - SKU: ${variant.sku} - Price: ${variant.pricing?.selling_price}`);
    * });
    *
+   * // By product slug (also accepted in place of product_id)
+   * const { data: slugData, error: slugError } = await sdk.catalog.listProductVariants(
+   *   { product_id: "detox-candy" }
+   * );
+   *
    * // Override customer group ID for this specific request
    * const { data: overrideData, error: overrideError } = await sdk.catalog.listProductVariants(
    *   { product_id: "prod_123" },
+   *   undefined,
    *   {
    *     "x-customer-group-id": "wholesale_customers" // Override default SDK config
    *   }
@@ -13308,12 +13362,13 @@ declare class CatalogClient extends StorefrontAPIClient {
   /**
    * Get details for a specific product variant
    *
-   * @param pathParams - The path parameters (product ID and variant ID)
+   * @param pathParams - The path parameters. Accepts product ID or slug for product_id, and variant ID or slug for variant_id.
    * @param headers - Optional header parameters (customer_group_id, etc.)
    * @returns Promise with variant details
    *
    * @example
    * ```typescript
+   * // By product ID and variant ID
    * const { data, error } = await sdk.catalog.getVariantDetail(
    *   {
    *     product_id: "prod_123",
@@ -13330,6 +13385,14 @@ declare class CatalogClient extends StorefrontAPIClient {
    * console.log("SKU:", data.variant.sku);
    * console.log("Price:", data.variant.pricing?.selling_price);
    * console.log("Stock available:", data.variant.stock_available);
+   *
+   * // By product slug and variant slug (also accepted in place of IDs)
+   * const { data: slugData, error: slugError } = await sdk.catalog.getVariantDetail(
+   *   {
+   *     product_id: "detox-candy",
+   *     variant_id: "detox-candy-100g"
+   *   }
+   * );
    * ```
    */
   getVariantDetail(pathParams: GetVariantDetailPathParams, options?: GetVariantDetailQuery, headers?: GetVariantDetailHeaderParams): Promise<ApiResult<GetVariantDetailContent>>;
@@ -13434,19 +13497,15 @@ declare class CatalogClient extends StorefrontAPIClient {
   /**
    * Search for products
    *
-   * @param searchData - The search query and filters
+   * @param searchData - The search query, filters, sort, and pagination options
    * @param headers - Optional header parameters (customer_group_id, etc.)
-   * @returns Promise with search results including products, facets, and pagination
+   * @returns Promise with search results including SKUs, facet distribution, facet stats, and pagination
    *
    * @example
    * ```typescript
+   * // Basic search
    * const { data, error } = await sdk.catalog.searchProducts({
    *   query: "smartphone",
-   *   filters: {
-   *     category: ["electronics", "mobile"],
-   *     price_range: { min: 100, max: 1000 },
-   *     brand: ["Apple", "Samsung"] // facet names depend on product configuration
-   *   },
    *   page: 1,
    *   limit: 20
    * });
@@ -13458,17 +13517,51 @@ declare class CatalogClient extends StorefrontAPIClient {
    *
    * console.log("Search results:", data.skus?.length || 0, "products found");
    * console.log("Facet distribution:", data.facet_distribution);
-   * console.log("Price range:", data.facet_stats.price_range);
+   * console.log("Facet stats:", data.facet_stats);
+   * console.log("Pagination:", data.pagination);
    *
    * data.skus?.forEach(sku => {
    *   console.log(`Found: ${sku.product_name} - ${sku.pricing?.selling_price}`);
    * });
    *
+   * // With filter (string expression — Meilisearch syntax)
+   * const { data: filtered, error: filteredError } = await sdk.catalog.searchProducts({
+   *   query: "laptop",
+   *   filter: "pricing.selling_price 500 TO 2000 AND product_type = physical",
+   *   sort: ["pricing.selling_price:asc"],
+   *   facets: ["product_type", "categories.name", "tags"],
+   *   page: 1,
+   *   limit: 10
+   * });
+   *
+   * // With filter (array of conditions — combined with AND)
+   * const { data: arrayFiltered, error: arrayError } = await sdk.catalog.searchProducts({
+   *   query: "shoes",
+   *   filter: ["product_type = physical", "rating >= 4", "stock_available > 0"],
+   *   sort: ["rating:desc"],
+   *   facets: ["*"],
+   *   page: 1,
+   *   limit: 25
+   * });
+   *
+   * // With filter (nested arrays — inner arrays use OR, outer uses AND)
+   * const { data: nestedFiltered, error: nestedError } = await sdk.catalog.searchProducts({
+   *   query: "headphones",
+   *   filter: [
+   *     "pricing.selling_price 50 TO 300",
+   *     ["product_type = physical", "product_type = bundle"]
+   *   ],
+   *   page: 1,
+   *   limit: 25
+   * });
+   *
    * // Override customer group ID for this specific request
    * const { data: overrideData, error: overrideError } = await sdk.catalog.searchProducts(
    *   {
    *     query: "laptop",
-   *     filters: { category: ["computers"] }
+   *     filter: "categories.name = computers",
+   *     page: 1,
+   *     limit: 20
    *   },
    *   {
    *     "x-customer-group-id": "01H9XYZ12345USERID" // Override default SDK config