oneentry 1.0.153 → 1.0.154

package/dist/blocks/blocksApi.d.ts

@@ -66,7 +66,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @param {number} [productId] - Optional product id to find similar products for.
      * @returns {Promise<IProductsResponse | IError>} Returns the total count and an array of product items in object by specified block marker.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -80,7 +81,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Return array of BlocksEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getProductsByBlockMarker getProductsByBlockMarker} documentation.
@@ -92,7 +94,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @param {number} productId - Product id. Example: 1.
      * @param {string} marker - Block marker. Example: "frequently_ordered_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsResponse | IError>} Returns a products response with items and total.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getFrequentlyOrderedProducts getFrequentlyOrderedProducts} documentation.
@@ -113,7 +116,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getCartComplement
      * @param {string} marker - Block marker. Example: "cart_complement_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartComplement getCartComplement} documentation.
@@ -139,7 +143,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getCartSimilar
      * @param {string} marker - Block marker. Example: "cart_similar_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartSimilar getCartSimilar} documentation.
@@ -165,7 +170,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getPersonalRecommendations
      * @param {string} marker - Block marker. Example: "personal_recommendations_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getPersonalRecommendations getPersonalRecommendations} documentation.
@@ -176,7 +182,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getRecentlyViewed
      * @param {string} marker - Block marker. Example: "recently_viewed_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getRecentlyViewed getRecentlyViewed} documentation.
@@ -187,7 +194,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getRepeatPurchase
      * @param {string} marker - Block marker. Example: "repeat_purchase_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getRepeatPurchase getRepeatPurchase} documentation.
@@ -207,7 +215,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getTrending
      * @param {string} marker - Block marker. Example: "trending_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getTrending getTrending} documentation.
@@ -218,7 +227,8 @@ export default class BlocksApi extends AsyncModules implements IBlocks {
      * @handleName getWishlistSimilar
      * @param {string} marker - Block marker. Example: "wishlist_similar_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getWishlistSimilar getWishlistSimilar} documentation.

package/dist/blocks/blocksApi.js

@@ -130,7 +130,8 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @param {number} [productId] - Optional product id to find similar products for.
      * @returns {Promise<IProductsResponse | IError>} Returns the total count and an array of product items in object by specified block marker.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -154,7 +155,8 @@ class BlocksApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Return array of BlocksEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getProductsByBlockMarker getProductsByBlockMarker} documentation.
