oneentry 1.0.152 → 1.0.154

package/dist/products/productsApi.d.ts

@@ -1,7 +1,7 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
 import type { IError } from '../base/utils';
-import type { IAggregatedProductGroup, IFilterParams, IProductBlock, IProductsApi, IProductsCount, IProductsEntity, IProductsInfo, IProductsQuery, IProductsResponse, IVectorSearchProducts } from './productsInterfaces';
+import type { IAggregatedProductGroup, IFilterParams, IProductBlock, IProductsApi, IProductsByIdsQuery, IProductsCount, IProductsEntity, IProductsInfo, IProductsPriceQuery, IProductsQueryBase, IProductsRelatedQuery, IProductsResponse, IVectorSearchProducts } from './productsInterfaces';
 /**
  * Controllers for working with product pages
  * @handle /api/content/products
@@ -45,51 +45,44 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
           }
         ]
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {IProductsQuery} [userQuery] - Optional set query parameters.
+     * @param {IProductsQueryBase} [userQuery] - Optional set query parameters.
      * @example
         {
           "limit": 30,
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders",
-          "templateMarker": "template_12345",
-          "statusMarker": "in_stock",
-          "conditionValue": "new",
-          "conditionMarker": "eq",
-          "attributeMarker": "color"
+          "signPrice": "orders"
         }
-     * @param {string} [userQuery.signPrice] - Order storage marker for price fixing.
+     * @param {string} [userQuery.signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time. Example: "orders_storage".
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @param {string} [userQuery.sortOrder] - Sorting order parameter.
      * @returns {Promise<IProductsResponse | IError>} Products response, or IError when isShell=true
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Fetch products with optional filters and pagination.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProducts getProducts} documentation.
      */
-    getProducts(body?: IFilterParams[], langCode?: string, userQuery?: IProductsQuery): Promise<IProductsResponse | IError>;
+    getProducts(body?: IFilterParams[], langCode?: string, userQuery?: IProductsQueryBase): Promise<IProductsResponse | IError>;
     /**
      * Search for all product page objects with pagination (and aggregation) that do not have a category.
      * @handleName getProductsEmptyPage
      * @param {object} [body] - Request body. Default: {}.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {IProductsQuery} [userQuery] - Optional set query parameters.
+     * @param {IProductsQueryBase} [userQuery] - Optional set query parameters.
      * @example
         {
           "limit": 30,
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders",
-          "templateMarker": "template_12345",
-          "statusMarker": "in_stock",
-          "conditionValue": "new",
-          "conditionMarker": "eq",
-          "attributeMarker": "color"
+          "signPrice": "orders"
         }
      * @returns {Promise<IAggregatedProductGroup[] | IError>} Array with AggregatedProductGroup objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Search for all product page objects with pagination (and aggregation) that do not have a category.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsEmptyPage getProductsEmptyPage} documentation.
      */
-    getProductsEmptyPage(body?: object, langCode?: string, userQuery?: IProductsQuery): Promise<IAggregatedProductGroup[] | IError>;
+    getProductsEmptyPage(body?: object, langCode?: string, userQuery?: IProductsQueryBase): Promise<IAggregatedProductGroup[] | IError>;
     /**
      * Search for all products with pagination for the selected category.
      * @handleName getProductsByPageId
@@ -120,49 +113,41 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
           }
         ]
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {IProductsQuery} [userQuery] - Optional set query parameters.
+     * @param {IProductsQueryBase} [userQuery] - Optional set query parameters.
      * @example
         {
           "limit": 30,
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders",
-          "templateMarker": "template_12345",
-          "statusMarker": "in_stock",
-          "conditionValue": "new",
-          "conditionMarker": "eq",
-          "attributeMarker": "color"
+          "signPrice": "orders"
         }
      * @returns {Promise<IProductsResponse | IError>} Array with ProductEntity objects
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Fetch products by page ID with optional filters and pagination.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsByPageId getProductsByPageId} documentation.
      */
