@djust-b2b/djust-front-sdk 2.1.0 → 2.2.0

package/lib/services/offer-prices/__mocks__/offer-prices.mocks.js

@@ -0,0 +1,200 @@
+"use strict";
+/**
+ * Mocks centralisés pour les tests du module offer-prices
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mockHttpErrors = exports.mockErrors = exports.mockResponses = exports.mockOrder = exports.mockPageableObject = exports.mockParameters = exports.mockOfferPrices = exports.mockPriceRanges = exports.mockProductPrices = void 0;
+// Mock data pour les prix de produits
+exports.mockProductPrices = {
+    standard: {
+        itemPrice: 10.5,
+        unitPrice: 2.1,
+        itemPriceTTC: 12.6,
+        unitPriceTTC: 2.52,
+    },
+    discounted: {
+        itemPrice: 8.4,
+        unitPrice: 1.68,
+        itemPriceTTC: 10.08,
+        unitPriceTTC: 2.02,
+    },
+};
+// Mock data pour les gammes de prix
+exports.mockPriceRanges = {
+    single: [
+        {
+            quantity: 1,
+            price: exports.mockProductPrices.standard,
+            discountPrice: exports.mockProductPrices.standard,
+        },
+    ],
+    multiple: [
+        {
+            quantity: 1,
+            price: exports.mockProductPrices.standard,
+            discountPrice: exports.mockProductPrices.standard,
+        },
+        {
+            quantity: 10,
+            price: exports.mockProductPrices.standard,
+            discountPrice: exports.mockProductPrices.discounted,
+        },
+        {
+            quantity: 50,
+            price: exports.mockProductPrices.standard,
+            discountPrice: {
+                itemPrice: 7.35,
+                unitPrice: 1.47,
+                itemPriceTTC: 8.82,
+                unitPriceTTC: 1.76,
+            },
+        },
+    ],
+};
+// Mock data pour les prix d'offres
+exports.mockOfferPrices = [
+    {
+        id: "offer_price_1",
+        externalId: "ext_offer_price_1",
+        type: "PUBLIC",
+        itemPerPack: 5,
+        customerAccountExternalId: "",
+        customerTagExternalId: "",
+        priceRanges: exports.mockPriceRanges.single,
+    },
+    {
+        id: "offer_price_2",
+        externalId: "ext_offer_price_2",
+        type: "GROUP",
+        itemPerPack: 10,
+        customerAccountExternalId: "",
+        customerTagExternalId: "tag_123",
+        priceRanges: exports.mockPriceRanges.multiple,
+    },
+    {
+        id: "offer_price_3",
+        externalId: "ext_offer_price_3",
+        type: "ACCOUNT",
+        itemPerPack: 1,
+        customerAccountExternalId: "account_456",
+        customerTagExternalId: "",
+        priceRanges: exports.mockPriceRanges.single,
+    },
+];
+// Mock data pour les paramètres de test
+exports.mockParameters = {
+    getPaginatedOfferPrices: {
+        valid: {
+            offerInventoryExternalId: "inventory_123",
+        },
+        withPagination: {
+            offerInventoryExternalId: "inventory_123",
+            page: 0,
+            size: 20,
+        },
+        withSorting: {
+            offerInventoryExternalId: "inventory_123",
+            page: 1,
+            size: 10,
+            sort: "createdAt,desc",
+        },
+        missingRequired: {
+            page: 0,
+            size: 20,
+        },
+    },
+};
+// Mock data pour les objets de pagination
+exports.mockPageableObject = {
+    offset: 0,
+    pageNumber: 0,
+    pageSize: 20,
+    paged: true,
+    sort: [],
+    unpaged: false,
+};
+exports.mockOrder = {
+    ascending: false,
+    descending: true,
+    direction: "DESC",
+    ignoreCase: false,
+    nullHandling: "NATIVE",
+    property: "createdAt",
+};
+// Mock Headers pour les tests
+function createMockHeaders() {
+    const headers = new Headers();
+    headers.append("Content-Type", "application/json");
+    headers.append("dj-client", "test-client");
+    headers.append("dj-api-key", "test-api-key");
+    return headers;
+}
+// Mock data pour les réponses d'API
+exports.mockResponses = {
+    getPaginatedOfferPrices: {
+        success: {
+            data: {
+                content: exports.mockOfferPrices,
+                empty: false,
+                first: true,
+                last: false,
+                number: 0,
+                numberOfElements: 3,
+                pageable: exports.mockPageableObject,
+                size: 20,
+                sort: [exports.mockOrder],
+                totalElements: 15,
+            },
+            headers: createMockHeaders(),
+            status: 200,
+        },
+        empty: {
+            data: {
+                content: [],
+                empty: true,
+                first: true,
+                last: true,
+                number: 0,
+                numberOfElements: 0,
+                pageable: exports.mockPageableObject,
+                size: 20,
+                sort: [],
+                totalElements: 0,
+            },
+            headers: createMockHeaders(),
+            status: 200,
+        },
+        singleItem: {
+            data: {
+                content: [exports.mockOfferPrices[0]],
+                empty: false,
+                first: true,
+                last: true,
+                number: 0,
+                numberOfElements: 1,
+                pageable: exports.mockPageableObject,
+                size: 20,
+                sort: [],
+                totalElements: 1,
+            },
+            headers: createMockHeaders(),
+            status: 200,
+        },
+    },
+};
+// Mock data pour les erreurs
+exports.mockErrors = {
+    networkError: new Error("Network error"),
+    unauthorized: new Error("Unauthorized"),
+    badRequest: new Error("Bad request"),
+    notFound: new Error("Not found"),
+    serverError: new Error("Internal server error"),
+    missingParameter: new Error("Missing required parameter: offerInventoryExternalId"),
+};
+// Mock data pour les cas d'erreur HTTP
+exports.mockHttpErrors = {
+    400: { status: 400, message: "Bad Request" },
+    401: { status: 401, message: "Unauthorized" },
+    404: { status: 404, message: "Not Found" },
+    500: { status: 500, message: "Internal Server Error" },
+};

package/lib/services/offer-prices/definitions.d.ts

@@ -0,0 +1,23 @@
+import { Order, PageableObject } from "../../interfaces/models/common";
+import { OfferPrice } from "../../interfaces/models/offer";
+/**
+ * Requests parameters type definitions
+ */
+export interface GetPaginatedOfferPricesParameters {
+    page?: number;
+    size?: number;
+    sort?: string;
+    offerInventoryExternalId?: string;
+}
+export interface GetOfferPricesResponse {
+    content: OfferPrice[];
+    empty: boolean;
+    first: boolean;
+    last: boolean;
+    number: number;
+    numberOfElements: number;
+    pageable: PageableObject;
+    size: number;
+    sort: Order[];
+    totalElements: number;
+}