@@ -175,7 +177,8 @@ class BlocksApi extends asyncModules_1.default {
      * @param {number} productId - Product id. Example: 1.
      * @param {string} marker - Block marker. Example: "frequently_ordered_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsResponse | IError>} Returns a products response with items and total.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getFrequentlyOrderedProducts getFrequentlyOrderedProducts} documentation.
@@ -199,7 +202,7 @@ class BlocksApi extends asyncModules_1.default {
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/searchBlock searchBlock} documentation.
      */
     async searchBlock(name, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/quick/search?langCode=${langCode}&name=${name}`);
+        const result = await this._fetchGet(`/quick/search?langCode=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, blocksSchemas_1.SearchBlocksResponseSchema);
         return validated;
@@ -209,7 +212,8 @@ class BlocksApi extends asyncModules_1.default {
      * @handleName getCartComplement
      * @param {string} marker - Block marker. Example: "cart_complement_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartComplement getCartComplement} documentation.
@@ -242,7 +246,8 @@ class BlocksApi extends asyncModules_1.default {
      * @handleName getCartSimilar
      * @param {string} marker - Block marker. Example: "cart_similar_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getCartSimilar getCartSimilar} documentation.
@@ -275,7 +280,8 @@ class BlocksApi extends asyncModules_1.default {
      * @handleName getPersonalRecommendations
      * @param {string} marker - Block marker. Example: "personal_recommendations_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getPersonalRecommendations getPersonalRecommendations} documentation.
@@ -290,7 +296,8 @@ class BlocksApi extends asyncModules_1.default {
      * @handleName getRecentlyViewed
      * @param {string} marker - Block marker. Example: "recently_viewed_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getRecentlyViewed getRecentlyViewed} documentation.
@@ -305,7 +312,8 @@ class BlocksApi extends asyncModules_1.default {
      * @handleName getRepeatPurchase
      * @param {string} marker - Block marker. Example: "repeat_purchase_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getRepeatPurchase getRepeatPurchase} documentation.
@@ -332,7 +340,8 @@ class BlocksApi extends asyncModules_1.default {
      * @handleName getTrending
      * @param {string} marker - Block marker. Example: "trending_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getTrending getTrending} documentation.
@@ -347,7 +356,8 @@ class BlocksApi extends asyncModules_1.default {
      * @handleName getWishlistSimilar
      * @param {string} marker - Block marker. Example: "wishlist_similar_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {Promise<IProductsEntity[] | IError>} Returns an array of products.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/getWishlistSimilar getWishlistSimilar} documentation.

package/dist/blocks/blocksInterfaces.d.ts

@@ -46,7 +46,8 @@ interface IBlocks {
      * @param {number} productId - Product id. Example: 1.
      * @param {string} marker - Block marker. Example: "frequently_ordered_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {IProductsResponse} A promise that resolves to a products response (items + total) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -56,7 +57,8 @@ interface IBlocks {
      * @handleName getCartComplement
      * @param {string} marker - Block marker. Example: "cart_complement_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -80,7 +82,8 @@ interface IBlocks {
      * @handleName getCartSimilar
      * @param {string} marker - Block marker. Example: "cart_similar_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -104,7 +107,8 @@ interface IBlocks {
      * @handleName getPersonalRecommendations
      * @param {string} marker - Block marker. Example: "personal_recommendations_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -114,7 +118,8 @@ interface IBlocks {
      * @handleName getRecentlyViewed
      * @param {string} marker - Block marker. Example: "recently_viewed_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -124,7 +129,8 @@ interface IBlocks {
      * @handleName getRepeatPurchase
      * @param {string} marker - Block marker. Example: "repeat_purchase_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -142,7 +148,8 @@ interface IBlocks {
      * @handleName getTrending
      * @param {string} marker - Block marker. Example: "trending_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -152,7 +159,8 @@ interface IBlocks {
      * @handleName getWishlistSimilar
      * @param {string} marker - Block marker. Example: "wishlist_similar_block".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {string} [signPrice] - Sign price.
+     * @param {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+     * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
      * @returns {IProductsEntity[]} A promise that resolves to an array of products or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
@@ -302,7 +310,8 @@ type BlockType = 'product' | 'error_page' | 'catalog_page' | 'product_preview' |
  * @property {number[]} productIds - Product identifiers to look up. Example: [1, 2, 3].
  * @property {string} [langCode] - Language code. Default: "en_US".
  * @property {number} [limit] - Max number of products to return. Example: 10.
- * @property {string} [signPrice] - Sign price.
+ * @property {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
+ * @see {@link https://js-sdk.oneentry.cloud/docs/blocks/#Fixing-the-price-signPrice Fixing the price} documentation.
  * @description Body for the POST block product endpoints (cart-complement / cart-similar / wishlist-similar) that accept an explicit list of productIds.
  */
 interface IBlockProductsLookup {

package/dist/index.js

@@ -53,6 +53,18 @@ const wsApi_1 = __importDefault(require("./web-socket/wsApi"));
  * @description Define API.
  */
 function defineOneEntry(url, config) {
+    if (typeof url !== 'string' || url.trim() === '') {
+        throw new Error('OneEntry SDK: project URL is required to initialize the SDK. ' +
+            'Pass a non-empty URL as the first argument of defineOneEntry, e.g. ' +
+            'defineOneEntry("https://your-project.oneentry.cloud", { token: "your-app-token" }).');
+    }
+    if (!config ||
+        typeof config.token !== 'string' ||
+        config.token.trim() === '') {
+        throw new Error('OneEntry SDK: app token is required to initialize the SDK. ' +
+            'Pass it via config, e.g. ' +
+            'defineOneEntry("https://your-project.oneentry.cloud", { token: "your-app-token" }).');
+    }
     const stateModule = new stateModule_1.default(url.endsWith('/') ? url.slice(0, -1) : url, config);
     const Admins = new adminsApi_1.default(stateModule);
     const AttributesSets = new attributeSetsApi_1.default(stateModule);

package/dist/orders/ordersInterfaces.d.ts

@@ -267,6 +267,7 @@ interface IOrdersFormData {
  * @property {number} productId - Product identifier. Example: 1.
  * @property {number} quantity - Quantity of the product. Example: 2.
  * @property {string} [signedPrice] - The signed price of the product is obtained along with the product data when `signPrice` is set. Example: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...".
+ * @see {@link https://js-sdk.oneentry.cloud/docs/orders/#Fixed-product-price-signedPrice Fixed product price} documentation.
  * @description Represents a product data in an order.
  */
 interface IOrderProductData {

package/dist/pages/pagesApi.js

@@ -208,7 +208,8 @@ class PagesApi extends asyncModules_1.default {
      */
     async searchPage(name, url, langCode = this.state.lang) {
         // Fetch data from the server using a GET request to perform a quick search by page name and language code
-        const data = await this._fetchGet(`/quick/search?${url && 'url=' + url}&lang=${langCode}&name=${name}`);
+        const urlPart = url ? `url=${encodeURIComponent(url)}&` : '';
+        const data = await this._fetchGet(`/quick/search?${urlPart}lang=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
         // /quick/search?url=catalog&langCode=en_US&name=cat
         // Check if there is no traffic limit set in the state
         if (!this.state.traficLimit && Array.isArray(data)) {

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,53 +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
@@ -122,51 +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
@@ -197,32 +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,
@@ -230,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.
@@ -245,40 +218,28 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @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