@djust-b2b/djust-front-sdk 2.0.0 → 2.1.1

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

@@ -0,0 +1,61 @@
+import { BrowserInfo } from "../../interfaces/models/common";
+import { PaymentReferenceType } from "../../interfaces/models/payment";
+/**
+ * Request parameters type definitions
+ */
+export interface GetCommercialOrdersParameters {
+    locale: string;
+    nbPreviewLines?: number;
+    page?: number;
+    size?: number;
+    sort?: string[];
+    connectedUserOnly?: boolean;
+    customerAccountIds?: string[];
+    isValidated?: boolean;
+}
+export interface InitPaymentRequest {
+    bankTransfer?: boolean;
+    browserInfo: BrowserInfo;
+    commercialOrder?: boolean;
+    countryCode: string;
+    customerUserIP: string;
+    paymentMethodData: object;
+    reference: string;
+    referenceType?: PaymentReferenceType;
+    returnPath: string;
+    storePaymentMethod?: boolean;
+}
+export interface InitPaymentResponse {
+    action: {
+        type: string;
+        beneficiary: string;
+        bic: string;
+        iban: string;
+        paymentMethodType: string;
+        totalAmountCurrency: string;
+        totalAmountValue: number;
+        url: string;
+    };
+    pspReference: string;
+    resultCode: string;
+}
+export interface AddPaymentDetailsRequest {
+    details: string;
+}
+export interface AddPaymentDetailsResponse {
+    pspReference: string;
+    resultCode: string;
+}
+export interface GetPaymentMethodsRequest {
+    reference: string;
+    countryCode?: string;
+    referenceType?: PaymentReferenceType;
+    locale?: string;
+}
+export interface GetPaymentMethodsResponse {
+    adyenPaymentMethods: string;
+    enableCreditCardStorage: boolean;
+}
+export interface DeleteStoredPaymentMethodByIdRequest {
+    storedPaymentMethodId: string;
+}