package/lib/services/offer-prices/index.d.ts

@@ -0,0 +1,35 @@
+import { GetPaginatedOfferPricesParameters, GetOfferPricesResponse } from "./definitions";
+/**
+ * 📄 Gets paginated offer prices.
+ *
+ * This function retrieves paginated offer prices with filtering by offer inventory external ID.
+ * The `offerInventoryExternalId` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/offer-prices` [OFFER-PRICE-550]
+ *
+ * | Parameter           | Type     | Required | Description                                    |
+ * |---------------------|----------|----------|------------------------------------------------|
+ * | `page`              | `number` | ❌       | The page number to fetch (0-based index).     |
+ * | `size`              | `number` | ❌       | The number of items per page.                 |
+ * | `sort`              | `string` | ❌       | The sort to apply to the results.             |
+ * | `offerInventoryExternalId`| `string` | ✅ | The external ID of the offer inventory.       |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a `GetOfferPricesResponse` containing the paginated offer prices.
+ *
+ * 🛠 **Example usage**:
+ * ```typescript
+ * const prices = await getPaginatedOfferPrices({
+ *   offerInventoryExternalId: "offer123",
+ *   page: 0,
+ *   size: 20,
+ *   sort: "createdAt,desc",
+ * });
+ * console.log(prices);
+ * ```
+ *
+ * @param {GetPaginatedOfferPricesParameters} params - The parameters for the request
+ * @throws {Error} If `offerInventoryExternalId` is missing
+ * @returns {Promise<GetOfferPricesResponse>} A promise resolving to the response containing the paginated offer prices
+ */
+export declare function getPaginatedOfferPrices({ page, size, sort, offerInventoryExternalId, }: GetPaginatedOfferPricesParameters): Promise<GetOfferPricesResponse>;

