@commercengine/pos 0.4.2 → 0.4.3

package/dist/index.d.mts

@@ -570,7 +570,7 @@ interface paths {
     patch?: never;
     trace?: never;
   };
-  "/pos/catalog/products/{product_id_or_slug}": {
+  "/pos/catalog/products/{product_id}": {
     parameters: {
       query?: never;
       header?: never;
@@ -579,7 +579,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;
@@ -619,7 +619,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;
@@ -639,7 +639,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;
@@ -1576,7 +1576,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;
       /**
@@ -1590,7 +1591,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;
@@ -2209,17 +2211,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[];
     }; /** SellerInfo */
     SellerInfo: {
       id: string;
@@ -2229,7 +2269,6 @@ interface components {
       tax_identification_number: string;
     }; /** Seo */
     Seo: {
-      slug: string;
       title: string | null;
       description: string | null;
       keywords: string[] | null;
@@ -3557,7 +3596,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;
     };
@@ -3627,7 +3666,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;
     };
@@ -3660,7 +3699,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;
@@ -6711,11 +6750,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'];
@@ -7695,16 +7734,12 @@ declare class PosClient extends PosAPIClient {
    * Search products
    * @param body - Search criteria and parameters
    * @param headers - Optional header parameters
-   * @returns Promise with search results
+   * @returns Promise with search results including SKUs, facet distribution, facet stats, and pagination
    * @example
    * ```typescript
+   * // Basic search
    * const { data, error } = await pos.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
    * });
@@ -7714,17 +7749,52 @@ declare class PosClient extends PosAPIClient {
    * } else {
    *   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.name} - ${sku.price}`);
+   *     console.log(`Found: ${sku.product_name} - ${sku.pricing?.selling_price}`);
    *   });
    * }
    *
