oneentry 1.0.124 → 1.0.126

package/dist/products/productsInterfaces.d.ts

@@ -1,4 +1,5 @@
-import type { AttributeType, IError, LangType, Types } from '../base/utils';
+import type { IFormConfig } from 'forms/formsInterfaces';
+import type { AttributeType, IError, ILocalizeInfo, LangType, Types } from '../base/utils';
 /**
  * @interface IProductApi
  *
@@ -8,51 +9,77 @@ import type { AttributeType, IError, LangType, Types } from '../base/utils';
  * @property {function} getProductsPriceByPageUrl - Search for information about products and prices for the selected category.
  * @property {function} getProductsByPageUrl - Search for all products with pagination for the selected category.
  * @property {function} getRelatedProductsById - Find all related product page objects.
+ * @property {function} getProductsByIds - Find products by its ids.
  * @property {function} getProductById - Retrieve one product object.
  * @property {function} getProductBlockById - Getting a product block object by product id.
  * @property {function} searchProduct - Quick search for product page objects with limited output.
- *
+ * @property {function} getProductsCount - Retrieves the total number of products available in the entire catalog.
+ * @property {function} getProductsCountByPageId - Retrieves the number of products on a specific catalog page identified by its page ID.
+ * @property {function} getProductsCountByPageUrl - Retrieves the number of products on a specific catalog page identified by its URL.
  * @description This interface defines methods for retrieving and managing products in the system.
  */
 interface IProductApi {
     /**
      * Search for all products with pagination and filter.
      *
-     * @param {Array<IFilterParams>} [body] - Request body. Default []. Example: [ { "attributeMarker": "price", "conditionMarker": "mth", "statusMarker": "waiting", "conditionValue": 1, "pageUrls": [ "23-laminat-floorwood-maxima" ], "isNested": false, "title": "" }, { "attributeMarker": "price", "conditionMarker": "lth", "conditionValue": 3, "pageUrls": [ "23-laminat-floorwood-maxima" ], "isNested": false, "title": "" } ].
+     * @param {IFilterParams[]} [body] - Request body. Default []. Example:
+        [
+          {
+            "attributeMarker": "price",
+            "conditionMarker": "mth",
+            "statusMarker": "waiting",
+            "conditionValue": 1,
+            "pageUrls": [
+              "23-laminat-floorwood-maxima"
+            ],
+            "isNested": false,
+            "title": ""
+          },
+          {
+            "attributeMarker": "price",
+            "conditionMarker": "lth",
+            "conditionValue": 3,
+            "pageUrls": [
+              "23-laminat-floorwood-maxima"
+            ],
+            "isNested": false,
+            "title": ""
+          }
+        ]
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {IProductsQuery} [userQuery] - Optional set query parameters.
-     *
-     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0.
-     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30.
-     * @param {string} [userQuery.sortOrder] - Optional sorting order DESC | ASC. Example: 'DESC'.
-     * @param {string} [userQuery.sortKey] - Optional field to sort by (id, title, date, price, position, status). Example: 'id'.
-     * @param {number} [userQuery.statusId] - Optional parameter - search by status id. Example: 123.
-     * @param {string} [userQuery.statusMarker] - Optional identifier of the product page status. Example: 'in_stock'.
-     * @param {string} [userQuery.conditionValue] - Optional value that is being searched. Example: 'new'.
-     * @param {string} [userQuery.conditionMarker] - Optional identifier of the filter condition by which values are filtered. Example: 'equals'.
-     * @param {string} [userQuery.attributeMarker] - Optional text identifier of the indexed attribute by which values are filtered. Example: 'color'.
-     *
+     * @param {IProductsQuery} [userQuery] - Optional set query parameters. Example:
+        {
+          "limit": 30,
+          "offset": 0,
+          "sortOrder": "DESC",
+          "sortKey": "id",
+          "statusId": 123,
+          "statusMarker": "in_stock",
+          "conditionValue": "new",
+          "conditionMarker": "equals",
+          "attributeMarker": "color"
+        }
      * @return {IProductsResponse} Array with ProductEntity objects
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
-     *
      * @description This method requires user authorization. For more information about configuring the authorization module, see the documentation in the configuration settings section of the SDK.
      */
-    getProducts(body?: Array<IFilterParams>, langCode?: string, userQuery?: IProductsQuery): Promise<IProductsResponse | IError>;
+    getProducts(body?: IFilterParams[], langCode?: string, userQuery?: IProductsQuery): Promise<IProductsResponse | IError>;
     /**
      * Search for all product page objects with pagination that do not have a category.
      *
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {IProductsQuery} [userQuery] - Optional set query parameters.
-     *
-     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0.
-     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30.
-     * @param {string} [userQuery.statusMarker] - Optional identifier of the product page status. Example: 'in_stock'.
-     * @param {string} [userQuery.conditionValue] - Optional value that is being searched. Example: 'new'.
-     * @param {string} [userQuery.conditionMarker] - Optional identifier of the filter condition by which values are filtered. Example: 'equals'.
-     * @param {string} [userQuery.attributeMarker] - Optional text identifier of the indexed attribute by which values are filtered. Example: 'color'.
-     * @param {string} [userQuery.sortOrder] - Optional sorting order DESC | ASC. Example: 'DESC'.
-     * @param {string} [userQuery.sortKey] - Optional field to sort by (id, title, date, price, position, status). Example: 'id'.
-     *
+     * @param {IProductsQuery} [userQuery] - Optional set query parameters. Example:
+        {
+          "limit": 30,
+          "offset": 0,
+          "sortOrder": "DESC",
+          "sortKey": "id",
+          "statusId": 123,
+          "statusMarker": "in_stock",
+          "conditionValue": "new",
+          "conditionMarker": "equals",
+          "attributeMarker": "color"
+        }
      * @return {IProductsResponse} Array with ProductEntity objects.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -61,39 +88,41 @@ interface IProductApi {
      * Search for all products with pagination for the selected category.
      *
      * @param {number} id - Page id. Example: 12345.
-     * @param {Array<IFilterParams>} [body] - Request body. Default: [].
+     * @param {IFilterParams[]} [body] - Request body. Default: [].
      * @param {string} [langCode] - Language code. Default "en_US".
-     * @param {IProductsQuery} [userQuery] - Optional set query parameters.
-     *
-     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0
-     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30
-     * @param {string} [userQuery.statusMarker] - Optional identifier of the product page status. Example: 'in_stock'.
-     * @param {string} [userQuery.conditionValue] - Optional value that is being searched. Example: 'new'.
-     * @param {string} [userQuery.conditionMarker] - Optional identifier of the filter condition by which values are filtered. Example: 'equals'.
-     * @param {string} [userQuery.attributeMarker] - Optional text identifier of the indexed attribute by which values are filtered. Example: 'color'.
-     * @param {string} [userQuery.sortOrder] - Optional sorting order DESC | ASC. Example: 'DESC'.
-     * @param {string} [userQuery.sortKey] - Optional field to sort by (id, title, date, price, position, status). Example: 'id'.
-     *
+     * @param {IProductsQuery} [userQuery] - Optional set query parameters. Example:
+        {
+          "limit": 30,
+          "offset": 0,
+          "sortOrder": "DESC",
+          "sortKey": "id",
+          "statusId": 123,
+          "statusMarker": "in_stock",
+          "conditionValue": "new",
+          "conditionMarker": "equals",
+          "attributeMarker": "color"
+        }
      * @return {IProductsResponse} Array with ProductEntity objects
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getProductsByPageId(id: number, body?: Array<IFilterParams>, langCode?: string, userQuery?: IProductsQuery): Promise<IProductsResponse | IError>;
+    getProductsByPageId(id: number, body?: IFilterParams[], langCode?: string, userQuery?: IProductsQuery): Promise<IProductsResponse | IError>;
     /**
      * Search for information about products and prices for the selected category.
      *
-     * @param {string} [url] - Page url. Example: '23-laminat-floorwood-maxima'.
+     * @param {string} [url] - Page url. Example: "23-laminat-floorwood-maxima".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {IProductsQuery} [userQuery] - Optional set query parameters.
-     *
-     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 30.
-     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 0.
-     * @param {string} [userQuery.statusMarker] - Optional identifier of the product page status. Example: 'in_stock'.
-     * @param {string} [userQuery.conditionValue] - Optional value that is being searched. Example: 'new'.
-     * @param {string} [userQuery.conditionMarker] - Optional identifier of the filter condition by which values are filtered. Example: 'equals'.
-     * @param {string} [userQuery.attributeMarker] - Optional text identifier of the indexed attribute by which values are filtered. Example: 'color'.
-     * @param {string} [userQuery.sortOrder] - Optional sorting order DESC | ASC. Example: 'DESC'.
-     * @param {string} [userQuery.sortKey] - Optional field to sort by (id, title, date, price, position, status). Example: 'id'.
-     *
+     * @param {IProductsQuery} [userQuery] - Optional set query parameters. Example:
+        {
+          "limit": 30,
+          "offset": 0,
+          "sortOrder": "DESC",
+          "sortKey": "id",
+          "statusId": 123,
+          "statusMarker": "in_stock",
+          "conditionValue": "new",
+          "conditionMarker": "equals",
+          "attributeMarker": "color"
+        }
      * @return {IProductsInfo} Array with ProductInformation objects.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -101,36 +130,42 @@ interface IProductApi {
     /**
      * Search for all products with pagination for the selected category.
      *
-     * @param {string} url - Page url. Example: '23-laminat-floorwood-maxima'.
-     * @param {Array<IFilterParams>} [body] - Request body. Default: [].
+     * @param {string} url - Page url. Example: "23-laminat-floorwood-maxima".
+     * @param {IFilterParams[]} [body] - Request body. Default: [].
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {IProductsQuery} [userQuery] - Optional set query parameters.
-     *
-     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 30.
-     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 0.
-     * @param {string} [userQuery.statusMarker] - Optional identifier of the product page status. Example: 'in_stock'.
-     * @param {string} [userQuery.conditionValue] - Optional value that is being searched. Example: 'new'.
-     * @param {string} [userQuery.conditionMarker] - Optional identifier of the filter condition by which values are filtered. Example: 'equals'.
-     * @param {string} [userQuery.attributeMarker] - Optional text identifier of the indexed attribute by which values are filtered. Example: 'color'.
-     * @param {string} [userQuery.sortOrder] - Optional sorting order DESC | ASC. Example: 'DESC'.
-     * @param {string} [userQuery.sortKey] - Optional field to sort by (id, title, date, price, position, status). Example: 'id'.
-     *
+     * @param {IProductsQuery} [userQuery] - Optional set query parameters. Example:
+        {
+          "limit": 30,
+          "offset": 0,
+          "sortOrder": "DESC",
+          "sortKey": "id",
+          "statusId": 123,
+          "statusMarker": "in_stock",
+          "conditionValue": "new",
+          "conditionMarker": "equals",
+          "attributeMarker": "color"
+        }
      * @return {IProductsResponse} Array with ProductEntity objects.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getProductsByPageUrl(url: string, body?: Array<IFilterParams>, langCode?: string, userQuery?: IProductsQuery): Promise<IProductsResponse | IError>;
+    getProductsByPageUrl(url: string, body?: IFilterParams[], langCode?: string, userQuery?: IProductsQuery): Promise<IProductsResponse | IError>;
     /**
      * Find all related product page objects.
      *
      * @param {number} [id] - Product page identifier for which to find relationship. Example: 12345.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {IProductsQuery} [userQuery] - Optional set query parameters.
-     *
-     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0.
-     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30.
-     * @param {string} [userQuery.sortOrder] - Optional sorting order DESC | ASC. Example: 'DESC'.
-     * @param {string} [userQuery.sortKey] - Optional field to sort by (id, title, date, price, position, status). Example: 'id'.
-     *
+     * @param {IProductsQuery} [userQuery] - Optional set query parameters. Example:
+        {
+          "limit": 30,
+          "offset": 0,
+          "sortOrder": "DESC",
+          "sortKey": "id",
+          "statusId": 123,
+          "statusMarker": "in_stock",
+          "conditionValue": "new",
+          "conditionMarker": "equals",
+          "attributeMarker": "color"
+        }
      * @return {IProductsResponse} Array with ProductEntity objects
      * @throws {IError} If there is an error during the fetch operation, it will return an error object.
      */
@@ -138,62 +173,164 @@ interface IProductApi {
     /**
      * Find products by its ids.
      *
-     * @param {string} [ids] - Product page identifiers for which to find relationships. Example: '12345,67890'.
+     * @param {string} [ids] - Product page identifiers for which to find relationships. Example: "12345,67890".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {IProductsQuery} [userQuery] - Optional set query parameters.
-     *
-     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0.
-     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30.
-     * @param {string} [userQuery.sortOrder] - Optional sorting order DESC | ASC. Default: 'DESC'.
-     * @param {string} [userQuery.sortKey] - Optional field to sort by (id, title, date, price, position, status). Default: 'id'.
-     *
-     * @return {IProductEntity[]} Array with ProductEntity objects
+     * @param {IProductsQuery} [userQuery] - Optional set query parameters. Example:
+        {
+          "limit": 30,
+          "offset": 0,
+          "sortOrder": "DESC",
+          "sortKey": "id",
+          "statusId": 123,
+          "statusMarker": "in_stock",
+          "conditionValue": "new",
+          "conditionMarker": "equals",
+          "attributeMarker": "color"
+        }
+     * @return {IProductsEntity[]} Array with ProductEntity objects
      * @throws {IError} If there is an error during the fetch operation, it will return an error object.
      */
-    getProductsByIds(ids: string, langCode?: string, userQuery?: IProductsQuery): Promise<Array<IProductEntity> | IError>;
+    getProductsByIds(ids: string, langCode?: string, userQuery?: IProductsQuery): Promise<IProductsEntity[] | IError>;
     /**
      * Retrieve one product object.
      *
      * @param {number} id - Product id. Example: 12345.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     *
-     * @return {IProductEntity} ProductEntity object.
+     * @return {IProductsEntity} ProductEntity object.
      * @throws {IError} If there is an error during the fetch operation, it will return an error object.
      */
-    getProductById(id: number, langCode?: string): Promise<IProductEntity | IError>;
+    getProductById(id: number, langCode?: string): Promise<IProductsEntity | IError>;
     /**
      * Getting a product block object by product id.
      *
      * @param {number} id - Product id. Example: 12345.
-     *
      * @return {IProductBlock}
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getProductBlockById(id: number): Promise<Array<IProductBlock> | IError>;
+    getProductBlockById(id: number): Promise<IProductBlock[] | IError>;
     /**
      * Quick search for product page objects with limited output.
      *
      * @param {string} name - Text to search product page objects (search is based on the title field of the localizeInfos object with language consideration). Example: 'laminat'.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     *
      * @return {IProductsEntity[]} Array with ProductEntity objects
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    searchProduct(name: string, langCode: string): Promise<Array<IProductsEntity> | IError>;
+    searchProduct(name: string, langCode: string): Promise<IProductsEntity[] | IError>;
+    /**
+     * Getting the number of products for the entire catalog.
+     *
+     * @handleName getProductsCount
+     *
+     * @param {string} [body] - Body parameters for filter. Deault: []. Example:
+        [
+          {
+            "attributeMarker": "price",
+            "conditionMarker": "in",
+            "statusMarker": "status_1",
+            "conditionValue": {},
+            "pageUrls": [
+              "23-laminat-floorwood-maxima"
+            ],
+            "title": "Iphone 17 Pro"
+          },
+          {
+            "attributeMarker": "price",
+            "conditionMarker": "in",
+            "statusMarker": "status_1",
+            "conditionValue": {},
+            "pageUrls": [
+              "23-laminat-floorwood-maxima"
+            ],
+            "title": "Iphone 17 Pro"
+          }
+        ]
+     * @return {IProductsCount} Object with product items count.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method calculates and returns the total number of products present across the entire catalog, optionally applying specified filters.
+     */
+    getProductsCount(body: any): Promise<IProductsCount | IError>;
+    /**
+     * Getting the number of products on a catalog page by page ID.
+     *
+     * @handleName getProductsCountByPageId
+     *
+     * @param {string} id - Page id. Example: 12345.
+     * @param {string} body - Body parameters for filter. Deault: []. Example:
+        [
+          {
+            "attributeMarker": "price",
+            "conditionMarker": "in",
+            "statusMarker": "status_1",
+            "conditionValue": {},
+            "pageUrls": [
+              "23-laminat-floorwood-maxima"
+            ],
+            "title": "Iphone 17 Pro"
+          },
+          {
+            "attributeMarker": "price",
+            "conditionMarker": "in",
+            "statusMarker": "status_1",
+            "conditionValue": {},
+            "pageUrls": [
+              "23-laminat-floorwood-maxima"
+            ],
+            "title": "Iphone 17 Pro"
+          }
+        ]
+     * @return {IProductsCount} Object with product items count.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method calculates and returns the number of products available on a given catalog page, identified by its page ID, with optional filtering.
+     */
+    getProductsCountByPageId(id: string, body: any): Promise<IProductsCount | IError>;
+    /**
+     * Getting the number of products on a catalog page by page URL.
+     *
+     * @handleName getProductsCountByPageUrl
+     *
+     * @param {string} url - Page url. Example: "catalog".
+     * @param {string} body - Body parameters for filter. Deault: []. Example:
+        [
+          {
+            "attributeMarker": "price",
+            "conditionMarker": "in",
+            "statusMarker": "status_1",
+            "conditionValue": {},
+            "pageUrls": [
+              "23-laminat-floorwood-maxima"
+            ],
+            "title": "Iphone 17 Pro"
+          },
+          {
+            "attributeMarker": "price",
+            "conditionMarker": "in",
+            "statusMarker": "status_1",
+            "conditionValue": {},
+            "pageUrls": [
+              "23-laminat-floorwood-maxima"
+            ],
+            "title": "Iphone 17 Pro"
+          }
+        ]
+     * @return {IProductsCount} Object with product items count.
+     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @description This method calculates and returns the number of products available on a given catalog page, identified by its URL, with optional filtering.
+     */
+    getProductsCountByPageUrl(url: string, body: any): Promise<IProductsCount | IError>;
 }
 /**
  * @interface IProductsQuery
  *
  * @property {number} offset - Parameter for pagination. Default: 0.
  * @property {number} limit - Parameter for pagination. Default: 30.
- * @property {string} sortOrder - Sort order 'DESC' | 'ASC'. Default: 'DESC'.
- * @property {string} sortKey - Field for sorting (default - null). Possible values: 'id', 'position', 'title', 'date', 'price'. Default: null.
- * @property {string | null} [templateMarker] - Product page status id, default null. Example: 'template_12345'.
- * @property {string | null} [statusMarker] - Product page status id, default null. Example: 'in_stock'.
- * @property {string | null} [conditionValue] - The value that is being searched for, default null. Example: 'new'.
- * @property {string | null} [attributeMarker] - The text identifier of the indexed attribute by which values are filtered, default null. Example: 'color'.
- * @property {string | null} [conditionMarker] - Id of the filter condition by which the values are filtered, default null. Example: 'equals'.
- *
+ * @property {string} sortOrder - Sort order "DESC" | "ASC". Default: "DESC".
+ * @property {string} sortKey - Field for sorting (default - null). Possible values: "id", "position", "title", "date", "price". Default: null.
+ * @property {string | null} [templateMarker] - Product page template marker, default null. Example: "template_12345".
+ * @property {string | null} [statusMarker] - Product page status marker, default null. Example: "in_stock".
+ * @property {string | null} [conditionValue] - The value that is being searched for, default null. Example: "new".
+ * @property {string | null} [attributeMarker] - The text identifier of the indexed attribute by which values are filtered, default null. Example: "color".
+ * @property {string | null} [conditionMarker] - Marker of the filter condition by which the values are filtered, default null. Example: "equals".
  * @description This interface defines the structure of a query for retrieving products, including pagination, sorting, and filtering parameters.
  */
 interface IProductsQuery {
@@ -211,21 +348,20 @@ interface IProductsQuery {
 /**
  * @interface IFilterParams
  *
- * @property {string | null} attributeMarker - The text identifier of the indexed attribute by which values are filtered, default null. Example: 'color'.
- * @property {string | null} [conditionMarker] - Id of the filter condition by which the values are filtered, default null. Example: 'equals'.
- * @property {number | null} conditionValue - The value that is being searched for, default null. Example: 'new'.
- * @property {Array<string> | null} [pageUrl] - Url of the category page object. Example: ['23-laminat-floorwood-maxima'].
- * @property {string | null} [statusMarker] - Text identifier of the product page status (default not set). Example: 'in_stock'.
- * @property {string | null} [title] - Product name. Example: 'Laminatboden Maxima'.
+ * @property {string | null} attributeMarker - The text identifier of the indexed attribute by which values are filtered. Default: null. Example: "color".
+ * @property {string | null} [conditionMarker] - Id of the filter condition by which the values are filtered. Default: null. Example: "equals".
+ * @property {number | null} conditionValue - The value that is being searched for, default null. Example: "new".
+ * @property {string | null} [pageUrl] - Url of the category page object. Example: ["23-laminat-floorwood-maxima"].
+ * @property {string | null} [statusMarker] - Text identifier of the product page status (default not set). Example: "in_stock".
+ * @property {string | null} [title] - Product name. Example: "Laminatboden Maxima".
  * @property {boolean} [isNested] - Flag for nested attributes, default false. Example: true.
- *
  * @description This interface defines the structure of filter parameters used for querying products, including conditions, attributes, and pagination.
  */
 interface IFilterParams {
     attributeMarker: string;
     conditionMarker?: 'in' /** 'in' - Contains */ | 'nin' /** 'nin' - Does not contain */ | 'eq' /** 'eq' - Equal */ | 'neq' /** 'neq' - Not equal */ | 'mth' /** 'mth' - Greater than */ | 'lth' /** 'lth' - Less than */ | 'exs' /** 'exs' - Exists */ | 'nexs' /** 'nexs' - Does not exist */ | null;
     conditionValue: number | string | null;
-    pageUrl?: Array<string> | null;
+    pageUrl?: string | null;
     statusMarker?: string;
     title?: string;
     isNested?: boolean;
@@ -234,88 +370,127 @@ interface IFilterParams {
  * @interface IProductsEntity
  *
  * @property {number} id - The unique identifier. Example: 12345.
- * @property {AttributeType} attributeValues - Array of attribute values from the index, represented. Example: [{ id: 'color', value: 'red' }].
- * @property {object} additional - Additional value from the index. Example: { prices: { min: 100, max: 200 } }.
- * @property {Record<string, any>} localizeInfos - The name of the products, taking into account localization. Example: .
+ * @property {ILocalizeInfo} localizeInfos - The name of the products, taking into account localization. Example:
+ * @property {string | null} statusIdentifier - Product page status identifiers (may be null). Example: "in_stock".
+ * @property {any} statusLocalizeInfos - JSON description of the item status object, taking into account the language. Example:
+ * @property {string | null} attributeSetIdentifier - Set of attributes id. Example: "set_12345".
+ * @property {number} position - Item number (for sorting). Example: 1.
+ * @property {string | null} [templateIdentifier] - User id of the linked template. Example: "template_12345".
+ * @property {string | null} [shortDescTemplateIdentifier] - User id of the linked template for a short description. Example: "short_desc_template_12345".
+ * @property {number} price - The value of the product page price taken from the index. Example: 150.00.
+ * @property {object} additional - Additional value from the index. Example:
+    {
+      "en": "In Stock",
+      "de": "Auf Lager"
+    }
+ * @property {string | null} sku - Product SKU (Stock Keeping Unit), may be null. Example: "SKU_12345".
+ * @property {boolean} isSync - Indication of page indexing. Example: true.
+ * @property {AttributeType} attributeValues - Array of attribute values from the index, represented. Example:
+    [
+      {
+        "id": "color",
+        "value": "red"
+      }
+    ]
+ * @property {string[]} categories - Product categories. Example: [1, 2, 3]
  * @property {boolean} isVisible - A sign of page visibility. Example: true.
+ * @property {any[]} [productPages] - Array of product pages or a single product page object. Example:
+ * @property {string[]} [blocks] - Array of block identifiers. Example:
+    [
+      "block_12345",
+      "block_67890"
+    ]
  * @property {boolean} isPositionLocked - Sorting position lock indicator (optional). Example: false.
- * @property {number | null} statusIdentifier - Product page status identifiers (may be null). Example: 'in_stock'.
- * @property {Array<number>} relatedIds - Ids of related product pages. Example: [12345, 67890].
- * @property {string} attributeSetIdentifier - Set of attributes id. Example: 'set_12345'.
- * @property {boolean} isSync - Indication of page indexing. Example: true.
- * @property {number} price - The value of the product page price taken from the index. Example: 150.00.
- * @property {string | null} templateIdentifier - User id of the linked template. Example: 'template_12345'.
- * @property {string | null} shortDescTemplateIdentifier - User id of the linked template for a short description. Example: 'short_desc_template_12345'.
- * @property {Record<string, any>} statusLocalizeInfos - JSON description of the item status object, taking into account the language. Example: { en: 'In Stock', de: 'Auf Lager' }.
- * @property {number} position - Item number (for sorting). Example: 1.
- * @property {string | null} sku - Product SKU (Stock Keeping Unit), may be null. Example: 'SKU_12345'.
- *
+ * @property {number[]} relatedIds - Ids of related product pages. Example: [12345, 67890].
  * @description This interface defines the structure of a product entity, including its identifiers, attributes, and related information.
  */
 interface IProductsEntity {
     id: number;
+    localizeInfos: ILocalizeInfo;
+    statusIdentifier: string | null;
+    statusLocalizeInfos: Record<string, any>;
+    attributeSetIdentifier: string | null;
+    moduleFormConfigs?: Array<IFormConfig>;
+    position: number;
+    templateIdentifier?: string | null;
+    shortDescTemplateIdentifier?: string | null;
+    price: number | null;
     additional: {
         prices: {
             min: number;
             max: number;
         };
     };
-    isPositionLocked?: boolean;
-    localizeInfos: Record<string, any>;
-    isVisible: boolean;
-    statusIdentifier: string | null;
-    attributeSetIdentifier: string | null;
+    sku: string | null;
     isSync: number | boolean;
-    price: number | null;
-    templateIdentifier: string | null;
-    shortDescTemplateIdentifier: string | null;
-    statusLocalizeInfos: Record<string, any>;
     attributeValues: AttributeType;
-    position: number;
-    sku: string | null;
-}
-/**
- * @interface IProductEntity
- *
- * @property {Array<string>} [blocks] - Array of block identifiers. Example: ['block_12345', 'block_67890'].
- * @property {Array<Record<string, any>> | Record<string, any>} [productPages] - Array of product pages or a single product page object. Example: [{ id: 12345, title: 'Product 1' }, { id: 67890, title: 'Product 2' }].
- *
- * @description This interface extends the IProductsEntity interface to include additional properties specific to product entities, such as blocks and product pages.
- */
-interface IProductEntity extends IProductsEntity {
-    blocks?: Array<string>;
+    categories: string[];
+    isVisible: boolean;
     productPages?: Array<Record<string, any>> | Record<string, any>;
+    blocks?: string[];
+    isPositionLocked?: boolean;
+    relatedIds?: number[];
 }
 /**
  * @interface IProductsResponse
  *
  * @property {number} total - The total number of products found. Example: 100.
- * @property {Array<IProductsEntity>} items - An array of product entities. Example: [{ id: 12345, title: 'Product 1' }, { id: 67890, title: 'Product 2' }].
- *
+ * @property {IProductsEntity[]} items - An array of product entities. Example:
+    [
+      {
+        "id": 12345,
+        "title": "Product 1"
+      },
+      {
+        "id": 67890,
+        "title": "Product 2"
+      }
+    ]
  * @description This interface defines the structure of a response containing multiple product entities, including the total count and an array of product items.
  */
 interface IProductsResponse {
+    items: IProductsEntity[];
     total: number;
-    items: Array<IProductsEntity>;
+}
+/**
+ * @interface IProductsCount
+ *
+ * @property {number} totalAll - The total number of products found. Example: 100.
+ * @property {number} totalInCategory - The total number of products found in category. Example: 50.
+ * @property {number} totalInCategoryWithNested - The total number of products found in nested category. Example: 10.
+ * @description This interface defines the structure of a response with total count of product items.
+ */
+interface IProductsCount {
+    totalAll: number;
+    totalInCategory: number;
+    totalInCategoryWithNested: number;
 }
 /**
  * @interface IProductsInfo
  *
  * @property {number} total - The total number of products found. Example: 100.
- * @property {Array<IProductInfo>} items - An array of product information objects. Example: [{ id: 12345, price: 150.00 }, { id: 67890, price: 200.00 }].
- *
+ * @property {IProductInfo[]} items - An array of product information objects. Example:
+    [
+      {
+        "id": 12345,
+        "price": 150.00
+      },
+      {
+        "id": 67890,
+        "price": 200.00
+      }
+    ]
  * @description This interface defines the structure of a response containing product information, including the total count and an array of product items.
  */
 interface IProductsInfo {
-    total: number;
     items: Array<IProductInfo>;
+    total: number;
 }
 /**
  * @interface IProductInfo
  *
  * @property {number} id - The unique identifier of the product. Example: 12345.
  * @property {number} price - The price of the product. Example: 150.00.
- *
  * @description This interface defines the structure of a product information object, including its identifier and price.
  */
 interface IProductInfo {
@@ -325,25 +500,33 @@ interface IProductInfo {
 /**
  * @interface IProductBlock
  *
- * @property {number} id - Unique identifier of the product block. Example: 12345.
+ * @property {number} id - Unique identifier of the product block. Example: 3289.
  * @property {number | null} attributeSetIdentifier - Identifier of the attribute set used in the product block, or null if not applicable. Example: 67890.
- * @property {Record<string, any>} localizeInfos - Localization information for the product block. Example: .
+ * @property {ILocalizeInfo} localizeInfos - Localization information for the product block. Example:
+    {
+      "title": "Box"
+    }
  * @property {number} version - Version of the product block entity. Example: 1.
  * @property {number} position - Position of the product block in a list or layout. Example: 1.
- * @property {string} identifier - Unique string identifier for the product block. Example: 'product_block_12345'.
- * @property {Types} type - Type of the product block, such as 'product', 'error_page', etc. Example: 'product'.
- * @property {object} customSettings - Custom settings for the product block, including slider delay, product configuration, similar product rules, and conditions. Example: .
- * @property {string | null} templateIdentifier - Identifier for the template used by the product block, or null if not applicable. Example: 'template_12345'.
+ * @property {string} identifier - Unique string identifier for the product block. Example: "product_block_12345".
+ * @property {Types} type - Type of the product block, such as "product", "error_page", etc. Example: "product".
+ * @property {object} customSettings - Custom settings for the product block, including slider delay, product configuration, similar product rules, and conditions. Example: {}
+ * @property {string | null} templateIdentifier - Identifier for the template used by the product block, or null if not applicable. Example: "template_12345".
  * @property {boolean} isVisible - Indicates whether the product block is visible. Example: true.
  * @property {boolean} isSync - Indicates whether the product block is synchronized. Example: false.
- * @property {AttributeType} attributeValues - Array of attribute values from the index, represented as a pair of user attribute id and attribute value. Example: [{ id: 'color', value: 'red' }].
- *
+ * @property {AttributeType} attributeValues - Array of attribute values from the index, represented as a pair of user attribute id and attribute value. Example:
+    [
+      {
+        "id": "color",
+        "value": "red"
+      }
+    ]
  * @description This interface defines the structure of a product block entity, including its identifiers, attributes, and custom settings.
  */
 interface IProductBlock {
     id: number;
     attributeSetIdentifier: number | null;
-    localizeInfos: Record<string, any>;
+    localizeInfos: ILocalizeInfo;
     version: number;
     position: number;
     identifier: string;
@@ -370,4 +553,4 @@ interface IProductBlock {
     isSync: boolean;
     attributeValues: AttributeType;
 }
-export type { IFilterParams, IProductApi, IProductBlock, IProductEntity, IProductInfo, IProductsEntity, IProductsInfo, IProductsQuery, IProductsResponse, };
+export type { IFilterParams, IProductApi, IProductBlock, IProductInfo, IProductsCount, IProductsEntity, IProductsInfo, IProductsQuery, IProductsResponse, };