package/lib/services/offer-prices/index.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPaginatedOfferPrices = getPaginatedOfferPrices;
+const parameters_validation_1 = require("../../helpers/parameters-validation");
+const fetch_instance_1 = require("../../settings/fetch-instance");
+/**
+ * 📄 Gets paginated offer prices.
+ *
+ * This function retrieves paginated offer prices with filtering by offer inventory external ID.
+ * The `offerInventoryExternalId` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/offer-prices` [OFFER-PRICE-550]
+ *
+ * | Parameter           | Type     | Required | Description                                    |
+ * |---------------------|----------|----------|------------------------------------------------|
+ * | `page`              | `number` | ❌       | The page number to fetch (0-based index).     |
+ * | `size`              | `number` | ❌       | The number of items per page.                 |
+ * | `sort`              | `string` | ❌       | The sort to apply to the results.             |
+ * | `offerInventoryExternalId`| `string` | ✅ | The external ID of the offer inventory.       |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a `GetOfferPricesResponse` containing the paginated offer prices.
+ *
+ * 🛠 **Example usage**:
+ * ```typescript
+ * const prices = await getPaginatedOfferPrices({
+ *   offerInventoryExternalId: "offer123",
+ *   page: 0,
+ *   size: 20,
+ *   sort: "createdAt,desc",
+ * });
+ * console.log(prices);
+ * ```
+ *
+ * @param {GetPaginatedOfferPricesParameters} params - The parameters for the request
+ * @throws {Error} If `offerInventoryExternalId` is missing
+ * @returns {Promise<GetOfferPricesResponse>} A promise resolving to the response containing the paginated offer prices
+ */
+async function getPaginatedOfferPrices({ page, size, sort, offerInventoryExternalId, }) {
+    (0, parameters_validation_1.required)({ offerInventoryExternalId });
+    const { data } = await (0, fetch_instance_1.enhancedFetch)({
+        method: "GET",
+        path: `/v1/shop/offer-prices`,
+        params: {
+            offerInventoryExternalId,
+            page,
+            size,
+            sort,
+        },
+    });
+    return data;
+}

package/lib/services/payment/index.js