-    getProductsByPageId(id: number, body?: IFilterParams[], langCode?: string, userQuery?: IProductsQuery): Promise<IProductsResponse | IError>;
+    getProductsByPageId(id: number, body?: IFilterParams[], langCode?: string, userQuery?: IProductsQueryBase): Promise<IProductsResponse | IError>;
     /**
      * Search for information about products and prices for the selected category.
      * @handleName getProductsPriceByPageUrl
      * @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 {IProductsPriceQuery} [userQuery] - Optional set query parameters.
      * @example
         {
           "limit": 30,
           "offset": 0,
           "sortOrder": "DESC",
-          "sortKey": "id",
           "signPrice": "orders",
-          "templateMarker": "template_12345",
-          "statusMarker": "in_stock",
-          "conditionValue": "new",
-          "conditionMarker": "eq",
-          "attributeMarker": "color"
+          "statusMarker": "in_stock"
         }
      * @returns {Promise<IProductsInfo | IError>} Array with ProductInformation objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Search for information about products and prices for the selected category.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsPriceByPageUrl getProductsPriceByPageUrl} documentation.
      */
-    getProductsPriceByPageUrl(url: string, langCode?: string, userQuery?: IProductsQuery): Promise<IProductsInfo | IError>;
+    getProductsPriceByPageUrl(url: string, langCode?: string, userQuery?: IProductsPriceQuery): Promise<IProductsInfo | IError>;
     /**
      * Search for all products with pagination for the selected category.
      * @handleName getProductsByPageUrl
@@ -193,31 +178,27 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
           }
         ]
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {IProductsQuery} [userQuery] - Optional set query parameters.
+     * @param {IProductsQueryBase} [userQuery] - Optional set query parameters.
      * @example
         {
           "limit": 30,
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders",
-          "templateMarker": "template_12345",
-          "statusMarker": "in_stock",
-          "conditionValue": "new",
-          "conditionMarker": "eq",
-          "attributeMarker": "color"
+          "signPrice": "orders"
         }
      * @returns {Promise<IProductsResponse | IError>} Array with ProductEntity objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Search for all products with pagination for the selected category.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsByPageUrl getProductsByPageUrl} documentation.
      */
-    getProductsByPageUrl(url: string, body?: IFilterParams[], langCode?: string, userQuery?: IProductsQuery): Promise<IProductsResponse | IError>;
+    getProductsByPageUrl(url: string, body?: IFilterParams[], langCode?: string, userQuery?: IProductsQueryBase): Promise<IProductsResponse | IError>;
     /**
      * Find all related product page objects.
      * @handleName getRelatedProductsById
      * @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 {IProductsRelatedQuery} [userQuery] - Optional set query parameters.
      * @example
         {
           "limit": 30,
@@ -225,11 +206,8 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
           "sortOrder": "DESC",
           "sortKey": "id",
           "signPrice": "orders",
-          "templateMarker": "template_12345",
           "statusMarker": "in_stock",
-          "conditionValue": "new",
-          "conditionMarker": "eq",
-          "attributeMarker": "color"
+          "templateMarker": "template_12345"
         }
      * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30.
      * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0.
@@ -238,40 +216,30 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @returns {Promise<IProductsResponse | IError>} Array with ProductEntity objects
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Find all related product page objects.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getRelatedProductsById getRelatedProductsById} documentation.
      */
-    getRelatedProductsById(id: number, langCode?: string, userQuery?: IProductsQuery): Promise<IProductsResponse | IError>;
+    getRelatedProductsById(id: number, langCode?: string, userQuery?: IProductsRelatedQuery): Promise<IProductsResponse | IError>;
     /**
      * Find products by its ids.
      * @handleName getProductsByIds
      * @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 {IProductsByIdsQuery} [userQuery] - Optional set query parameters.
      * @example
         {
           "limit": 30,
           "offset": 0,
-          "sortOrder": "DESC",
-          "sortKey": "id",
-          "signPrice": "orders",
-          "templateMarker": "template_12345",
-          "statusMarker": "in_stock",
-          "conditionValue": "new",
-          "conditionMarker": "eq",
-          "attributeMarker": "color"
+          "signPrice": "orders"
         }
      * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30.
      * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0.
-     * @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 {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: "eq".
-     * @param {string} [userQuery.attributeMarker] - Optional text identifier of the indexed attribute by which values are filtered. Example: "color".
+     * @param {string} [userQuery.signPrice] - Order storage marker for price fixing.
      * @returns {Promise<IProductsEntity[] | IError>} Array with ProductEntity objects
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Find products by its ids.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsByIds getProductsByIds} documentation.
      */
