oneentry 1.0.177 → 1.0.178

package/esm/forms-data/formsDataApi.d.ts

@@ -136,11 +136,21 @@ export default class FormsDataApi extends AsyncModules implements IFormsData {
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/getFormsDataByMarker getFormsDataByMarker} documentation.
      */
     getFormsDataByMarker(marker: string, formModuleConfigId: number, body?: IFormsDataFilter, isExtended?: number, langCode?: string, offset?: number, limit?: number): Promise<IFormsByMarkerDataEntity | IError>;
+    /**
+     * Wrap the caller's flat `formData` array under its language code and upload any
+     * file fields, so the submit endpoints receive `{ [langCode]: [...] }`. Shared by
+     * postFormsData and updateFormsDataByid so the two never diverge.
+     * @param {FormDataType[]} rawFormData - Flat array of form fields.
+     * @param {string} langCode - Language code the fields are wrapped under.
+     * @returns {Promise<object>} The locale-keyed formData and the first upload error, if any.
+     */
+    private _buildLocalizedFormData;
     /**
      * Update one object of form data by id. Requires user authentication.
      * @handleName updateFormsDataByid
      * @param {number} id - Form data ID. Example: 1.
-     * @param {object} [body] - Form data to save: the same fields as in `postFormsData` (`formIdentifier`, `formModuleConfigId`, `moduleEntityIdentifier`, `replayTo`, `status`, `formData`). Default: `{}`.
+     * @param {IBodyPostFormData} body - Form data to save: the same fields as in `postFormsData` (`formIdentifier`, `formModuleConfigId`, `moduleEntityIdentifier`, `replayTo`, `status`, `formData`). The flat `formData` array is wrapped under `langCode` before sending, exactly like `postFormsData`.
+     * @param {string} [langCode] - Language code the form fields are saved under. Default: "en_US".
      * @example
         {
           "formIdentifier": "test-form",
@@ -159,7 +169,7 @@ export default class FormsDataApi extends AsyncModules implements IFormsData {
      * @returns {Promise<IUpdateFormsData | IError>} Returns an object containing the updated form data or an error object if there was an issue.
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/updateFormsDataByid updateFormsDataByid} documentation.
      */
