@djust-b2b/djust-front-sdk 1.14.0 → 1.15.1

package/lib/services/navigation-category/index.js

@@ -6,44 +6,27 @@ exports.getNavigationCategoryBreadcrumbs = getNavigationCategoryBreadcrumbs;
 const parameters_validation_1 = require("../../helpers/parameters-validation");
 const fetch_instance_1 = require("../../settings/fetch-instance");
 /**
- * ## Get all navigation categories
- * ### APICODE(NAVCAT-550)
- * @returns {Promise<GetNavigationCategoriesResponse>} - The response with the navigation categories
- *
- * @example
- * ### input
- * ```typescript
- * const response = await getNavigationCategories({ locale: 'string' });
+ * 📄 Gets all navigation categories.
+ *
+ * Retrieves a list of all navigation categories available for the shop.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/navigation-category/online`
+ *
+ * | Parameter             | Type                          | Required   | Description                                                   |
+ * |-----------------------|-------------------------------|------------|---------------------------------------------------------------|
+ * | `locale`              | `string`                       | ✅         | Locale of the navigation categories to fetch.                |
+ *
+ * 📤 **Returns**:
+ * A `Promise<GetNavigationCategoriesResponse>` containing a list of navigation categories.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const categories = await getNavigationCategories({
+ *   locale: 'en-US',
+ * });
+ *
+ * console.log(categories);
  * ```
- * ### output
- * Response - <strong style={{ color: 'green' }}>200</strong> - OK
- * ```json
- * [
- *   {
- *      "active": true,
- *      "childrenCategories": [
- *        string
- *      ],
- *      "customFieldValues": [
- *        {
- *          "customField": {
- *            "externalId": "string",
- *            "id": "string",
- *            "name": {
- *              "additionalProp1": "string",
- *              "additionalProp2": "string",
- *              "additionalProp3": "string"
- *            },
- *            "type": "LONG_TEXT"
- *          },
- *          "value": {}
- *        }
- *      ],
- *      "externalId": "string",
- *      "id": "string",
- *      "name": "string"
- *    }
- * ]
  */
 async function getNavigationCategories({ locale, }) {
     (0, parameters_validation_1.required)({ locale });
@@ -57,47 +40,31 @@ async function getNavigationCategories({ locale, }) {
     return data;
 }
 /**
- * ## Get navigation category
- * ### APICODE(NAVCAT-501)
- * @param {GetNavigationCategoryParameters} params - The parameters for the function
- * #### locale - `string` | <strong style={{ color: 'red' }}>required</strong>
- * #### idType - `string` | <strong style={{ color: 'red' }}>required</strong>
- * #### navigationCategoryId - `string` | <strong style={{ color: 'red' }}>required</strong>
- *
- * @returns {Promise<GetNavigationCategoryResponse>} - The response with the navigation category
- *
- * @example
- * ### input
- * ```typescript
- * const response = await getNavigationCategory({ locale: 'string', idType: 'string', navigationCategoryId: 'string' });
+ * 📄 Gets a specific navigation category.
+ *
+ * Retrieves a specific navigation category based on its ID.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/navigation-category/{navigationCategoryId}`
+ *
+ * | Parameter             | Type                          | Required   | Description                                                   |
+ * |-----------------------|-------------------------------|------------|---------------------------------------------------------------|
+ * | `locale`              | `string`                       | ✅         | Locale of the navigation category.                            |
+ * | `idType`              | `string`                       | ✅         | Type of the ID used to identify the category (e.g., `id`, `slug`). |
+ * | `navigationCategoryId`| `string`                       | ✅         | ID of the navigation category to fetch.                       |
+ *
+ * 📤 **Returns**:
+ * A `Promise<GetNavigationCategoryResponse>` containing the specific navigation category.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const category = await getNavigationCategory({
+ *   locale: 'en-US',
+ *   idType: 'id',
+ *   navigationCategoryId: '123',
+ * });
+ *
+ * console.log(category);
  * ```
- * ### output
- * Response - <strong style={{ color: 'green' }}>200</strong> - OK
- * ```json
- * {
- *   "active": true,
- *   "childrenCategories": [
- *     string
- *   ],
- *   "customFieldValues": [
- *     {
- *       "customField": {
- *         "externalId": "string",
- *         "id": "string",
- *         "name": {
- *           "additionalProp1": "string",
- *           "additionalProp2": "string",
- *           "additionalProp3": "string"
- *         },
- *         "type": "LONG_TEXT"
- *       },
- *       "value": {}
- *     }
- *   ],
- *   "externalId": "string",
- *   "id": "string",
- *   "name": "string",
- * }
  */
 async function getNavigationCategory({ locale, idType, navigationCategoryId, }) {
     (0, parameters_validation_1.required)({ idType, navigationCategoryId });
@@ -112,49 +79,31 @@ async function getNavigationCategory({ locale, idType, navigationCategoryId, })
     return data;
 }
 /**
- * ## Get navigation category breadcrumbs
- * ### APICODE(NAVCAT-502)
- * @param {GetNavigationCategoryBreadcrumbsParameters} params - The parameters for the function
- * #### locale - `string` | <strong style={{ color: 'red' }}>required</strong>
- * #### idType - `string` | <strong style={{ color: 'red' }}>required</strong>
- * #### navigationCategoryId - `string` | <strong style={{ color: 'red' }}>required</strong>
- *
- * @returns {Promise<GetNavigationCategoryBreadcrumbsResponse>} - The response with the navigation category breadcrumbs
- *
- * @example
- * ### input
- * ```typescript
- * const response = await getNavigationCategoryBreadcrumbs({ locale: 'string', idType: 'string', navigationCategoryId: 'string' });
+ * 📄 Gets breadcrumbs for a specific navigation category.
+ *
+ * Retrieves the breadcrumb trail for a specific navigation category, showing its hierarchy.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/navigation-category/{navigationCategoryId}/breadcrumb`
+ *
+ * | Parameter             | Type                          | Required   | Description                                                   |
+ * |-----------------------|-------------------------------|------------|---------------------------------------------------------------|
+ * | `locale`              | `string`                       | ✅         | Locale of the navigation category breadcrumbs.               |
+ * | `idType`              | `string`                       | ✅         | Type of the ID used to identify the category (e.g., `id`, `slug`). |
+ * | `navigationCategoryId`| `string`                       | ✅         | ID of the navigation category to fetch breadcrumbs for.      |
+ *
+ * 📤 **Returns**:
+ * A `Promise<GetNavigationCategoryBreadcrumbsResponse>` containing the breadcrumb trail for the navigation category.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const breadcrumbs = await getNavigationCategoryBreadcrumbs({
+ *   locale: 'en-US',
+ *   idType: 'id',
+ *   navigationCategoryId: '123',
+ * });
+ *
+ * console.log(breadcrumbs);
  * ```
- * ### output
- * Response - <strong style={{ color: 'green' }}>200</strong> - OK
- * ```json
- * [
- *   {
- *     "active": true,
- *     "childrenCategories": [
- *       string
- *     ],
- *     "customFieldValues": [
- *       {
- *         "customField": {
- *           "externalId": "string",
- *           "id": "string",
- *           "name": {
- *             "additionalProp1": "string",
- *             "additionalProp2": "string",
- *             "additionalProp3": "string"
- *           },
- *           "type": "LONG_TEXT"
- *         },
- *         "value": {}
- *       }
- *     ],
- *     "externalId": "string",
- *     "id": "string",
- *     "name": "string",
- *     "parent": "string"
- *   }
  */
 async function getNavigationCategoryBreadcrumbs({ locale, idType, navigationCategoryId, }) {
     (0, parameters_validation_1.required)({ idType, navigationCategoryId });

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

@@ -24,7 +24,7 @@ declare enum AggregationType {
 }
 export interface GetProductsListParameters {
     locale: string;
-    filters?: {
+    filters: {
         currency: string;
         categoryIds?: string[];
         skus?: string[];

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

@@ -1,57 +1,409 @@
 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 } from "./definitions";
 /**
- * Search product with text expression for search and autocomplete
+ * 📄 Search products with a text expression for search and autocomplete.
+ *
+ * This function provides product search and autocomplete capabilities.
+ *
+ * 🛠 **Endpoint**: `GET /v2/shop/autocomplete`
+ *
+ * | Parameter       | Type         | Required | Description                                 |
+ * |-----------------|--------------|----------|---------------------------------------------|
+ * | `input`         | `string`     | ✅       | The text expression to search for.         |
+ * | `locale`        | `string`     | ✅       | The locale for the search.                 |
+ * | `currency`      | `string`     | ✅       | The currency for price formatting.         |
+ * | `pageable.page` | `number`     | ❌       | The page number to fetch (0-based index).  |
+ * | `pageable.size` | `number`     | ❌       | The number of items per page.              |
+ * | `aggregation`   | `boolean`    | ❌       | Whether to include aggregation data.       |
+ * | `productTags`   | `string[]`   | ❌       | Filters by product tags.                   |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a `SearchProductsResponse` containing the matched products.
+ *
+ * 🛠 **Example usage**:
+ * ```typescript
+ * const products = await autoCompleteSearchProducts({
+ *   input: 'laptop',
+ *   locale: 'en-US',
+ *   currency: 'USD',
+ *   pageable: { page: 0, size: 10 },
+ * });
+ * console.log(products);
+ * ```
  */
 export declare function autoCompleteSearchProducts({ input, locale, currency, pageable, aggregation, productTags, }: AutoCompleteSearchProductsParameters): Promise<SearchProductsResponse>;
 /**
- * Get thumbnails of a product regrouping product, stat reviews, attributs and bestOffer
+ * 📄 Fetches a list of products with thumbnails, reviews, attributes, and best offers.
+ *
+ * 🛠 **Endpoint**: `GET /v2/shop/search`
+ *
+ * | Parameter       | Type         | Required | Description                                 |
+ * |-----------------|--------------|----------|---------------------------------------------|
+ * | `locale`        | `string`     | ✅       | The locale for product data.               |
+ * | `filters`       | `object`     | ❌       | Filters for narrowing down search results. |
+ * | `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 `GetProductsListResponse` containing the products and their metadata.
+ *
+ * 🛠 **Example usage**:
+ * ```typescript
+ * const products = await getProductsList({
+ *   locale: 'en-US',
+ *   filters: { category: 'electronics' },
+ *   pageable: { page: 1, size: 20 },
+ * });
+ * console.log(products);
+ * ```
  */
 export declare function getProductsList({ locale, filters, pageable, }: GetProductsListParameters): Promise<GetProductsListResponse>;
 /**
- * Get a paginated list of a product's variants
+ * 📄 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>;
 /**
- * Get List offers of a product variant by sku, id or externalId
+ * 📄 Fetches offers for a specific product variant.
+ *
+ * Retrieves the list of offers available for a product variant identified by SKU, ID, or external ID.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/product-variants/{productIdentifier}/offers`
+ *
+ * | Parameter             | Type        | Required   | Description                                                   |
+ * |-----------------------|-------------|------------|---------------------------------------------------------------|
+ * | `productIdentifier`   | `string`    | ✅         | Unique identifier for the product variant (e.g., SKU, ID).    |
+ * | `productIdType`       | `string`    | ✅         | The type of identifier: `"sku"`, `"id"`, or `"externalId"`.   |
+ * | `currency`            | `string`    | ✅         | Currency in which offers should be returned (e.g., `"USD"`).  |
+ *
+ * 📤 **Returns**:
+ * A `Promise<GetProductVariantOffersResponse>` containing a list of offers for the product variant.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const offers = await getProductVariantOffers({
+ *   productIdentifier: 'sku123',
+ *   productIdType: 'sku',
+ *   currency: 'USD',
+ * });
+ *
+ * console.log(offers);
+ * ```
+ *
+ * **Example Response**:
+ * ```json
+ * {
+ *   "offers": [
+ *     {
+ *       "id": "offer1",
+ *       "price": 19.99,
+ *       "currency": "USD",
+ *       "availability": "In Stock",
+ *       "seller": "Seller A"
+ *     },
+ *     {
+ *       "id": "offer2",
+ *       "price": 17.99,
+ *       "currency": "USD",
+ *       "availability": "Limited Stock",
+ *       "seller": "Seller B"
+ *     }
+ *   ]
+ * }
+ * ```
  */
 export declare function getProductVariantOffers({ productIdentifier, productIdType, currency, }: GetProductVariantOffersParameters): Promise<GetProductVariantOffersResponse>;
 /**
- * Get suppliers of a product variant
+ * 📄 Fetches suppliers associated with a product variant.
+ *
+ * Retrieves a list of suppliers for a given product variant.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/product-variants/{productVariantId}/suppliers`
+ *
+ * | Parameter             | Type                          | Required   | Description                                                   |
+ * |-----------------------|-------------------------------|------------|---------------------------------------------------------------|
+ * | `productVariantId`    | `string`                     | ✅         | ID of the product variant.                                    |
+ *
+ * 📤 **Returns**:
+ * A `Promise<GetProductVariantSuppliersResponse>` containing the list of suppliers.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const suppliers = await getProductVariantSuppliers({
+ *   productVariantId: 'variant123',
+ * });
+ *
+ * console.log(suppliers);
+ * ```
  */
 export declare function getProductVariantSuppliers({ productVariantId, }: GetProductVariantSuppliersParameters): Promise<GetProductVariantSuppliersResponse>;
 /**
- * Get a product by sku, id or externalId
+ * 📄 Fetches details for a specific product.
+ *
+ * Retrieves information about a product identified by SKU, ID, or external ID.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/products/{productIdentifier}`
+ *
+ * | Parameter             | Type        | Required   | Description                                                   |
+ * |-----------------------|-------------|------------|---------------------------------------------------------------|
+ * | `productIdentifier`   | `string`    | ✅         | Unique identifier for the product (e.g., SKU, ID).            |
+ * | `productIdType`       | `string`    | ✅         | The type of identifier: `"sku"`, `"id"`, or `"externalId"`.   |
+ * | `locale`              | `string`    | ✅         | Locale for the product details (e.g., `"en_US"`).             |
+ *
+ * 📤 **Returns**:
+ * A `Promise<GetProductsListResponse>` containing the product details.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const product = await getProduct({
+ *   productIdentifier: 'sku123',
+ *   productIdType: 'sku',
+ *   locale: 'en_US',
+ * });
+ *
+ * console.log(product);
+ * ```
  */
 export declare function getProduct({ productIdentifier, productIdType, locale, }: GetProductParameters): Promise<GetProductsListResponse>;
 /**
- * Get offers of a product by sku, id or externalId
+ * 📄 Fetches product offers by SKU, ID, or external ID.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/products/{productIdentifier}/offers`
+ *
+ * | Parameter           | Type         | Required | Description                                     |
+ * |---------------------|--------------|----------|-------------------------------------------------|
+ * | `productIdentifier` | `string`     | ✅       | The unique identifier of the product.          |
+ * | `productIdType`     | `string`     | ✅       | The type of the identifier (`sku`, `id`, etc.).|
+ * | `currency`          | `string`     | ✅       | The currency for the offer details.            |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a `GetProductVariantOffersResponse` containing the offers.
+ *
+ * 🛠 **Example usage**:
+ * ```typescript
+ * const offers = await getProductVariantOffers({
+ *   productIdentifier: 'sku123',
+ *   productIdType: 'sku',
+ *   currency: 'USD',
+ * });
+ * console.log(offers);
+ * ```
  */
 export declare function getProductOffers({ productIdentifier, productIdType, locale, currency, }: GetProductOffersParameters): Promise<GetProductOffersResponse>;
 /**
- * Get related products of a product by sku, id or externalId
+ * 📄 Fetches related products for a specific product.
+ *
+ * Retrieves a paginated list of related products identified by SKU, ID, or external ID.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/products/{productIdentifier}/related-products`
+ *
+ * | Parameter             | Type        | Required   | Description                                                   |
+ * |-----------------------|-------------|------------|---------------------------------------------------------------|
+ * | `productIdentifier`   | `string`    | ✅         | Unique identifier for the product (e.g., SKU, ID).            |
+ * | `productIdType`       | `string`    | ✅         | The type of identifier: `"sku"`, `"id"`, or `"externalId"`.   |
+ * | `locale`              | `string`    | ✅         | Locale for the related products (e.g., `"en_US"`).            |
+ * | `currency`            | `string`    | ✅         | Currency for the related products (e.g., `"USD"`).            |
+ * | `pageable`            | `object`    | ❌         | Pagination details: `page`, `size`, `sort`.                   |
+ *
+ * 📤 **Returns**:
+ * A `Promise<GetRelatedProductsParameters>` containing related products.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const relatedProducts = await getRelatedProducts({
+ *   productIdentifier: 'sku123',
+ *   productIdType: 'sku',
+ *   locale: 'en_US',
+ *   currency: 'USD',
+ *   pageable: { page: 1, size: 10 },
+ * });
+ *
+ * console.log(relatedProducts);
+ * ```
  */
 export declare function getRelatedProducts({ productIdentifier, productIdType, locale, currency, pageable, }: GetRelatedProductsParameters): Promise<GetRelatedProductsParameters>;
 /**
- * Get reviews of a product by sku, id or externalId
+ * 📄 Fetches reviews for a specific product.
+ *
+ * Retrieves a list of reviews for a product identified by SKU, ID, or external ID.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/products/{productIdentifier}/reviews`
+ *
+ * | Parameter             | Type        | Required   | Description                                                   |
+ * |-----------------------|-------------|------------|---------------------------------------------------------------|
+ * | `productIdentifier`   | `string`    | ✅         | Unique identifier for the product (e.g., SKU, ID).            |
+ * | `productIdType`       | `string`    | ✅         | The type of identifier: `"sku"`, `"id"`, or `"externalId"`.   |
+ *
+ * 📤 **Returns**:
+ * A `Promise<GetProductReviewsResponse>` containing the reviews.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const reviews = await getProductReviews({
+ *   productIdentifier: 'sku123',
+ *   productIdType: 'sku',
+ * });
+ *
+ * console.log(reviews);
+ * ```
  */
 export declare function getProductReviews({ productIdentifier, productIdType, }: GetProductReviewsParameters): Promise<GetProductReviewsResponse>;
 /**
- * Get stat reviews of a product by sku, id or externalId
+ * 📄 Fetches statistical review data for a specific product.
+ *
+ * Retrieves aggregate review statistics for a product identified by SKU, ID, or external ID.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/products/{productIdentifier}/stat-reviews`
+ *
+ * | Parameter             | Type        | Required   | Description                                                   |
+ * |-----------------------|-------------|------------|---------------------------------------------------------------|
+ * | `productIdentifier`   | `string`    | ✅         | Unique identifier for the product (e.g., SKU, ID).            |
+ * | `productIdType`       | `string`    | ✅         | The type of identifier: `"sku"`, `"id"`, or `"externalId"`.   |
+ *
+ * 📤 **Returns**:
+ * A `Promise<GetProductStatReviewsResponse>` containing review statistics.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const stats = await getProductStatReviews({
+ *   productIdentifier: 'sku123',
+ *   productIdType: 'sku',
+ * });
+ *
+ * console.log(stats);
+ * ```
  */
 export declare function getProductStatReviews({ productIdentifier, productIdType, }: GetProductStatReviewsParameters): Promise<GetProductStatReviewsResponse>;
 /**
- * Get attributes of a product variant by sku, id or externalId
+ * 📄 Fetches attributes for a product variant.
+ *
+ * Retrieves attributes for a product variant identified by SKU, ID, or external ID.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/products/{productIdentifier}/variant-attributes`
+ *
+ * | Parameter             | Type        | Required   | Description                                                   |
+ * |-----------------------|-------------|------------|---------------------------------------------------------------|
+ * | `productIdentifier`   | `string`    | ✅         | Unique identifier for the product variant (e.g., SKU, ID).    |
+ * | `productIdType`       | `string`    | ✅         | The type of identifier: `"sku"`, `"id"`, or `"externalId"`.   |
+ * | `locale`              | `string`    | ✅         | Locale for the attributes (e.g., `"en_US"`).                  |
+ *
+ * 📤 **Returns**:
+ * A `Promise<GetProductVariantAttributesResponse>` containing variant attributes.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const attributes = await getProductVariantAttributes({
+ *   productIdentifier: 'sku123',
+ *   productIdType: 'sku',
+ *   locale: 'en_US',
+ * });
+ *
+ * console.log(attributes);
+ * ```
  */
 export declare function getProductVariantAttributes({ productIdentifier, productIdType, locale, }: GetProductVariantAttributesParameters): Promise<GetProductVariantAttributesResponse>;
 /**
- * Create a review for a product
+ * 📄 Creates a review for a product.
+ *
+ * Submits a review for a specific product based on its SKU.
+ *
+ * 🛠 **Endpoint**: `POST /v1/shop/reviews`
+ *
+ * | Parameter             | Type                          | Required   | Description                                                   |
+ * |-----------------------|-------------------------------|------------|---------------------------------------------------------------|
+ * | `message`             | `string`                     | ✅         | Review content.                                               |
+ * | `productSku`          | `string`                     | ✅         | SKU of the product to review.                                |
+ * | `rating`              | `number`                     | ✅         | Rating (e.g., 1 to 5).                                        |
+ *
+ * 📤 **Returns**:
+ * A `Promise<CreateProductReviewResponse>` indicating the result of the operation.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const review = await createProductReview({
+ *   message: 'Great product!',
+ *   productSku: 'sku123',
+ *   rating: 5,
+ * });
+ *
+ * console.log(review);
+ * ```
  */
 export declare function createProductReview({ message, productSku, rating, }: CreateProductReviewParameters): Promise<CreateProductReviewResponse>;
 /**
- * Update a review for a product
+ * 📄 Updates an existing review for a product.
+ *
+ * Modifies the content and/or rating of an existing review for a specific product.
+ *
+ * 🛠 **Endpoint**: `PUT /v1/shop/reviews/{productReviewId}`
+ *
+ * | Parameter             | Type                          | Required   | Description                                                   |
+ * |-----------------------|-------------------------------|------------|---------------------------------------------------------------|
+ * | `productReviewId`     | `string`                       | ✅         | ID of the review to update.                                   |
+ * | `message`             | `string`                       | ✅         | New review content.                                           |
+ * | `rating`              | `number`                       | ✅         | New rating (e.g., 1 to 5).                                     |
+ *
+ * 📤 **Returns**:
+ * A `Promise<UpdateProductReviewResponse>` indicating the result of the operation.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const updatedReview = await updateProductReview({
+ *   productReviewId: 'review123',
+ *   message: 'Updated my thoughts, still a great product!',
+ *   rating: 4,
+ * });
+ *
+ * console.log(updatedReview);
+ * ```
  */
 export declare function updateProductReview({ productReviewId, message, rating, }: UpdateProductReviewParameters): Promise<UpdateProductReviewResponse>;
 /**
- * Get paginated offers of a product by sku, id or externalId
+ * 📄 Fetches paginated offers for a product.
+ *
+ * Retrieves offers for a product identified by SKU, ID, or external ID, with pagination support.
+ *
+ * 🛠 **Endpoint**: `GET /v1/shop/products/{productIdentifier}/paginated-offers`
+ *
+ * | Parameter             | Type        | Required   | Description                                                   |
+ * |-----------------------|-------------|------------|---------------------------------------------------------------|
+ * | `productIdentifier`   | `string`    | ✅         | Unique identifier for the product (e.g., SKU, ID).            |
+ * | `productIdType`       | `string`    | ✅         | The type of identifier: `"sku"`, `"id"`, or `"externalId"`.   |
+ * | `currency`            | `string`    | ✅         | Currency for the offers (e.g., `"USD"`).                      |
+ * | `locale`              | `string`    | ✅         | Locale for the offers (e.g., `"en_US"`).                      |
+ * | `withoutPrices`       | `boolean`   | ❌         | Whether to exclude prices from the response.                  |
+ * | `pageable`            | `object`    | ❌         | Pagination details: `page`, `size`, `sort`.                   |
+ *
+ * 📤 **Returns**:
+ * A `Promise<GetProductPaginatedOffersResponse>` containing paginated offers.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const offers = await getProductPaginatedOffers({
+ *   productIdentifier: 'sku123',
+ *   productIdType: 'sku',
+ *   currency: 'USD',
+ *   locale: 'en_US',
+ *   pageable: { page: 1, size
  */
 export declare function getProductPaginatedOffers({ productIdentifier, productIdType, currency, locale, withoutPrices, pageable, }: GetProductPaginatedOffersParameters): Promise<GetProductPaginatedOffersResponse>;