-    getProductsByIds(ids: string, langCode?: string, userQuery?: IProductsQuery): Promise<IProductsEntity[] | IError>;
+    getProductsByIds(ids: string, langCode?: string, userQuery?: IProductsByIdsQuery): Promise<IProductsEntity[] | IError>;
     /**
      * Retrieve one product object.
      * @handleName getProductById
@@ -281,6 +249,7 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @returns {Promise<IProductsEntity | IError>} ProductEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Retrieve one product object.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductById getProductById} documentation.
      */
     getProductById(id: number, langCode?: string, isNormalized?: boolean): Promise<IProductsEntity | IError>;
     /**
@@ -290,6 +259,7 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @returns {Promise<IProductBlock | IError>} - Product block object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Getting a product block object by product id.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductBlockById getProductBlockById} documentation.
      */
     getProductBlockById(id: number): Promise<IProductBlock[] | IError>;
     /**
@@ -300,6 +270,7 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @returns {Promise<IProductsEntity[] | IError>} Array with ProductEntity objects
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Quick search for product page objects with limited output.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/searchProduct searchProduct} documentation.
      */
     searchProduct(name: string, langCode?: string): Promise<IProductsEntity[] | IError>;
     /**
@@ -322,6 +293,7 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @returns {Promise<IProductsCount | IError>} Object with product items count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method calculates and returns the total number of products present across the entire catalog, optionally applying specified filters.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsCount getProductsCount} documentation.
      */
     getProductsCount(body?: any[]): Promise<IProductsCount | IError>;
     /**
@@ -345,6 +317,7 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @returns {Promise<IProductsCount | IError>} Object with product items count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method calculates and returns the number of products available on a given catalog page, identified by its page ID, with optional filtering.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsCountByPageId getProductsCountByPageId} documentation.
      */
     getProductsCountByPageId(id: string, body?: any[]): Promise<IProductsCount | IError>;
     /**
@@ -368,6 +341,7 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @returns {Promise<IProductsCount | IError>} Object with product items count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method calculates and returns the number of products available on a given catalog page, identified by its URL, with optional filtering.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsCountByPageUrl getProductsCountByPageUrl} documentation.
      */
     /**
      * Semantic (vector) search for products.
@@ -379,6 +353,7 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @returns {Promise<IProductsEntity[] | IError>} Array with ProductEntity objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for products.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsByVectorSearch getProductsByVectorSearch} documentation.
      */
     getProductsByVectorSearch(body: IVectorSearchProducts, langCode?: string, offset?: number, limit?: number): Promise<IProductsEntity[] | IError>;
     /**

package/dist/products/productsApi.js

@@ -50,25 +50,22 @@ class ProductsApi extends asyncModules_1.default {
           }
         ]
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {IProductsQuery} [userQuery] - Optional set query parameters.
+     * @param {IProductsQueryBase} [userQuery] - Optional set query parameters.
      * @example
         {
           "limit": 30,
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders",
-          "templateMarker": "template_12345",
-          "statusMarker": "in_stock",
-          "conditionValue": "new",
-          "conditionMarker": "eq",
-          "attributeMarker": "color"
+          "signPrice": "orders"
         }
-     * @param {string} [userQuery.signPrice] - Order storage marker for price fixing.
+     * @param {string} [userQuery.signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time. Example: "orders_storage".
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @param {string} [userQuery.sortOrder] - Sorting order parameter.
      * @returns {Promise<IProductsResponse | IError>} Products response, or IError when isShell=true
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Fetch products with optional filters and pagination.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProducts getProducts} documentation.
      */
     async getProducts(body = [], langCode = this.state.lang, userQuery) {
         const query = {
@@ -85,23 +82,19 @@ class ProductsApi extends asyncModules_1.default {
      * @handleName getProductsEmptyPage
      * @param {object} [body] - Request body. Default: {}.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {IProductsQuery} [userQuery] - Optional set query parameters.
+     * @param {IProductsQueryBase} [userQuery] - Optional set query parameters.
      * @example
         {
           "limit": 30,
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders",
-          "templateMarker": "template_12345",
-          "statusMarker": "in_stock",
-          "conditionValue": "new",
-          "conditionMarker": "eq",
-          "attributeMarker": "color"
+          "signPrice": "orders"
         }
      * @returns {Promise<IAggregatedProductGroup[] | IError>} Array with AggregatedProductGroup objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Search for all product page objects with pagination (and aggregation) that do not have a category.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsEmptyPage getProductsEmptyPage} documentation.
      */
     async getProductsEmptyPage(body = {}, langCode = this.state.lang, userQuery) {
         const query = { ...userQuery, langCode };
@@ -138,23 +131,19 @@ class ProductsApi extends asyncModules_1.default {
           }
         ]
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {IProductsQuery} [userQuery] - Optional set query parameters.
+     * @param {IProductsQueryBase} [userQuery] - Optional set query parameters.
      * @example
         {
           "limit": 30,
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders",
-          "templateMarker": "template_12345",
-          "statusMarker": "in_stock",
-          "conditionValue": "new",
-          "conditionMarker": "eq",
-          "attributeMarker": "color"
+          "signPrice": "orders"
         }
      * @returns {Promise<IProductsResponse | IError>} Array with ProductEntity objects
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Fetch products by page ID with optional filters and pagination.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsByPageId getProductsByPageId} documentation.
      */
     async getProductsByPageId(id, body = [], langCode = this.state.lang, userQuery) {
         const query = { ...userQuery };
@@ -168,23 +157,19 @@ class ProductsApi extends asyncModules_1.default {
      * @handleName getProductsPriceByPageUrl
      * @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 {IProductsPriceQuery} [userQuery] - Optional set query parameters.
      * @example
         {
           "limit": 30,
           "offset": 0,
           "sortOrder": "DESC",
-          "sortKey": "id",
           "signPrice": "orders",
-          "templateMarker": "template_12345",
-          "statusMarker": "in_stock",
-          "conditionValue": "new",
-          "conditionMarker": "eq",
-          "attributeMarker": "color"
+          "statusMarker": "in_stock"
         }
      * @returns {Promise<IProductsInfo | IError>} Array with ProductInformation objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Search for information about products and prices for the selected category.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsPriceByPageUrl getProductsPriceByPageUrl} documentation.
      */
     async getProductsPriceByPageUrl(url, langCode = this.state.lang, userQuery) {
         const query = {
@@ -224,23 +209,19 @@ class ProductsApi extends asyncModules_1.default {
           }
         ]
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {IProductsQuery} [userQuery] - Optional set query parameters.
+     * @param {IProductsQueryBase} [userQuery] - Optional set query parameters.
      * @example
         {
           "limit": 30,
           "offset": 0,
           "sortOrder": "DESC",
           "sortKey": "id",
-          "signPrice": "orders",
-          "templateMarker": "template_12345",
-          "statusMarker": "in_stock",
-          "conditionValue": "new",
-          "conditionMarker": "eq",
-          "attributeMarker": "color"
+          "signPrice": "orders"
         }
      * @returns {Promise<IProductsResponse | IError>} Array with ProductEntity objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Search for all products with pagination for the selected category.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsByPageUrl getProductsByPageUrl} documentation.
      */
     async getProductsByPageUrl(url, body = [], langCode = this.state.lang, userQuery) {
         const query = { ...userQuery };
@@ -255,7 +236,7 @@ class ProductsApi extends asyncModules_1.default {
      * @handleName getRelatedProductsById
      * @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 {IProductsRelatedQuery} [userQuery] - Optional set query parameters.
      * @example
         {
           "limit": 30,
@@ -263,11 +244,8 @@ class ProductsApi extends asyncModules_1.default {
           "sortOrder": "DESC",
           "sortKey": "id",
           "signPrice": "orders",
-          "templateMarker": "template_12345",
           "statusMarker": "in_stock",
-          "conditionValue": "new",
-          "conditionMarker": "eq",
-          "attributeMarker": "color"
+          "templateMarker": "template_12345"
         }
      * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30.
      * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0.
@@ -276,6 +254,7 @@ class ProductsApi extends asyncModules_1.default {
      * @returns {Promise<IProductsResponse | IError>} Array with ProductEntity objects
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Find all related product page objects.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getRelatedProductsById getRelatedProductsById} documentation.
      */
     async getRelatedProductsById(id, langCode = this.state.lang, userQuery) {
         const query = { ...userQuery };
@@ -289,31 +268,20 @@ class ProductsApi extends asyncModules_1.default {
      * @handleName getProductsByIds
      * @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 {IProductsByIdsQuery} [userQuery] - Optional set query parameters.
      * @example
         {
           "limit": 30,
           "offset": 0,
-          "sortOrder": "DESC",
-          "sortKey": "id",
-          "signPrice": "orders",
-          "templateMarker": "template_12345",
-          "statusMarker": "in_stock",
-          "conditionValue": "new",
-          "conditionMarker": "eq",
-          "attributeMarker": "color"
+          "signPrice": "orders"
         }
      * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30.
      * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0.
-     * @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 {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: "eq".
-     * @param {string} [userQuery.attributeMarker] - Optional text identifier of the indexed attribute by which values are filtered. Example: "color".
+     * @param {string} [userQuery.signPrice] - Order storage marker for price fixing.
      * @returns {Promise<IProductsEntity[] | IError>} Array with ProductEntity objects
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Find products by its ids.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsByIds getProductsByIds} documentation.
      */
     async getProductsByIds(ids, langCode = this.state.lang, userQuery) {
         const query = {
@@ -333,6 +301,7 @@ class ProductsApi extends asyncModules_1.default {
      * @returns {Promise<IProductsEntity | IError>} ProductEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Retrieve one product object.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductById getProductById} documentation.
      */
     async getProductById(id, langCode = this.state.lang, isNormalized) {
         const query = { langCode };
@@ -350,6 +319,7 @@ class ProductsApi extends asyncModules_1.default {
      * @returns {Promise<IProductBlock | IError>} - Product block object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Getting a product block object by product id.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductBlockById getProductBlockById} documentation.
      */
     async getProductBlockById(id) {
         const response = await this._fetchGet(`/${id}/blocks`);
@@ -363,18 +333,16 @@ class ProductsApi extends asyncModules_1.default {
      * @returns {Promise<IProductsEntity[] | IError>} Array with ProductEntity objects
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Quick search for product page objects with limited output.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/searchProduct searchProduct} documentation.
      */
     async searchProduct(name, langCode = this.state.lang) {
-        const searchProducts = await this._fetchGet(`/quick/search?langCode=${langCode}&name=${name}`);
+        const searchProducts = await this._fetchGet(`/quick/search?langCode=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
         if (!this.state.traficLimit && Array.isArray(searchProducts)) {
             if (searchProducts.length === 0)
                 return searchProducts;
             const ids = searchProducts.map((product) => product.id);
             // One /ids request instead of one getProductById per result.
-            // limit is set to the number of ids so the default 30 does not truncate.
-            const products = await this.getProductsByIds(ids.join(','), langCode, {
-                limit: ids.length,
-            });
+            const products = await this.getProductsByIds(ids.join(','), langCode);
             if (!Array.isArray(products))
                 return products;
             // /ids re-sorts by id (DESC) by default, so restore the original
@@ -406,6 +374,7 @@ class ProductsApi extends asyncModules_1.default {
      * @returns {Promise<IProductsCount | IError>} Object with product items count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method calculates and returns the total number of products present across the entire catalog, optionally applying specified filters.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsCount getProductsCount} documentation.
      */
     async getProductsCount(
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -434,6 +403,7 @@ class ProductsApi extends asyncModules_1.default {
      * @returns {Promise<IProductsCount | IError>} Object with product items count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method calculates and returns the number of products available on a given catalog page, identified by its page ID, with optional filtering.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsCountByPageId getProductsCountByPageId} documentation.
      */
     async getProductsCountByPageId(id, 
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -462,6 +432,7 @@ class ProductsApi extends asyncModules_1.default {
      * @returns {Promise<IProductsCount | IError>} Object with product items count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method calculates and returns the number of products available on a given catalog page, identified by its URL, with optional filtering.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsCountByPageUrl getProductsCountByPageUrl} documentation.
      */
     /**
      * Semantic (vector) search for products.
@@ -473,6 +444,7 @@ class ProductsApi extends asyncModules_1.default {
      * @returns {Promise<IProductsEntity[] | IError>} Array with ProductEntity objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for products.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsByVectorSearch getProductsByVectorSearch} documentation.
      */
     async getProductsByVectorSearch(body, langCode = this.state.lang, offset = 0, limit = 30) {
         const query = {