-    updateFormsDataByid(id: number, body?: object): Promise<IUpdateFormsData | IError>;
+    updateFormsDataByid(id: number, body: IBodyPostFormData, langCode?: string): Promise<IUpdateFormsData | IError>;
     /**
      * Update form data status by id. Requires user authentication.
      * @handleName updateFormsDataStatusByid

package/esm/forms-data/formsDataApi.js

@@ -66,73 +66,8 @@ export default class FormsDataApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/postFormsData postFormsData} documentation.
      */
     async postFormsData(body, langCode = this.state.lang) {
-        const formData = {};
-        // filter button fields; keep spam fields so the captcha token in their `value` reaches the server
-        formData[langCode] = Array.isArray(body.formData)
-            ? body.formData.filter((fd) => fd.type !== 'button')
-            : [body.formData].filter((fd) => fd.type !== 'button');
-        /**
-         * Handle file uploads if fileQuery is present
-         * Check if there is any element in formData[langCode] that contains one of the specified types
-         */
-        if (formData[langCode].find((fd) => ['file', 'image', 'groupOfImages'].includes(fd.type))) {
-            // Create an instance of FileUploadingApi with the current state
-            const fileUploader = new FileUploadingApi(this.state);
-            // Process each element in formData[langCode] asynchronously
-            formData[langCode] = await Promise.all(formData[langCode].map(async (field) => {
-                // Check if the type is one of the specified types
-                if (['file', 'image', 'groupOfImages'].includes(field.type)) {
-                    // Work on a copy: the caller's field keeps its File and its fileQuery,
-                    // so a reused body sends the same form again (CMS-1071)
-                    const fd = { ...field };
-                    // If fileQuery does not exist, we create it and assign it to an object with the following properties:
-                    if (!fd.fileQuery) {
-                        const fileQuery = {
-                            type: 'page',
-                            entity: 'editor',
-                            // Generate a random 4-digit ID
-                            id: Number(Math.floor(Math.random() * 10000)
-                                .toString()
-                                .padStart(4, '0')),
-                        };
-                        fd.fileQuery = fileQuery;
-                    }
-                    // Convert fd.value to an array if it is a FileList, otherwise use it directly
-                    const filesArray = typeof FileList !== 'undefined' && fd.value instanceof FileList
-                        ? Array.from(fd.value)
-                        : fd.value;
-                    // If filesArray is an array, upload the files it holds asynchronously
-                    if (Array.isArray(filesArray)) {
-                        const uploadPromises = filesArray.map((file) => 
-                        // An entry that is already in storage is passed through: a
-                        // second upload would send the descriptor itself as the file
-                        // and the endpoint answers `value[0].filename is required`.
-                        this._isUploadable(file)
-                            ? fileUploader.upload(file, fd.fileQuery).catch((e) => e)
-                            : file);
-                        fd.value = (await Promise.all(uploadPromises)).flat();
-                    }
-                    // If fd.value is a single File or Blob, upload it
-                    else if (this._isUploadable(fd.value)) {
-                        fd.value = await fileUploader
-                            .upload(fd.value, fd.fileQuery)
-                            .catch((e) => e); // Catch any errors during upload
-                    }
-                    // Remove the 'fileQuery' property from the object after processing
-                    delete fd.fileQuery;
-                    // Remove the 'contentType' property from the file object because it is not needed and not valid
-                    fd.value = this._stripContentType(fd.value);
-                    return fd;
-                }
-                // Return the form data element untouched
-                return field;
-            }));
-        }
-        // A failed upload used to be sent to the platform as the field's value, and the caller
-        // got a success: the form is not sent, the upload's error is the answer
-        const uploadError = formData[langCode]
-            .flatMap((field) => Array.isArray(field === null || field === void 0 ? void 0 : field.value) ? field.value : [field === null || field === void 0 ? void 0 : field.value])
-            .find((value) => this._isErrorResponse(value));
+        // Wrap the flat formData under langCode (and upload any files) before sending
+        const { formData, uploadError } = await this._buildLocalizedFormData(body.formData, langCode);
         if (uploadError) {
             if (this.state.isShell) {
                 return uploadError;
@@ -250,11 +185,90 @@ export default class FormsDataApi extends AsyncModules {
         const validated = await this._validateResponse(result, schema('FormsByMarkerDataResponseSchema'));
         return this._normalizeData(validated, langCode);
     }
+    /**
+     * Wrap the caller's flat `formData` array under its language code and upload any
+     * file fields, so the submit endpoints receive `{ [langCode]: [...] }`. Shared by
+     * postFormsData and updateFormsDataByid so the two never diverge.
+     * @param {FormDataType[]} rawFormData - Flat array of form fields.
+     * @param {string} langCode - Language code the fields are wrapped under.
+     * @returns {Promise<object>} The locale-keyed formData and the first upload error, if any.
+     */
+    async _buildLocalizedFormData(rawFormData, langCode) {
+        const formData = {};
+        // filter button fields; keep spam fields so the captcha token in their `value` reaches the server
+        formData[langCode] = Array.isArray(rawFormData)
+            ? rawFormData.filter((fd) => fd.type !== 'button')
+            : [rawFormData].filter((fd) => fd.type !== 'button');
+        /**
+         * Handle file uploads if fileQuery is present
+         * Check if there is any element in formData[langCode] that contains one of the specified types
+         */
+        if (formData[langCode].find((fd) => ['file', 'image', 'groupOfImages'].includes(fd.type))) {
+            // Create an instance of FileUploadingApi with the current state
+            const fileUploader = new FileUploadingApi(this.state);
+            // Process each element in formData[langCode] asynchronously
+            formData[langCode] = await Promise.all(formData[langCode].map(async (field) => {
+                // Check if the type is one of the specified types
+                if (['file', 'image', 'groupOfImages'].includes(field.type)) {
+                    // Work on a copy: the caller's field keeps its File and its fileQuery,
+                    // so a reused body sends the same form again (CMS-1071)
+                    const fd = { ...field };
+                    // If fileQuery does not exist, we create it and assign it to an object with the following properties:
+                    if (!fd.fileQuery) {
+                        const fileQuery = {
+                            type: 'page',
+                            entity: 'editor',
+                            // Generate a random 4-digit ID
+                            id: Number(Math.floor(Math.random() * 10000)
+                                .toString()
+                                .padStart(4, '0')),
+                        };
+                        fd.fileQuery = fileQuery;
+                    }
+                    // Convert fd.value to an array if it is a FileList, otherwise use it directly
+                    const filesArray = typeof FileList !== 'undefined' && fd.value instanceof FileList
+                        ? Array.from(fd.value)
+                        : fd.value;
+                    // If filesArray is an array, upload the files it holds asynchronously
+                    if (Array.isArray(filesArray)) {
+                        const uploadPromises = filesArray.map((file) => 
+                        // An entry that is already in storage is passed through: a
+                        // second upload would send the descriptor itself as the file
+                        // and the endpoint answers `value[0].filename is required`.
+                        this._isUploadable(file)
+                            ? fileUploader.upload(file, fd.fileQuery).catch((e) => e)
+                            : file);
+                        fd.value = (await Promise.all(uploadPromises)).flat();
+                    }
+                    // If fd.value is a single File or Blob, upload it
+                    else if (this._isUploadable(fd.value)) {
+                        fd.value = await fileUploader
+                            .upload(fd.value, fd.fileQuery)
+                            .catch((e) => e); // Catch any errors during upload
+                    }
+                    // Remove the 'fileQuery' property from the object after processing
+                    delete fd.fileQuery;
+                    // Remove the 'contentType' property from the file object because it is not needed and not valid
+                    fd.value = this._stripContentType(fd.value);
+                    return fd;
+                }
+                // Return the form data element untouched
+                return field;
+            }));
+        }
+        // A failed upload used to be sent to the platform as the field's value, and the caller
+        // got a success: the form is not sent, the upload's error is the answer
+        const uploadError = formData[langCode]
+            .flatMap((field) => Array.isArray(field === null || field === void 0 ? void 0 : field.value) ? field.value : [field === null || field === void 0 ? void 0 : field.value])
+            .find((value) => this._isErrorResponse(value));
+        return { formData, uploadError };
+    }
     /**
      * Update one object of form data by id. Requires user authentication.
      * @handleName updateFormsDataByid
      * @param {number} id - Form data ID. Example: 1.
-     * @param {object} [body] - Form data to save: the same fields as in `postFormsData` (`formIdentifier`, `formModuleConfigId`, `moduleEntityIdentifier`, `replayTo`, `status`, `formData`). Default: `{}`.
+     * @param {IBodyPostFormData} body - Form data to save: the same fields as in `postFormsData` (`formIdentifier`, `formModuleConfigId`, `moduleEntityIdentifier`, `replayTo`, `status`, `formData`). The flat `formData` array is wrapped under `langCode` before sending, exactly like `postFormsData`.
+     * @param {string} [langCode] - Language code the form fields are saved under. Default: "en_US".
      * @example
         {
           "formIdentifier": "test-form",
@@ -273,11 +287,21 @@ export default class FormsDataApi extends AsyncModules {
      * @returns {Promise<IUpdateFormsData | IError>} Returns an object containing the updated form data or an error object if there was an issue.
      * @see {@link https://js-sdk.oneentry.cloud/docs/forms-data/updateFormsDataByid updateFormsDataByid} documentation.
      */
-    async updateFormsDataByid(id, body = {}) {
-        const result = await this._fetchPut(`/${this._pathSegment(String(id))}`, body);
+    async updateFormsDataByid(id, body, langCode = this.state.lang) {
+        // Wrap the flat formData under langCode (and upload any files) — the endpoint
+        // rejects a flat array with `400 formData must be ... keyed by lang code`
+        const { formData, uploadError } = await this._buildLocalizedFormData(body.formData, langCode);
+        if (uploadError) {
+            if (this.state.isShell) {
+                return uploadError;
+            }
+            throw uploadError;
+        }
+        const result = await this._fetchPut(`/${this._pathSegment(String(id))}`, { ...body, formData });
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('UpdateFormsDataSchema'));
-        return validated;
+        // The fields went in under `langCode`, so unwrap the response from the same locale
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Update form data status by id. Requires user authentication.

package/esm/pages/pagesApi.d.ts

@@ -86,12 +86,13 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @param {string} name - Text to search for in page titles (`localizeInfos.title`) in the requested language. Example: "About Us".
      * @param {string} [url] - Page URL. Example: "catalog".
      * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {boolean} [correct] - Correct typos by the project's search dictionary first. The API defaults to `true`; pass `false` to search the query as is.
      * @returns {Promise<IPagesEntity[] | IPageSearchResult[] | IError>} Returns found pages as an array of PageEntity objects, an array of short PageSearchResult cards when the traficLimit config option is enabled, or an empty array [] (if there is no data)
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Quick search for page objects with limited output. The quick search endpoint returns short cards ({ id, title }); with traficLimit enabled they are returned as is, otherwise full page entities are fetched for the found ids. The search runs in `langCode`, and a found page that cannot be loaded in that language is left out of the result.
      * @see {@link https://js-sdk.oneentry.cloud/docs/pages/searchPage searchPage} documentation.
      */
-    searchPage(name: string, url?: string, langCode?: string): Promise<IPagesEntity[] | IPageSearchResult[] | IError>;
+    searchPage(name: string, url?: string, langCode?: string, correct?: boolean): Promise<IPagesEntity[] | IPageSearchResult[] | IError>;
     /**
      * Semantic (vector) search for pages.
      * @handleName getPagesByVectorSearch

package/esm/pages/pagesApi.js

@@ -185,15 +185,17 @@ export default class PagesApi extends AsyncModules {
      * @param {string} name - Text to search for in page titles (`localizeInfos.title`) in the requested language. Example: "About Us".
      * @param {string} [url] - Page URL. Example: "catalog".
      * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {boolean} [correct] - Correct typos by the project's search dictionary first. The API defaults to `true`; pass `false` to search the query as is.
      * @returns {Promise<IPagesEntity[] | IPageSearchResult[] | IError>} Returns found pages as an array of PageEntity objects, an array of short PageSearchResult cards when the traficLimit config option is enabled, or an empty array [] (if there is no data)
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Quick search for page objects with limited output. The quick search endpoint returns short cards ({ id, title }); with traficLimit enabled they are returned as is, otherwise full page entities are fetched for the found ids. The search runs in `langCode`, and a found page that cannot be loaded in that language is left out of the result.
      * @see {@link https://js-sdk.oneentry.cloud/docs/pages/searchPage searchPage} documentation.
      */
-    async searchPage(name, url, langCode = this.state.lang) {
+    async searchPage(name, url, langCode = this.state.lang, correct) {
         // Fetch data from the server using a GET request to perform a quick search by page name and language code
         const urlPart = url ? `url=${encodeURIComponent(url)}&` : '';
-        const searchPages = await this._fetchGet(`/quick/search?${urlPart}langCode=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
+        const correctPart = correct !== undefined ? `&correct=${correct}` : '';
+        const searchPages = await this._fetchGet(`/quick/search?${urlPart}langCode=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}${correctPart}`);
         // Validate response if validation is enabled
         const data = (await this._validateResponse(searchPages, schema('PageSearchResponseSchema')));
         // Check if there is no traffic limit set in the state

package/esm/pages/pagesInterfaces.d.ts

@@ -72,11 +72,12 @@ interface IPagesApi {
      * @param {string} name - Text to search for in page titles (`localizeInfos.title`) in the requested language. Example: "About Us".
      * @param {string} [url] - Optional page URL to filter search results. Example: "catalog".
      * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {boolean} [correct] - Correct typos by the project's search dictionary first. The API defaults to `true`; pass `false` to search the query as is.
      * @returns {IPagesEntity[] | IPageSearchResult[]} Returns found pages as an array of PageEntity objects, an array of short PageSearchResult cards when the traficLimit config option is enabled, or an empty array [] (if there is no data)
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method performs a quick search for page objects with limited output. With traficLimit enabled the raw quick search response is returned as short cards; otherwise full page entities are fetched for the found ids.
      */
-    searchPage(name: string, url?: string, langCode?: LangType): Promise<IPagesEntity[] | IPageSearchResult[] | IError>;
+    searchPage(name: string, url?: string, langCode?: LangType, correct?: boolean): Promise<IPagesEntity[] | IPageSearchResult[] | IError>;
     /**
      * Semantic (vector) search for pages.
      * @handleName getPagesByVectorSearch

package/esm/products/productsApi.d.ts

@@ -247,12 +247,13 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @param {number} id - Product ID. Example: 12345.
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {boolean} [isNormalized] - Deprecated: the API no longer reads it, the answer is the same with `true`, `false` or without it. Kept for compatibility.
+     * @param {string} [signPrice] - Marker of an orders storage to fix the price for. When set, the product comes with a `signedPrice` holding the price for a limited time; an unknown marker fails the request with `404 Specified orders storage for price signature not found`.
      * @returns {Promise<IProductsEntity | IError>} ProductEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Retrieve one product object. A product with no translation in `langCode` answers `404 Product not found` — there is no fallback to another language.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductById getProductById} documentation.
      */
-    getProductById(id: number, langCode?: string, isNormalized?: boolean): Promise<IProductsEntity | IError>;
+    getProductById(id: number, langCode?: string, isNormalized?: boolean, signPrice?: string): Promise<IProductsEntity | IError>;
     /**
      * Getting a product block object by product id.
      * @handleName getProductBlockById
@@ -269,16 +270,19 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @handleName searchProduct
      * @param {string} name - Text to search for in product titles (`localizeInfos.title`) in the requested language. Example: "laminat".
      * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [url] - URL of a catalog page to search within that category. Default: the whole catalog.
+     * @param {boolean} [correct] - Correct typos by the project's search dictionary first. The API defaults to `true`; pass `false` to search the query as is.
      * @returns {Promise<IProductsEntity[] | IProductSearchResult[] | IError>} Array with ProductEntity objects, or an array with short ProductSearchResult cards when the traficLimit config option is enabled
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Quick search for product page objects with limited output. The quick search endpoint returns short cards ({ id, title, pageId }); with traficLimit enabled they are returned as is, otherwise full product entities are fetched for the found ids.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/searchProduct searchProduct} documentation.
      */
-    searchProduct(name: string, langCode?: string): Promise<IProductsEntity[] | IProductSearchResult[] | IError>;
+    searchProduct(name: string, langCode?: string, url?: string, correct?: boolean): Promise<IProductsEntity[] | IProductSearchResult[] | IError>;
     /**
      * Getting the number of products for the entire catalog.
      * @handleName getProductsCount
      * @param {any[]} [body] - Filter objects with search conditions. Default: `[]`.
+     * @param {string} [langCode] - Language code. Default: "en_US". Must be one of the project's active languages — an inactive one answers `400 langCode must be one of the active languages`. The count reflects the products visible in that language.
      * @example
         [
           {
@@ -289,15 +293,16 @@ 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.
+     * @description This method calculates and returns the total number of products present across the entire catalog, optionally applying specified filters. The request carries `langCode`; it must be an active language of the project, otherwise the API answers `400`.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsCount getProductsCount} documentation.
      */
-    getProductsCount(body?: any[]): Promise<IProductsCount | IError>;
+    getProductsCount(body?: any[], langCode?: string): Promise<IProductsCount | IError>;
     /**
      * Getting the number of products on a catalog page by page ID.
      * @handleName getProductsCountByPageId
      * @param {number | string} id - Page ID. Example: 12345.
      * @param {any[]} [body] - Filter objects with search conditions. Default: `[]`.
+     * @param {string} [langCode] - Language code. Default: "en_US". Must be one of the project's active languages — an inactive one answers `400 langCode must be one of the active languages`. The count reflects the products visible in that language.
      * @example
         [
           {
@@ -308,10 +313,10 @@ 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. The counts do not depend on the language: on a language where the catalog is empty they still count every product (CMS-1201).
+     * @description This method calculates and returns the number of products available on a given catalog page, identified by its page ID, with optional filtering. The request carries `langCode`; it must be an active language of the project (an inactive one answers `400`), and the count reflects the products visible in that language.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsCountByPageId getProductsCountByPageId} documentation.
      */
-    getProductsCountByPageId(id: number | string, body?: any[]): Promise<IProductsCount | IError>;
+    getProductsCountByPageId(id: number | string, body?: any[], langCode?: string): Promise<IProductsCount | IError>;
     /**
      * Semantic (vector) search for products.
      * @handleName getProductsByVectorSearch
@@ -330,6 +335,7 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @handleName getProductsCountByPageUrl
      * @param {string} url - Page URL. Example: "catalog".
      * @param {any[]} [body] - Filter objects with search conditions. Default: `[]`.
+     * @param {string} [langCode] - Language code. Default: "en_US". Must be one of the project's active languages — an inactive one answers `400 langCode must be one of the active languages`. The count reflects the products visible in that language.
      * @example
         [
           {
@@ -340,8 +346,8 @@ 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. The counts do not depend on the language: on a language where the catalog is empty they still count every product (CMS-1201).
+     * @description This method calculates and returns the number of products available on a given catalog page, identified by its URL, with optional filtering. The request carries `langCode`; it must be an active language of the project (an inactive one answers `400`), and the count reflects the products visible in that language.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsCountByPageUrl getProductsCountByPageUrl} documentation.
      */
-    getProductsCountByPageUrl(url: string, body?: any[]): Promise<IProductsCount | IError>;
+    getProductsCountByPageUrl(url: string, body?: any[], langCode?: string): Promise<IProductsCount | IError>;
 }

package/esm/products/productsApi.js

@@ -301,15 +301,18 @@ export default class ProductsApi extends AsyncModules {
      * @param {number} id - Product ID. Example: 12345.
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {boolean} [isNormalized] - Deprecated: the API no longer reads it, the answer is the same with `true`, `false` or without it. Kept for compatibility.
+     * @param {string} [signPrice] - Marker of an orders storage to fix the price for. When set, the product comes with a `signedPrice` holding the price for a limited time; an unknown marker fails the request with `404 Specified orders storage for price signature not found`.
      * @returns {Promise<IProductsEntity | IError>} ProductEntity object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Retrieve one product object. A product with no translation in `langCode` answers `404 Product not found` — there is no fallback to another language.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductById getProductById} documentation.
      */
-    async getProductById(id, langCode = this.state.lang, isNormalized) {
+    async getProductById(id, langCode = this.state.lang, isNormalized, signPrice) {
         const query = { langCode };
         if (isNormalized !== undefined)
             query.isNormalized = isNormalized;
+        if (signPrice !== undefined)
+            query.signPrice = signPrice;
         const result = await this._fetchGet(`/${this._pathSegment(String(id))}?` + this._queryParamsToString(query));
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('ProductEntitySchema'));
@@ -337,13 +340,17 @@ export default class ProductsApi extends AsyncModules {
      * @handleName searchProduct
      * @param {string} name - Text to search for in product titles (`localizeInfos.title`) in the requested language. Example: "laminat".
      * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [url] - URL of a catalog page to search within that category. Default: the whole catalog.
+     * @param {boolean} [correct] - Correct typos by the project's search dictionary first. The API defaults to `true`; pass `false` to search the query as is.
      * @returns {Promise<IProductsEntity[] | IProductSearchResult[] | IError>} Array with ProductEntity objects, or an array with short ProductSearchResult cards when the traficLimit config option is enabled
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Quick search for product page objects with limited output. The quick search endpoint returns short cards ({ id, title, pageId }); with traficLimit enabled they are returned as is, otherwise full product entities are fetched for the found ids.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/searchProduct searchProduct} documentation.
      */
-    async searchProduct(name, langCode = this.state.lang) {
-        const result = await this._fetchGet(`/quick/search?langCode=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
+    async searchProduct(name, langCode = this.state.lang, url, correct) {
+        const extra = (url ? `&url=${encodeURIComponent(url)}` : '') +
+            (correct !== undefined ? `&correct=${correct}` : '');
+        const result = await this._fetchGet(`/quick/search?langCode=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}${extra}`);
         // Validate response if validation is enabled
         const searchProducts = (await this._validateResponse(result, schema('ProductSearchResponseSchema')));
         if (!this.state.traficLimit && Array.isArray(searchProducts)) {
@@ -367,6 +374,7 @@ export default class ProductsApi extends AsyncModules {
      * Getting the number of products for the entire catalog.
      * @handleName getProductsCount
      * @param {any[]} [body] - Filter objects with search conditions. Default: `[]`.
+     * @param {string} [langCode] - Language code. Default: "en_US". Must be one of the project's active languages — an inactive one answers `400 langCode must be one of the active languages`. The count reflects the products visible in that language.
      * @example
         [
           {
@@ -377,13 +385,13 @@ export default class ProductsApi extends AsyncModules {
         ]
      * @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.
+     * @description This method calculates and returns the total number of products present across the entire catalog, optionally applying specified filters. The request carries `langCode`; it must be an active language of the project, otherwise the API answers `400`.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsCount getProductsCount} documentation.
      */
     async getProductsCount(
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    body = []) {
-        const result = await this._fetchPost(`/all/counts`, body);
+    body = [], langCode = this.state.lang) {
+        const result = await this._fetchPost(`/all/counts?` + this._queryParamsToString({ langCode }), body);
         return result;
     }
     /**
@@ -391,6 +399,7 @@ export default class ProductsApi extends AsyncModules {
      * @handleName getProductsCountByPageId
      * @param {number | string} id - Page ID. Example: 12345.
      * @param {any[]} [body] - Filter objects with search conditions. Default: `[]`.
+     * @param {string} [langCode] - Language code. Default: "en_US". Must be one of the project's active languages — an inactive one answers `400 langCode must be one of the active languages`. The count reflects the products visible in that language.
      * @example
         [
           {
@@ -401,13 +410,14 @@ export default class ProductsApi extends AsyncModules {
         ]
      * @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. The counts do not depend on the language: on a language where the catalog is empty they still count every product (CMS-1201).
+     * @description This method calculates and returns the number of products available on a given catalog page, identified by its page ID, with optional filtering. The request carries `langCode`; it must be an active language of the project (an inactive one answers `400`), and the count reflects the products visible in that language.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsCountByPageId getProductsCountByPageId} documentation.
      */
     async getProductsCountByPageId(id, 
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    body = []) {
-        const result = await this._fetchPost(`/page/${this._pathSegment(String(id))}/counts`, body);
+    body = [], langCode = this.state.lang) {
+        const result = await this._fetchPost(`/page/${this._pathSegment(String(id))}/counts?` +
+            this._queryParamsToString({ langCode }), body);
         return result;
     }
     /**
@@ -436,6 +446,7 @@ export default class ProductsApi extends AsyncModules {
      * @handleName getProductsCountByPageUrl
      * @param {string} url - Page URL. Example: "catalog".
      * @param {any[]} [body] - Filter objects with search conditions. Default: `[]`.
+     * @param {string} [langCode] - Language code. Default: "en_US". Must be one of the project's active languages — an inactive one answers `400 langCode must be one of the active languages`. The count reflects the products visible in that language.
      * @example
         [
           {
@@ -446,13 +457,14 @@ export default class ProductsApi extends AsyncModules {
         ]
      * @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. The counts do not depend on the language: on a language where the catalog is empty they still count every product (CMS-1201).
+     * @description This method calculates and returns the number of products available on a given catalog page, identified by its URL, with optional filtering. The request carries `langCode`; it must be an active language of the project (an inactive one answers `400`), and the count reflects the products visible in that language.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsCountByPageUrl getProductsCountByPageUrl} documentation.
      */
     async getProductsCountByPageUrl(url, 
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    body = []) {
-        const result = await this._fetchPost(`/page/url/${this._pathSegments(url)}/counts`, body);
+    body = [], langCode = this.state.lang) {
+        const result = await this._fetchPost(`/page/url/${this._pathSegments(url)}/counts?` +
+            this._queryParamsToString({ langCode }), body);
         return result;
     }
 }

package/esm/products/productsInterfaces.d.ts

@@ -170,11 +170,12 @@ interface IProductsApi {
      * @param {number} id - Product ID. Example: 12345.
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {boolean} [isNormalized] - Deprecated: the API no longer reads it, the answer is the same with `true`, `false` or without it. Kept for compatibility.
+     * @param {string} [signPrice] - Marker of an orders storage to fix the price for; the product then carries a `signedPrice`. An unknown marker answers `404`.
      * @returns {IProductsEntity} ProductEntity object.
      * @throws {IError} If there is an error during the fetch operation, it will return an error object.
      * @description This method retrieves one product object.
      */
-    getProductById(id: number, langCode?: string, isNormalized?: boolean): Promise<IProductsEntity | IError>;
+    getProductById(id: number, langCode?: string, isNormalized?: boolean, signPrice?: string): Promise<IProductsEntity | IError>;
     /**
      * Getting a product block object by product id.
      * @handleName getProductBlockById
@@ -190,11 +191,13 @@ interface IProductsApi {
      * @handleName searchProduct
      * @param {string} name - Text to search for in product titles (`localizeInfos.title`) in the requested language. Example: 'laminat'.
      * @param {string} [langCode] - Language code. Default: "en_US".
+     * @param {string} [url] - URL of a catalog page to search within that category. Default: the whole catalog.
+     * @param {boolean} [correct] - Correct typos by the project's search dictionary first. The API defaults to `true`; pass `false` to search the query as is.
      * @returns {IProductsEntity[] | IProductSearchResult[]} Array with ProductEntity objects, or an array with short ProductSearchResult cards when the traficLimit config option is enabled
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method performs a quick search for product page objects with limited output. With traficLimit enabled the raw quick search response is returned as short cards; otherwise full product entities are fetched for the found ids.
      */
-    searchProduct(name: string, langCode?: string): Promise<IProductsEntity[] | IProductSearchResult[] | IError>;
+    searchProduct(name: string, langCode?: string, url?: string, correct?: boolean): Promise<IProductsEntity[] | IProductSearchResult[] | IError>;
     /**
      * Getting the number of products for the entire catalog.
      * @handleName getProductsCount
@@ -209,9 +212,10 @@ interface IProductsApi {
         ]
      * @returns {IProductsCount} Object with product items count.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @param {string} [langCode] - Language code. Default: "en_US". Must be an active language of the project — an inactive one answers `400`; the count reflects products visible in that language.
      * @description This method calculates and returns the total number of products present across the entire catalog, optionally applying specified filters.
      */
-    getProductsCount(body?: object[]): Promise<IProductsCount | IError>;
+    getProductsCount(body?: object[], langCode?: string): Promise<IProductsCount | IError>;
     /**
      * Getting the number of products on a catalog page by page ID.
      * @handleName getProductsCountByPageId
@@ -227,9 +231,10 @@ interface IProductsApi {
         ]
      * @returns {IProductsCount} Object with product items count.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @param {string} [langCode] - Language code. Default: "en_US". Must be an active language of the project — an inactive one answers `400`; the count reflects products visible in that language.
      * @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: number | string, body?: object[]): Promise<IProductsCount | IError>;
+    getProductsCountByPageId(id: number | string, body?: object[], langCode?: string): Promise<IProductsCount | IError>;
     /**
      * Getting the number of products on a catalog page by page URL.
      * @handleName getProductsCountByPageUrl
@@ -245,9 +250,10 @@ interface IProductsApi {
         ]
      * @returns {IProductsCount} Object with product items count.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @param {string} [langCode] - Language code. Default: "en_US". Must be an active language of the project — an inactive one answers `400`; the count reflects products visible in that language.
      * @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?: object[]): Promise<IProductsCount | IError>;
+    getProductsCountByPageUrl(url: string, body?: object[], langCode?: string): Promise<IProductsCount | IError>;
     /**
      * Semantic (vector) search for products.
      * @handleName getProductsByVectorSearch

package/esm/search/searchApi.d.ts

@@ -27,10 +27,11 @@ export default class SearchApi extends AsyncModules implements ISearchApi {
      * @param {number} [offset] - Offset for drilldown mode. Pass it only together with exactly one accessible type in `types`.
      * @param {number} [limit] - Page size for drilldown mode. Pass it only together with exactly one accessible type in `types`; otherwise the API responds with `400 Drilldown mode (limit/offset) requires exactly one accessible type in types`. Without it, every group is returned in full.
      * @param {string} [langCode] - Language code. Default: "en_US". The search index is built per language: words in another locale are found only when you pass that locale's `langCode`.
+     * @param {number} [limitPerType] - Dropdown mode: maximum items per type group (API default 5, max 20). Independent from `limit`/`offset`, which page a single type in drilldown mode.
      * @returns {Promise<IGlobalSearchResponse | IError>} Returns the query and the found records grouped by entity type.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Searches names and attribute values of visible records across entity types. The index is per language — the request carries `langCode`, so a bilingual project finds a word of either locale.
      * @see {@link https://js-sdk.oneentry.cloud/docs/search/globalSearch globalSearch} documentation.
      */
-    globalSearch(query: string, types?: TGlobalSearchEntityType[], visibility?: 'all' | 'visible' | 'hidden', offset?: number, limit?: number, langCode?: string): Promise<IGlobalSearchResponse | IError>;
+    globalSearch(query: string, types?: TGlobalSearchEntityType[], visibility?: 'all' | 'visible' | 'hidden', offset?: number, limit?: number, langCode?: string, limitPerType?: number): Promise<IGlobalSearchResponse | IError>;
 }

package/esm/search/searchApi.js

@@ -27,12 +27,13 @@ export default class SearchApi extends AsyncModules {
      * @param {number} [offset] - Offset for drilldown mode. Pass it only together with exactly one accessible type in `types`.
      * @param {number} [limit] - Page size for drilldown mode. Pass it only together with exactly one accessible type in `types`; otherwise the API responds with `400 Drilldown mode (limit/offset) requires exactly one accessible type in types`. Without it, every group is returned in full.
      * @param {string} [langCode] - Language code. Default: "en_US". The search index is built per language: words in another locale are found only when you pass that locale's `langCode`.
+     * @param {number} [limitPerType] - Dropdown mode: maximum items per type group (API default 5, max 20). Independent from `limit`/`offset`, which page a single type in drilldown mode.
      * @returns {Promise<IGlobalSearchResponse | IError>} Returns the query and the found records grouped by entity type.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Searches names and attribute values of visible records across entity types. The index is per language — the request carries `langCode`, so a bilingual project finds a word of either locale.
      * @see {@link https://js-sdk.oneentry.cloud/docs/search/globalSearch globalSearch} documentation.
      */
-    async globalSearch(query, types, visibility, offset, limit, langCode = this.state.lang) {
+    async globalSearch(query, types, visibility, offset, limit, langCode = this.state.lang, limitPerType) {
         // `types` is sent comma-separated — the array stringifies to exactly that.
         // `langCode` is not optional decoration: the index is per language, and
         // without it a word of a second locale answers an empty group (CMS-912).
@@ -43,6 +44,7 @@ export default class SearchApi extends AsyncModules {
             visibility,
             offset,
             limit,
+            limitPerType,
             langCode,
         };
         const data = await this._fetchGet(`?` + this._queryParamsToString(params));

package/esm/search/searchInterfaces.d.ts

@@ -14,11 +14,12 @@ interface ISearchApi {
      * @param {number} [offset] - Offset for drilldown mode. Pass it only together with exactly one accessible type in `types`.
      * @param {number} [limit] - Page size for drilldown mode. Pass it only together with exactly one accessible type in `types`; otherwise the API responds with `400 Drilldown mode (limit/offset) requires exactly one accessible type in types`. Without it, every group is returned in full.
      * @param {string} [langCode] - Language code. Default: "en_US". The search index is built per language: words in another locale are found only when you pass that locale's `langCode`.
+     * @param {number} [limitPerType] - Dropdown mode: maximum items per type group (API default 5, max 20). Independent from `limit`/`offset`, which page a single type in drilldown mode.
      * @returns {Promise<IGlobalSearchResponse | IError>} Returns the query and the found records grouped by entity type.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Searches names and attribute values of visible records across entity types. The index is per language — the request carries `langCode`, so a bilingual project finds a word of either locale.
      */
-    globalSearch(query: string, types?: TGlobalSearchEntityType[], visibility?: 'all' | 'visible' | 'hidden', offset?: number, limit?: number, langCode?: string): Promise<IGlobalSearchResponse | IError>;
+    globalSearch(query: string, types?: TGlobalSearchEntityType[], visibility?: 'all' | 'visible' | 'hidden', offset?: number, limit?: number, langCode?: string, limitPerType?: number): Promise<IGlobalSearchResponse | IError>;
 }
 /**
  * Entity type a global search group or item belongs to.