@@ -155,7 +155,7 @@ async function getPaymentMethods({ reference, countryCode, referenceType, locale
     (0, parameters_validation_1.required)({ reference });
     const { data } = await (0, fetch_instance_1.enhancedFetch)({
         method: "GET",
-        path: `/v1/shop/payments/methods`,
+        path: `/v1/shop/payments/payments-methods`,
         params: {
             reference,
             countryCode,

package/lib/services/product/definitions.d.ts

@@ -36,6 +36,9 @@ export interface GetProductsListParameters {
         customFields?: string[];
         offerUpdatedTime?: string;
         productUpdatedTime?: string;
+        withFacets?: string;
+        priceMin?: number;
+        priceMax?: number;
     };
     pageable?: PageableParameters;
 }
@@ -57,6 +60,7 @@ export interface GetProductOffersParameters {
     productIdType: string;
     locale?: string;
     currency?: string;
+    withoutPrice?: boolean;
 }
 export interface GetProductVariantsListParameters {
     productSku: string;
@@ -83,6 +87,7 @@ export interface GetProductVariantOffersParameters {
     productIdentifier: string;
     productIdType: string;
     currency?: string;
+    withoutPrice?: boolean;
 }
 export interface GetRelatedProductsParameters {
     productIdentifier: string;

package/lib/services/product/index.d.ts

@@ -1,4 +1,4 @@
-import { CreateProductReviewParameters, CreateProductReviewResponse, GetProductOffersParameters, GetProductOffersResponse, GetProductParameters, GetProductReviewsParameters, GetProductReviewsResponse, GetProductStatReviewsParameters, GetProductStatReviewsResponse, GetProductVariantAttributesParameters, GetProductVariantAttributesResponse, GetProductVariantOffersParameters, GetProductVariantOffersResponse, GetProductVariantSuppliersParameters, GetProductVariantSuppliersResponse, GetProductVariantsListParameters, GetProductVariantsListResponse, GetProductsListParameters, GetProductsListResponse, GetRelatedProductsParameters, AutoCompleteSearchProductsParameters, SearchProductsResponse, UpdateProductReviewParameters, UpdateProductReviewResponse, GetProductPaginatedOffersParameters, GetProductPaginatedOffersResponse, GetRelatedProductsResponse } from "./definitions";
+import { CreateProductReviewParameters, CreateProductReviewResponse, GetProductOffersParameters, GetProductOffersResponse, GetProductParameters, GetProductReviewsParameters, GetProductReviewsResponse, GetProductStatReviewsParameters, GetProductStatReviewsResponse, GetProductVariantAttributesParameters, GetProductVariantAttributesResponse, GetProductVariantOffersParameters, GetProductVariantOffersResponse, GetProductVariantSuppliersParameters, GetProductVariantSuppliersResponse, GetProductsListParameters, GetProductsListResponse, GetRelatedProductsParameters, AutoCompleteSearchProductsParameters, SearchProductsResponse, UpdateProductReviewParameters, UpdateProductReviewResponse, GetProductPaginatedOffersParameters, GetProductPaginatedOffersResponse, GetRelatedProductsResponse } from "./definitions";
 /**
  * 📄 Search products with a text expression for search and autocomplete.
  *
@@ -57,32 +57,6 @@ export declare function autoCompleteSearchProducts({ input, locale, currency, pa
  * ```
  */
 export declare function getProductsList({ locale, filters, pageable, }: GetProductsListParameters): Promise<GetProductsListResponse>;
-/**
- * 📄 Fetches product variants by product SKU.
- *
- * 🛠 **Endpoint**: `GET /v1/shop/product-variants`
- *
- * | Parameter       | Type         | Required | Description                                |
- * |-----------------|--------------|----------|--------------------------------------------|
- * | `productSku`    | `string`     | ✅       | The SKU of the product.                   |
- * | `locale`        | `string`     | ❌       | The locale for product variants.          |
- * | `pageable.page` | `number`     | ❌       | The page number to fetch (0-based index). |
- * | `pageable.size` | `number`     | ❌       | The number of items per page.             |
- *
- * 📤 **Returns**:
- * A `Promise` resolving to a `GetProductVariantsListResponse` containing the product variants.
- *
- * 🛠 **Example usage**:
- * ```typescript
- * const variants = await getProductVariantsList({
- *   productSku: 'sku123',
- *   locale: 'en-US',
- *   pageable: { page: 0, size: 10 },
- * });
- * console.log(variants);
- * ```
- */
-export declare function getProductVariantsList({ productSku, locale, pageable, }: GetProductVariantsListParameters): Promise<GetProductVariantsListResponse>;
 /**
  * 📄 Fetches offers for a specific product variant.
  *
@@ -132,7 +106,7 @@ export declare function getProductVariantsList({ productSku, locale, pageable, }
  * }
  * ```
  */
-export declare function getProductVariantOffers({ productIdentifier, productIdType, currency, }: GetProductVariantOffersParameters): Promise<GetProductVariantOffersResponse>;
+export declare function getProductVariantOffers({ productIdentifier, productIdType, currency, withoutPrice, }: GetProductVariantOffersParameters): Promise<GetProductVariantOffersResponse>;
 /**
  * 📄 Fetches suppliers associated with a product variant.
  *
@@ -186,6 +160,8 @@ export declare function getProductVariantSuppliers({ productVariantId, }: GetPro
  */
 export declare function getProduct({ productIdentifier, productIdType, locale, }: GetProductParameters): Promise<GetProductsListResponse>;
 /**
+ * @deprecated
+ *
  * 📄 Fetches product offers by SKU, ID, or external ID.
  *
  * 🛠 **Endpoint**: `GET /v1/shop/products/{productIdentifier}/offers`
@@ -208,8 +184,9 @@ export declare function getProduct({ productIdentifier, productIdType, locale, }
  * });
  * console.log(offers);
  * ```
+ * SWAGGER [PRODUCT-502]
  */
-export declare function getProductOffers({ productIdentifier, productIdType, locale, currency, }: GetProductOffersParameters): Promise<GetProductOffersResponse>;
+export declare function getProductOffers({ productIdentifier, productIdType, locale, currency, withoutPrice, }: GetProductOffersParameters): Promise<GetProductOffersResponse>;
 /**
  * 📄 Fetches related products for a specific product.
  *

package/lib/services/product/index.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.autoCompleteSearchProducts = autoCompleteSearchProducts;
 exports.getProductsList = getProductsList;
-exports.getProductVariantsList = getProductVariantsList;
 exports.getProductVariantOffers = getProductVariantOffers;
 exports.getProductVariantSuppliers = getProductVariantSuppliers;
 exports.getProduct = getProduct;
@@ -60,6 +59,7 @@ async function autoCompleteSearchProducts({ input, locale, currency, pageable, a
             productTags,
             page: pageable === null || pageable === void 0 ? void 0 : pageable.page,
             size: pageable === null || pageable === void 0 ? void 0 : pageable.size,
+            sort: pageable === null || pageable === void 0 ? void 0 : pageable.sort,
         },
     });
     return data;
@@ -104,45 +104,6 @@ async function getProductsList({ locale, filters, pageable, }) {
     });
     return data;
 }
-/**
- * 📄 Fetches product variants by product SKU.
- *
- * 🛠 **Endpoint**: `GET /v1/shop/product-variants`
- *
- * | Parameter       | Type         | Required | Description                                |
- * |-----------------|--------------|----------|--------------------------------------------|
- * | `productSku`    | `string`     | ✅       | The SKU of the product.                   |
- * | `locale`        | `string`     | ❌       | The locale for product variants.          |
- * | `pageable.page` | `number`     | ❌       | The page number to fetch (0-based index). |
- * | `pageable.size` | `number`     | ❌       | The number of items per page.             |
- *
- * 📤 **Returns**:
- * A `Promise` resolving to a `GetProductVariantsListResponse` containing the product variants.
- *
- * 🛠 **Example usage**:
- * ```typescript
- * const variants = await getProductVariantsList({
- *   productSku: 'sku123',
- *   locale: 'en-US',
- *   pageable: { page: 0, size: 10 },
- * });
- * console.log(variants);
- * ```
- */
-async function getProductVariantsList({ productSku, locale, pageable, }) {
-    (0, parameters_validation_1.required)({ productSku });
-    const { data } = await (0, fetch_instance_1.enhancedFetch)({
-        method: "GET",
-        path: `/v1/shop/product-variants`,
-        params: {
-            productSku,
-            locale,
-            page: pageable === null || pageable === void 0 ? void 0 : pageable.page,
-            size: pageable === null || pageable === void 0 ? void 0 : pageable.size,
-        },
-    });
-    return data;
-}
 /**
  * 📄 Fetches offers for a specific product variant.
  *
@@ -192,7 +153,7 @@ async function getProductVariantsList({ productSku, locale, pageable, }) {
  * }
  * ```
  */
-async function getProductVariantOffers({ productIdentifier, productIdType, currency, }) {
+async function getProductVariantOffers({ productIdentifier, productIdType, currency, withoutPrice, }) {
     (0, parameters_validation_1.required)({ productIdentifier, productIdType });
     const { data } = await (0, fetch_instance_1.enhancedFetch)({
         method: "GET",
@@ -200,6 +161,7 @@ async function getProductVariantOffers({ productIdentifier, productIdType, curre
         params: {
             productIdType,
             currency,
+            withoutPrice,
         },
     });
     return data;
@@ -275,6 +237,8 @@ async function getProduct({ productIdentifier, productIdType, locale, }) {
     return data;
 }
 /**
+ * @deprecated
+ *
  * 📄 Fetches product offers by SKU, ID, or external ID.
  *
  * 🛠 **Endpoint**: `GET /v1/shop/products/{productIdentifier}/offers`
@@ -297,8 +261,9 @@ async function getProduct({ productIdentifier, productIdType, locale, }) {
  * });
  * console.log(offers);
  * ```
+ * SWAGGER [PRODUCT-502]
  */
-async function getProductOffers({ productIdentifier, productIdType, locale, currency, }) {
+async function getProductOffers({ productIdentifier, productIdType, locale, currency, withoutPrice, }) {
     (0, parameters_validation_1.required)({ productIdentifier, productIdType });
     const { data } = await (0, fetch_instance_1.enhancedFetch)({
         method: "GET",
@@ -307,6 +272,7 @@ async function getProductOffers({ productIdentifier, productIdType, locale, curr
             productIdType,
             locale,
             currency,
+            withoutPrice,
         },
     });
     return data;

package/lib/services/product-variant/definitions.d.ts

@@ -141,4 +141,31 @@ export interface GetProductPaginatedOffersResponse {
     totalElements: number;
     totalPages: number;
 }
+export interface GetProductVariantParameters {
+    productVariantId: string;
+    locale?: string;
+}
+export interface ProductVariantPictureUrl {
+    formatType: string;
+    heightInPx: number;
+    sizeType: string;
+    url: string;
+    widthInPx: number;
+}
+export interface ProductVariantPicture {
+    isMain: boolean;
+    urls: ProductVariantPictureUrl[];
+}
+export interface GetProductVariantResponse {
+    description: string;
+    ean: string;
+    externalId: string;
+    id: string;
+    name: string;
+    productExternalId: string;
+    skuProduct: string;
+    skuVariant: string;
+    status: string;
+    variantPictures: ProductVariantPicture[];
+}
 export {};

package/lib/services/product-variant/index.d.ts

@@ -1,4 +1,4 @@
-import { GetProductVariantAttributesParameters, GetProductVariantAttributesResponse, GetProductVariantSuppliersParameters, GetProductVariantSuppliersResponse, GetProductVariantsListParameters, GetProductVariantsListResponse } from "./definitions";
+import { GetProductVariantAttributesParameters, GetProductVariantAttributesResponse, GetProductVariantParameters, GetProductVariantResponse, GetProductVariantSuppliersParameters, GetProductVariantSuppliersResponse, GetProductVariantsListParameters, GetProductVariantsListResponse } from "./definitions";
 /**
  * 📄 Fetches a paginated list of product variants.
  *
@@ -91,3 +91,32 @@ export declare function getProductVariantSuppliers({ productVariantId, }: GetPro
  * @returns {Promise<GetProductVariantAttributesResponse>} A promise resolving to the product variant attributes response.
  */
 export declare function getProductVariantAttributes({ productIdentifier, productIdType, locale, }: GetProductVariantAttributesParameters): Promise<GetProductVariantAttributesResponse>;
+/**
+ * 📄 Fetches details of a specific product variant.
+ *
+ * This function retrieves detailed information about a product variant identified by its ID.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/product-variants/{productVariantId}`
+ *
+ * | Parameter           | Type         | Required | Description                                     |
+ * |---------------------|--------------|----------|-------------------------------------------------|
+ * | `productVariantId`  | `string`     | ✅       | The ID of the product variant to fetch.         |
+ * | `locale`            | `string`     | ❌       | The locale for localized data (e.g., `en-US`).  |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a `GetProductVariantResponse` object, containing the product variant details.
+ *
+ * 🛠 **Example usage**:
+ * ```typescript
+ * const variant = await getProductVariant({
+ *   productVariantId: 'variant123',
+ *   locale: 'fr-FR',
+ * });
+ * console.log(variant);
+ * ```
+ *
+ * @param {GetProductVariantParameters} params - The parameters for fetching the product variant.
+ * @throws {Error} If `productVariantId` is missing.
+ * @returns {Promise<GetProductVariantResponse>} A promise resolving to the product variant response.
+ */
+export declare function getProductVariant({ productVariantId, locale, }: GetProductVariantParameters): Promise<GetProductVariantResponse>;

package/lib/services/product-variant/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getProductVariantsList = getProductVariantsList;
 exports.getProductVariantSuppliers = getProductVariantSuppliers;
 exports.getProductVariantAttributes = getProductVariantAttributes;
+exports.getProductVariant = getProductVariant;
 const parameters_validation_1 = require("../../helpers/parameters-validation");
 const fetch_instance_1 = require("../../settings/fetch-instance");
 /**
@@ -129,3 +130,42 @@ async function getProductVariantAttributes({ productIdentifier, productIdType, l
     });
     return data;
 }
+/**
+ * 📄 Fetches details of a specific product variant.
+ *
+ * This function retrieves detailed information about a product variant identified by its ID.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/product-variants/{productVariantId}`
+ *
+ * | Parameter           | Type         | Required | Description                                     |
+ * |---------------------|--------------|----------|-------------------------------------------------|
+ * | `productVariantId`  | `string`     | ✅       | The ID of the product variant to fetch.         |
+ * | `locale`            | `string`     | ❌       | The locale for localized data (e.g., `en-US`).  |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a `GetProductVariantResponse` object, containing the product variant details.
+ *
+ * 🛠 **Example usage**:
+ * ```typescript
+ * const variant = await getProductVariant({
+ *   productVariantId: 'variant123',
+ *   locale: 'fr-FR',
+ * });
+ * console.log(variant);
+ * ```
+ *
+ * @param {GetProductVariantParameters} params - The parameters for fetching the product variant.
+ * @throws {Error} If `productVariantId` is missing.
+ * @returns {Promise<GetProductVariantResponse>} A promise resolving to the product variant response.
+ */
+async function getProductVariant({ productVariantId, locale, }) {
+    (0, parameters_validation_1.required)({ productVariantId });
+    const { data } = await (0, fetch_instance_1.enhancedFetch)({
+        method: "GET",
+        path: `/v1/shop/product-variants/${productVariantId}`,
+        params: {
+            locale,
+        },
+    });
+    return data;
+}