package/lib/services/payment/definitions.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,132 @@
+import { AddPaymentDetailsRequest, AddPaymentDetailsResponse, DeleteStoredPaymentMethodByIdRequest, GetPaymentMethodsRequest, GetPaymentMethodsResponse, InitPaymentRequest, InitPaymentResponse } from "./definitions";
+/**
+ * 💳 Initializes a payment transaction.
+ *
+ * This endpoint initializes a payment transaction.
+ * It supports:
+ * - Card authorizations with or without 3D Secure (3DS).
+ * - 3DS authentication flows, including redirection steps if required.
+ * - Bank transfer payment initialization using virtual IBAN feature.
+ *
+ * The response indicates the result of the transaction attempt and may contain an action
+ * (such as a redirection or bank transfer instructions) that must be followed to complete the payment.
+ *
+ * 🛠 **Endpoint**: `POST /v1/shop/payments` [PAY-101]
+ *
+ * | Parameter           | Type                | Required | Description                                    |
+ * |---------------------|---------------------|----------|------------------------------------------------|
+ * | `bankTransfer`      | `BankTransfer`      | ✅       | Bank transfer configuration.                  |
+ * | `browserInfo`       | `BrowserInfo`       | ✅       | Browser information for 3DS authentication.   |
+ * | `commercialOrder`   | `CommercialOrder`   | ❌       | Commercial order details.                     |
+ * | `countryCode`       | `string`            | ✅       | Country code for payment processing.          |
+ * | `customerUserIP`    | `string`            | ✅       | Customer's IP address.                        |
+ * | `paymentMethodData` | `PaymentMethodData` | ✅       | Payment method configuration.                 |
+ * | `reference`         | `string`            | ✅       | Payment reference identifier.                 |
+ * | `referenceType`     | `string`            | ❌       | Type of reference.                            |
+ * | `returnPath`        | `string`            | ✅       | Return URL after payment completion.          |
+ * | `storePaymentMethod`| `boolean`           | ❌       | Whether to store the payment method.          |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to an `InitPaymentResponse` containing the payment initialization result.
+ *
+ *  🛠 **Example usage**:
+ * ```ts
+ * const response = await initPayment({
+ *   bankTransfer: false,
+ *   browserInfo: {
+ *     acceptHeader: "......",
+ *     colorDepth: 24,
+ *     javaEnabled: true,
+ *     javaScriptEnabled: true,
+ *     language: "en-US",
+ *     screenHeight: 1080,
+ *     screenWidth: 1920,
+ *     timeZoneOffset: 0,
+ *     userAgent: "......",
+ *   },
+ *   commercialOrder: false,
+ *   countryCode: "FR",
+ *   customerUserIP: "127.0.0.1",
+ *   paymentMethodData: {
+ *     description: "......",
+ *   },
+ *   reference: "......",
+ *   referenceType: "......",
+ *   returnPath: "......",
+ *   storePaymentMethod: true,
+ * });
+ * console.log(response);
+ *
+ * ```
+ *
+ * @param {InitPaymentRequest} params - The parameters for the payment initialization
+ * @throws {Error} If required parameters are missing
+ * @returns {Promise<InitPaymentResponse>} A promise resolving to the payment initialization response
+ */
+export declare function initPayment({ bankTransfer, browserInfo, commercialOrder, countryCode, customerUserIP, paymentMethodData, reference, referenceType, returnPath, storePaymentMethod, }: InitPaymentRequest): Promise<InitPaymentResponse>;
+/**
+ * 💳 Adds payment details.
+ *
+ * This function adds additional details to an existing payment transaction.
+ * The `details` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `POST /v1/shop/payments/details` [PAY-102]
+ *
+ * | Parameter | Type     | Required | Description                    |
+ * |-----------|----------|----------|--------------------------------|
+ * | `details` | `object` | ✅       | The payment details to add.    |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to an `AddPaymentDetailsResponse` containing the result of adding payment details.
+ *
+ * @param {AddPaymentDetailsRequest} params - The parameters for adding payment details
+ * @throws {Error} If `details` is missing
+ * @returns {Promise<AddPaymentDetailsResponse>} A promise resolving to the response containing the result
+ */
+export declare function addPaymentDetails({ details, }: AddPaymentDetailsRequest): Promise<AddPaymentDetailsResponse>;
+/**
+ * 💳 Gets available payment methods.
+ *
+ * This endpoint retrieves the available payment methods based on the country, locale, amount, and currency.
+ * It provides a list of payment methods that can be used for checkout based on the merchant's Adyen configuration.
+ * The `reference` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/payments/methods` [PAY-501]
+ *
+ * | Parameter      | Type     | Required | Description                                    |
+ * |----------------|----------|----------|------------------------------------------------|
+ * | `reference`    | `string` | ✅       | The payment reference identifier.             |
+ * | `countryCode`  | `string` | ❌       | The country code for payment method filtering.|
+ * | `referenceType`| `string` | ❌       | The type of reference.                        |
+ * | `locale`       | `string` | ❌       | The locale for payment method localization.   |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a `GetPaymentMethodsResponse` containing the available payment methods.
+ *
+ * @param {GetPaymentMethodsRequest} params - The parameters for retrieving payment methods
+ * @throws {Error} If `reference` is missing
+ * @returns {Promise<GetPaymentMethodsResponse>} A promise resolving to the response containing available payment methods
+ */
+export declare function getPaymentMethods({ reference, countryCode, referenceType, locale, }: GetPaymentMethodsRequest): Promise<GetPaymentMethodsResponse>;
+/**
+ * 💳 Deletes a stored payment method.
+ *
+ * This endpoint deletes a stored payment method (e.g., saved card) associated with the current shopper.
+ * It is intended for use on the storefront. If the specified ID does not exist or does not belong
+ * to the authenticated user, a 404 will be returned.
+ * The `storedPaymentMethodId` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `DELETE /v1/shop/payments/stored-payment-methods/{storedPaymentMethodId}` [PAY-300]
+ *
+ * | Parameter              | Type     | Required | Description                                    |
+ * |------------------------|----------|----------|------------------------------------------------|
+ * | `storedPaymentMethodId`| `string` | ✅       | The ID of the stored payment method to delete.|
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to `void` when the stored payment method is successfully deleted.
+ *
+ * @param {DeleteStoredPaymentMethodByIdRequest} params - The parameters for deleting the stored payment method
+ * @throws {Error} If `storedPaymentMethodId` is missing
+ * @returns {Promise<void>} A promise resolving when the stored payment method is successfully deleted
+ */
+export declare function deleteStoredPaymentMethodById({ storedPaymentMethodId, }: DeleteStoredPaymentMethodByIdRequest): Promise<void>;

