@commercengine/storefront-sdk 0.13.3 → 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;
       /**
@@ -5473,7 +5474,6 @@ interface components {
       count?: number;
     }; /** Seo */
     Seo: {
-      slug: string;
       title: string | null;
       description: string | null;
       keywords: string[] | null;
@@ -7915,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;
     };
@@ -8016,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;
     };
@@ -8049,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;
@@ -8307,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;
     };
@@ -8408,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;
     };
@@ -8441,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;
@@ -10929,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;
     };
@@ -10999,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;
     };
@@ -11032,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;
@@ -12777,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'];
@@ -12823,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'];
@@ -13086,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'];
@@ -13275,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
    *
@@ -13283,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) {
@@ -13295,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
    *   }
@@ -13320,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" }
    * );
@@ -13341,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
    *   }
@@ -13354,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",
@@ -13376,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>>;

package/dist/index.iife.js

@@ -1501,7 +1501,7 @@ Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toString
 		/**
 		* 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
 		*
@@ -1509,7 +1509,7 @@ Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toString
 		* ```typescript
 		* // Get product by ID
 		* const { data, error } = await sdk.catalog.getProductDetail(
-		*   { product_id_or_slug: "prod_123" }
+		*   { product_id: "prod_123" }
 		* );
 		*
 		* if (error) {
@@ -1521,14 +1521,15 @@ Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toString
 		* 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
 		*   }
@@ -1544,7 +1545,7 @@ Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toString
 		*/
 		async getProductDetail(pathParams, options, headers) {
 			const mergedHeaders = this.mergeHeaders(headers);
-			return this.executeRequest(() => this.client.GET("/catalog/products/{product_id_or_slug}", { params: {
+			return this.executeRequest(() => this.client.GET("/catalog/products/{product_id}", { params: {
 				path: pathParams,
 				query: options,
 				header: mergedHeaders
@@ -1553,12 +1554,13 @@ Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toString
 		/**
 		* 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" }
 		* );
@@ -1574,9 +1576,15 @@ Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toString
 		*   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
 		*   }
@@ -1594,12 +1602,13 @@ Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toString
 		/**
 		* 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",
@@ -1616,6 +1625,14 @@ Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toString
 		* 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"
+		*   }
+		* );
 		* ```
 		*/
 		async getVariantDetail(pathParams, options, headers) {