+   * // With filter (string expression — Meilisearch syntax)
+   * const { data: filtered, error: filteredError } = await pos.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 pos.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 pos.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 pos.searchProducts(
    *   {
    *     query: "laptop",
-   *     filters: { category: ["computers"] }
+   *     filter: "categories.name = computers",
+   *     page: 1,
+   *     limit: 20
    *   },
    *   {
    *     "x-customer-group-id": "01H9XYZ12345USERID" // Override default SDK config
@@ -7823,32 +7893,33 @@ declare class PosClient extends PosAPIClient {
   listUpsellProducts(query: PosListUpsellProductsQuery, headers?: PosListUpsellProductsHeaderParams): Promise<ApiResult<PosListUpsellProductsContent>>;
   /**
    * Get product details
-   * @param pathParams - Product ID or slug
+   * @param pathParams - The path parameters. Accepts product ID or product slug.
    * @param headers - Optional header parameters
    * @returns Promise with product details
    * @example
    * ```typescript
    * // Get product by ID
    * const { data, error } = await pos.getProductDetail(
-   *   { product_id_or_slug: "prod_123" }
+   *   { product_id: "prod_123" }
    * );
    *
    * if (error) {
    *   console.error("Failed to get product details:", error.message);
    * } else {
    *   console.log("Product:", data.product.name);
-   *   console.log("Price:", data.product.price);
-   *   console.log("Description:", data.product.description);
+   *   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 pos.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 pos.getProductDetail(
-   *   { product_id_or_slug: "detox-candy" },
+   *   { product_id: "detox-candy" },
+   *   undefined,
    *   {
    *     "x-customer-group-id": "premium_customers" // Override default SDK config
    *   }
@@ -7890,11 +7961,12 @@ declare class PosClient extends PosAPIClient {
   listProductReviews(pathParams: PosListProductReviewsPathParams, query?: PosListProductReviewsQuery): Promise<ApiResult<PosListProductReviewsContent>>;
   /**
    * List product variants
-   * @param pathParams - Product ID
+   * @param pathParams - The path parameters. Accepts product ID or product slug.
    * @param headers - Optional header parameters
    * @returns Promise with product variants
    * @example
    * ```typescript
+   * // By product ID
    * const { data, error } = await pos.listProductVariants(
    *   { product_id: "prod_123" }
    * );
@@ -7904,13 +7976,19 @@ declare class PosClient extends PosAPIClient {
    * } else {
    *   console.log("Variants found:", data.variants?.length || 0);
    *   data.variants?.forEach(variant => {
-   *     console.log(`Variant: ${variant.name} - SKU: ${variant.sku} - Price: ${variant.price}`);
+   *     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 pos.listProductVariants(
+   *   { product_id: "detox-candy" }
+   * );
+   *
    * // Override customer group ID for this specific request
    * const { data: overrideData, error: overrideError } = await pos.listProductVariants(
    *   { product_id: "prod_123" },
+   *   undefined,
    *   {
    *     "x-customer-group-id": "wholesale_customers" // Override default SDK config
    *   }
@@ -7920,11 +7998,12 @@ declare class PosClient extends PosAPIClient {
   listProductVariants(pathParams: PosListProductVariantsPathParams, query?: PosListProductVariantsQuery, headers?: PosListProductVariantsHeaderParams): Promise<ApiResult<PosListProductVariantsContent>>;
   /**
    * Get variant details
-   * @param pathParams - 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
    * @returns Promise with variant details
    * @example
    * ```typescript
+   * // By product ID and variant ID
    * const { data, error } = await pos.getVariantDetail(
    *   {
    *     product_id: "prod_123",
@@ -7937,16 +8016,25 @@ declare class PosClient extends PosAPIClient {
    * } else {
    *   console.log("Variant:", data.variant.name);
    *   console.log("SKU:", data.variant.sku);
-   *   console.log("Price:", data.variant.price);
-   *   console.log("Stock:", data.variant.stock);
+   *   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 pos.getVariantDetail(
+   *   {
+   *     product_id: "detox-candy",
+   *     variant_id: "detox-candy-100g"
+   *   }
+   * );
+   *
    * // Override customer group ID for this specific request
    * const { data: overrideData, error: overrideError } = await pos.getVariantDetail(
    *   {
    *     product_id: "prod_123",
    *     variant_id: "var_456"
    *   },
+   *   undefined,
    *   {
    *     "x-customer-group-id": "wholesale_customers" // Override default SDK config
    *   }

package/dist/index.mjs

@@ -2001,16 +2001,12 @@ var PosClient = class extends PosAPIClient {
 	* Search products
 	* @param body - Search criteria and parameters
 	* @param headers - Optional header parameters
-	* @returns Promise with search results
+	* @returns Promise with search results including SKUs, facet distribution, facet stats, and pagination
 	* @example
 	* ```typescript
+	* // Basic search
 	* const { data, error } = await pos.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
 	* });
@@ -2020,17 +2016,52 @@ var PosClient = class extends PosAPIClient {
 	* } else {
 	*   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.name} - ${sku.price}`);
+	*     console.log(`Found: ${sku.product_name} - ${sku.pricing?.selling_price}`);
 	*   });
 	* }
 	*
+	* // With filter (string expression — Meilisearch syntax)
+	* const { data: filtered, error: filteredError } = await pos.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 pos.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 pos.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 pos.searchProducts(
 	*   {
 	*     query: "laptop",
-	*     filters: { category: ["computers"] }
+	*     filter: "categories.name = computers",
+	*     page: 1,
+	*     limit: 20
 	*   },
 	*   {
 	*     "x-customer-group-id": "01H9XYZ12345USERID" // Override default SDK config
@@ -2147,32 +2178,33 @@ var PosClient = class extends PosAPIClient {
 	}
 	/**
 	* Get product details
-	* @param pathParams - Product ID or slug
+	* @param pathParams - The path parameters. Accepts product ID or product slug.
 	* @param headers - Optional header parameters
 	* @returns Promise with product details
 	* @example
 	* ```typescript
 	* // Get product by ID
 	* const { data, error } = await pos.getProductDetail(
-	*   { product_id_or_slug: "prod_123" }
+	*   { product_id: "prod_123" }
 	* );
 	*
 	* if (error) {
 	*   console.error("Failed to get product details:", error.message);
 	* } else {
 	*   console.log("Product:", data.product.name);
-	*   console.log("Price:", data.product.price);
-	*   console.log("Description:", data.product.description);
+	*   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 pos.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 pos.getProductDetail(
-	*   { product_id_or_slug: "detox-candy" },
+	*   { product_id: "detox-candy" },
+	*   undefined,
 	*   {
 	*     "x-customer-group-id": "premium_customers" // Override default SDK config
 	*   }
@@ -2181,7 +2213,7 @@ var PosClient = class extends PosAPIClient {
 	*/
 	async getProductDetail(pathParams, query, headers) {
 		const mergedHeaders = this.mergeHeaders(headers);
-		return this.executeRequest(() => this.client.GET("/pos/catalog/products/{product_id_or_slug}", { params: {
+		return this.executeRequest(() => this.client.GET("/pos/catalog/products/{product_id}", { params: {
 			path: pathParams,
 			query,
 			header: mergedHeaders
@@ -2226,11 +2258,12 @@ var PosClient = class extends PosAPIClient {
 	}
 	/**
 	* List product variants
-	* @param pathParams - Product ID
+	* @param pathParams - The path parameters. Accepts product ID or product slug.
 	* @param headers - Optional header parameters
 	* @returns Promise with product variants
 	* @example
 	* ```typescript
+	* // By product ID
 	* const { data, error } = await pos.listProductVariants(
 	*   { product_id: "prod_123" }
 	* );
@@ -2240,13 +2273,19 @@ var PosClient = class extends PosAPIClient {
 	* } else {
 	*   console.log("Variants found:", data.variants?.length || 0);
 	*   data.variants?.forEach(variant => {
-	*     console.log(`Variant: ${variant.name} - SKU: ${variant.sku} - Price: ${variant.price}`);
+	*     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 pos.listProductVariants(
+	*   { product_id: "detox-candy" }
+	* );
+	*
 	* // Override customer group ID for this specific request
 	* const { data: overrideData, error: overrideError } = await pos.listProductVariants(
 	*   { product_id: "prod_123" },
+	*   undefined,
 	*   {
 	*     "x-customer-group-id": "wholesale_customers" // Override default SDK config
 	*   }
@@ -2263,11 +2302,12 @@ var PosClient = class extends PosAPIClient {
 	}
 	/**
 	* Get variant details
-	* @param pathParams - 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
 	* @returns Promise with variant details
 	* @example
 	* ```typescript
+	* // By product ID and variant ID
 	* const { data, error } = await pos.getVariantDetail(
 	*   {
 	*     product_id: "prod_123",
@@ -2280,16 +2320,25 @@ var PosClient = class extends PosAPIClient {
 	* } else {
 	*   console.log("Variant:", data.variant.name);
 	*   console.log("SKU:", data.variant.sku);
-	*   console.log("Price:", data.variant.price);
-	*   console.log("Stock:", data.variant.stock);
+	*   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 pos.getVariantDetail(
+	*   {
+	*     product_id: "detox-candy",
+	*     variant_id: "detox-candy-100g"
+	*   }
+	* );
+	*
 	* // Override customer group ID for this specific request
 	* const { data: overrideData, error: overrideError } = await pos.getVariantDetail(
 	*   {
 	*     product_id: "prod_123",
 	*     variant_id: "var_456"
 	*   },
+	*   undefined,
 	*   {
 	*     "x-customer-group-id": "wholesale_customers" // Override default SDK config
 	*   }