package/lib/services/payment/index.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initPayment = initPayment;
+exports.addPaymentDetails = addPaymentDetails;
+exports.getPaymentMethods = getPaymentMethods;
+exports.deleteStoredPaymentMethodById = deleteStoredPaymentMethodById;
+const parameters_validation_1 = require("../../helpers/parameters-validation");
+const fetch_instance_1 = require("../../settings/fetch-instance");
+/**
+ * 💳 Initializes a payment transaction.
+ *
+ * This endpoint initializes a payment transaction.
+ * It supports:
+ * - Card authorizations with or without 3D Secure (3DS).
+ * - 3DS authentication flows, including redirection steps if required.
+ * - Bank transfer payment initialization using virtual IBAN feature.
+ *
+ * The response indicates the result of the transaction attempt and may contain an action
+ * (such as a redirection or bank transfer instructions) that must be followed to complete the payment.
+ *
+ * 🛠 **Endpoint**: `POST /v1/shop/payments` [PAY-101]
+ *
+ * | Parameter           | Type                | Required | Description                                    |
+ * |---------------------|---------------------|----------|------------------------------------------------|
+ * | `bankTransfer`      | `BankTransfer`      | ✅       | Bank transfer configuration.                  |
+ * | `browserInfo`       | `BrowserInfo`       | ✅       | Browser information for 3DS authentication.   |
+ * | `commercialOrder`   | `CommercialOrder`   | ❌       | Commercial order details.                     |
+ * | `countryCode`       | `string`            | ✅       | Country code for payment processing.          |
+ * | `customerUserIP`    | `string`            | ✅       | Customer's IP address.                        |
+ * | `paymentMethodData` | `PaymentMethodData` | ✅       | Payment method configuration.                 |
+ * | `reference`         | `string`            | ✅       | Payment reference identifier.                 |
+ * | `referenceType`     | `string`            | ❌       | Type of reference.                            |
+ * | `returnPath`        | `string`            | ✅       | Return URL after payment completion.          |
+ * | `storePaymentMethod`| `boolean`           | ❌       | Whether to store the payment method.          |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to an `InitPaymentResponse` containing the payment initialization result.
+ *
+ *  🛠 **Example usage**:
+ * ```ts
+ * const response = await initPayment({
+ *   bankTransfer: false,
+ *   browserInfo: {
+ *     acceptHeader: "......",
+ *     colorDepth: 24,
+ *     javaEnabled: true,
+ *     javaScriptEnabled: true,
+ *     language: "en-US",
+ *     screenHeight: 1080,
+ *     screenWidth: 1920,
+ *     timeZoneOffset: 0,
+ *     userAgent: "......",
+ *   },
+ *   commercialOrder: false,
+ *   countryCode: "FR",
+ *   customerUserIP: "127.0.0.1",
+ *   paymentMethodData: {
+ *     description: "......",
+ *   },
+ *   reference: "......",
+ *   referenceType: "......",
+ *   returnPath: "......",
+ *   storePaymentMethod: true,
+ * });
+ * console.log(response);
+ *
+ * ```
+ *
+ * @param {InitPaymentRequest} params - The parameters for the payment initialization
+ * @throws {Error} If required parameters are missing
+ * @returns {Promise<InitPaymentResponse>} A promise resolving to the payment initialization response
+ */
+async function initPayment({ bankTransfer, browserInfo, commercialOrder, countryCode, customerUserIP, paymentMethodData, reference, referenceType, returnPath, storePaymentMethod, }) {
+    (0, parameters_validation_1.required)({
+        bankTransfer,
+        browserInfo,
+        countryCode,
+        customerUserIP,
+        paymentMethodData,
+        reference,
+        returnPath,
+    });
+    const { data } = await (0, fetch_instance_1.enhancedFetch)({
+        method: "POST",
+        path: `/v1/shop/payments`,
+        body: JSON.stringify({
+            bankTransfer,
+            browserInfo,
+            commercialOrder,
+            countryCode,
+            customerUserIP,
+            paymentMethodData,
+            reference,
+            referenceType,
+            returnPath,
+            storePaymentMethod,
+        }),
+    });
+    return data;
+}
+/**
+ * 💳 Adds payment details.
+ *
+ * This function adds additional details to an existing payment transaction.
+ * The `details` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `POST /v1/shop/payments/details` [PAY-102]
+ *
+ * | Parameter | Type     | Required | Description                    |
+ * |-----------|----------|----------|--------------------------------|
+ * | `details` | `object` | ✅       | The payment details to add.    |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to an `AddPaymentDetailsResponse` containing the result of adding payment details.
+ *
+ * @param {AddPaymentDetailsRequest} params - The parameters for adding payment details
+ * @throws {Error} If `details` is missing
+ * @returns {Promise<AddPaymentDetailsResponse>} A promise resolving to the response containing the result
+ */
+async function addPaymentDetails({ details, }) {
+    (0, parameters_validation_1.required)({ details });
+    const { data } = await (0, fetch_instance_1.enhancedFetch)({
+        method: "POST",
+        path: `/v1/shop/payments/details`,
+        body: JSON.stringify({
+            details,
+        }),
+    });
+    return data;
+}
+/**
+ * 💳 Gets available payment methods.
+ *
+ * This endpoint retrieves the available payment methods based on the country, locale, amount, and currency.
+ * It provides a list of payment methods that can be used for checkout based on the merchant's Adyen configuration.
+ * The `reference` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/payments/methods` [PAY-501]
+ *
+ * | Parameter      | Type     | Required | Description                                    |
+ * |----------------|----------|----------|------------------------------------------------|
+ * | `reference`    | `string` | ✅       | The payment reference identifier.             |
+ * | `countryCode`  | `string` | ❌       | The country code for payment method filtering.|
+ * | `referenceType`| `string` | ❌       | The type of reference.                        |
+ * | `locale`       | `string` | ❌       | The locale for payment method localization.   |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a `GetPaymentMethodsResponse` containing the available payment methods.
+ *
+ * @param {GetPaymentMethodsRequest} params - The parameters for retrieving payment methods
+ * @throws {Error} If `reference` is missing
+ * @returns {Promise<GetPaymentMethodsResponse>} A promise resolving to the response containing available payment methods
+ */
+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`,
+        params: {
+            reference,
+            countryCode,
+            referenceType,
+            locale,
+        },
+    });
+    return data;
+}
+/**
+ * 💳 Deletes a stored payment method.
+ *
+ * This endpoint deletes a stored payment method (e.g., saved card) associated with the current shopper.
+ * It is intended for use on the storefront. If the specified ID does not exist or does not belong
+ * to the authenticated user, a 404 will be returned.
+ * The `storedPaymentMethodId` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `DELETE /v1/shop/payments/stored-payment-methods/{storedPaymentMethodId}` [PAY-300]
+ *
+ * | Parameter              | Type     | Required | Description                                    |
+ * |------------------------|----------|----------|------------------------------------------------|
+ * | `storedPaymentMethodId`| `string` | ✅       | The ID of the stored payment method to delete.|
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to `void` when the stored payment method is successfully deleted.
+ *
+ * @param {DeleteStoredPaymentMethodByIdRequest} params - The parameters for deleting the stored payment method
+ * @throws {Error} If `storedPaymentMethodId` is missing
+ * @returns {Promise<void>} A promise resolving when the stored payment method is successfully deleted
+ */
+async function deleteStoredPaymentMethodById({ storedPaymentMethodId, }) {
+    (0, parameters_validation_1.required)({ storedPaymentMethodId });
+    await (0, fetch_instance_1.enhancedFetch)({
+        method: "DELETE",
+        path: `/v1/shop/payments/stored-payment-methods/${storedPaymentMethodId}`,
+    });
+}

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>;