oneentry 1.0.176 → 1.0.178

package/dist/orders/ordersInterfaces.d.ts

@@ -141,6 +141,7 @@ interface IOrdersApi {
      * @param {number} [limit] - Maximum number of records to return. Default: 30.
      * @returns {Promise<IOrderStatus[] | IError>} Returns an object with the orders statuses.
      * @throws {IError} When isShell=false and an error occurs during the fetch
+     * @description Get all order statuses of the storage. This method requires user authorization: a guest gets `401 Unauthorized`.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      */
     getAllStatusesByStorageMarker(marker: string, langCode?: string, offset?: number, limit?: number): Promise<IOrderStatus[] | IError>;
@@ -216,7 +217,8 @@ interface IOrdersVectorSearch {
           }
         ],
         "attributeSetIdentifier": "order_form",
-        "totalSum": "300.00",
+        "totalSum": "300",
+        "totalSumRaw": "300",
         "currency": "",
         "paymentAccountIdentifier": "cash",
         "paymentAccountLocalizeInfos": {
@@ -227,9 +229,10 @@ interface IOrdersVectorSearch {
           "id": 2957,
           "title": "Cosmo",
           "sku": null,
-          "previewImage": null,
+          "previewImage": [],
           "price": 150,
-          "quantity": 2
+          "quantity": 2,
+          "isGift": false
           }
         ],
         "isCompleted": false
@@ -262,9 +265,9 @@ interface IPicture {
  * @interface IOrderProducts
  * @property {number} id - Product ID. Example: 2957.
  * @property {number} quantity - Product quantity. Example: 1.
- * @property {string} title - Product title. Example: "Cosmo".
+ * @property {string | null} title - Product title; `null` on a language the product has no translation in. Example: "Cosmo".
  * @property {string | null} sku - Product SKU. Example: "SKU".
- * @property {IPicture | null} previewImage - Preview image of the product.
+ * @property {IPicture | IPicture[] | null} previewImage - Preview image of the product. A product without one comes as an empty array `[]`, not `null` — check `Array.isArray(previewImage) ? previewImage[0] : previewImage`.
  * @example
     {
       "filename": "image.jpg",
@@ -279,9 +282,9 @@ interface IPicture {
 interface IOrderProducts {
     id: number;
     quantity: number;
-    title: string;
+    title: string | null;
     sku: string | null;
-    previewImage: IPicture | null;
+    previewImage: IPicture | IPicture[] | null;
     price: number;
     isGift: boolean;
 }
@@ -542,7 +545,7 @@ interface IOrderData {
  * @property {number} productId - Identifier of the product covered by the stage. Example: 1.
  * @property {string} title - Stage title. Example: "Deposit".
  * @property {number} value - Stage amount. Example: 100.
- * @property {string} status - Stage status. Example: "pending".
+ * @property {string} status - Stage status. Example: "planned".
  * @description A single stage of a split (staged) order payment.
  */
 interface IOrderSplitStage {
@@ -583,8 +586,8 @@ interface IOrderSplit {
       }
     ]
  * @property {string | null} [attributeSetIdentifier] - Marker of the attribute set. Example: "attribute-set-1".
- * @property {string} totalSum - Total order amount. Example: "100.00".
- * @property {string} [totalSumRaw] - Raw total order amount with full precision. Example: "100.00".
+ * @property {string} totalSum - Total order amount. Example: "300".
+ * @property {string} [totalSumRaw] - Raw total order amount with full precision. Example: "300".
  * @property {string} currency - Currency used to pay for the order. Example: "USD".
  * @property {string | null} [paymentAccountIdentifier] - Marker of the payment account. Example: "payment-1".
  * @property {ILocalizeInfo} [paymentAccountLocalizeInfos] - Localized name of the payment account.
@@ -596,9 +599,13 @@ interface IOrderSplit {
  * @example
     [
       {
-        "id": 1,
-        "name": "Product 1",
-        "quantity": 2
+        "id": 2957,
+        "title": "Cosmo",
+        "sku": null,
+        "previewImage": [],
+        "price": 150,
+        "quantity": 2,
+        "isGift": false
       }
     ]
  * @property {string | null} paymentUrl - Payment page URL. Example: "https://example.com/pay/123".
@@ -773,4 +780,4 @@ interface ICreateRefundRequest {
     products: Record<string, IRefundProduct>;
     note?: string;
 }
-export type { IBaseOrdersEntity, IBaseOrdersEntityResponse, ICreateOrderPreview, ICreateRefundRequest, IOrderByMarkerEntity, IOrderData, IOrderDiscountBonus, IOrderDiscountConfig, IOrderDiscountSettings, IOrderPreviewItem, IOrderPreviewResponse, IOrderProductData, IOrderProducts, IOrdersApi, IOrdersByMarkerEntity, IOrdersEntity, IOrdersFormData, IOrderSplit, IOrderSplitStage, IOrderStatus, IOrdersVectorSearch, IPaymentAccountIdentifiers, IPicture, IPreviewOrderProduct, IRefundProduct, IRefundRequest, };
+export type { IBaseOrdersEntity, IBaseOrdersEntityResponse, ICreateOrderPreview, ICreateRefundRequest, IOrderByMarkerEntity, IOrderData, IOrderDiscountBonus, IOrderDiscountConfig, IOrderDiscountSettings, IOrderPreviewItem, IOrderPreviewResponse, IOrderProductData, IOrderProducts, IOrderProductsData, IOrdersApi, IOrdersByMarkerEntity, IOrdersEntity, IOrdersFormData, IOrderSplit, IOrderSplitStage, IOrderStatus, IOrdersVectorSearch, IPaymentAccountIdentifiers, IPicture, IPreviewOrderProduct, IRefundProduct, IRefundRequest, };

package/dist/pages/pagesApi.d.ts

@@ -61,9 +61,9 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
     /**
      * Get child pages object with information as an array.
      * @handleName getChildPagesByParentUrl
-     * @param {string} url - URL of the parent page whose child pages to fetch. Example: "about/our-team".
+     * @param {string} url - URL of the parent page whose child pages to fetch — the page's own `pageUrl`, not a nested path: `blog/blog1` answers `404`. Example: "blog".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<IPagesEntity | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data) for the selected parent
+     * @returns {Promise<IPagesEntity[] | IError>} Returns an array of PageEntity objects for the selected parent, or an empty array [] when it has no child pages. A parent page that does not exist answers `404 Parent page not found` (IError).
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get child pages object with information as an array.
      * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getChildPagesByParentUrl getChildPagesByParentUrl} documentation.
@@ -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
@@ -109,6 +110,7 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * Add template data to pages
      * @handleName addTemplateToPages
      * @param {IPagesEntity[]} data - An array of page objects (IPagesEntity[]) to which template data will be added.
+     * @param {string} [langCode] - Language the templates are fetched and unwrapped in. Default: the client's language.
      * @example
         [
           {
@@ -149,15 +151,15 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @description Add template data to pages. Optimized to avoid N+1 query problem by fetching only unique templates in parallel.
      * For example, if 100 pages use 3 different templates, this method makes 3 requests instead of 100.
      */
-    protected addTemplateToPages(data: IPagesEntity[]): Promise<any | IError>;
+    protected addTemplateToPages(data: IPagesEntity[], langCode?: string): Promise<any | IError>;
     /**
      * Add template data to page by page templateIdentifier
      * @handleName addTemplateToPage
      * @param {IPagesEntity} data - Page object (IPagesEntity) to which template data will be added.
+     * @param {string} [langCode] - Language the templates are fetched and unwrapped in. Default: the client's language.
      * @returns {Promise<any | IError>} An array of page objects with template data added
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Add template data to page by page templateIdentifier
-     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/addTemplateToPage addTemplateToPage} documentation.
      */
-    protected addTemplateToPage(data: IPagesEntity): Promise<any | IError>;
+    protected addTemplateToPage(data: IPagesEntity, langCode?: string): Promise<any | IError>;
 }

package/dist/pages/pagesApi.js

@@ -68,11 +68,11 @@ class PagesApi extends asyncModules_1.default {
      */
     async getRootPages(langCode = this.state.lang) {
         // Fetch data from the server using a GET request to retrieve root pages for the specified language code
-        const data = await this._fetchGet(`/root?langCode=${langCode}`);
+        const data = await this._fetchGet(`/root?langCode=${encodeURIComponent(langCode)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(data, schema('PagesResponseSchema'));
         // Add template information to each page in the fetched root pages data
-        const withTemplate = await this.addTemplateToPages(validated);
+        const withTemplate = await this.addTemplateToPages(validated, langCode);
         // Normalize the data and return it; ensures consistent structure or handles errors
         return this._normalizeData(withTemplate, langCode);
     }
@@ -87,11 +87,11 @@ class PagesApi extends asyncModules_1.default {
      */
     async getPages(langCode = this.state.lang) {
         // Fetch data from the server using a GET request to retrieve all pages for the specified language code
-        const data = await this._fetchGet(`?langCode=${langCode}`);
+        const data = await this._fetchGet(`?langCode=${encodeURIComponent(langCode)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(data, schema('PagesResponseSchema'));
         // Add template information to each page in the fetched data
-        const withTemplate = await this.addTemplateToPages(validated);
+        const withTemplate = await this.addTemplateToPages(validated, langCode);
         // Normalize the data and return it; ensures consistent structure or handles errors
         return this._normalizeData(withTemplate, langCode);
     }
@@ -107,11 +107,11 @@ class PagesApi extends asyncModules_1.default {
      */
     async getPageById(id, langCode = this.state.lang) {
         // Fetch data from the server using a GET request to retrieve page details by ID and language code
-        const data = await this._fetchGet(`/${id}?langCode=${langCode}`);
+        const data = await this._fetchGet(`/${this._pathSegment(String(id))}?langCode=${encodeURIComponent(langCode)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(data, schema('PageEntitySchema'));
         // Add template information to the fetched page data
-        const withTemplate = await this.addTemplateToPage(validated);
+        const withTemplate = await this.addTemplateToPage(validated, langCode);
         // Normalize the data and return it; ensures consistent structure or handles errors
         return this._normalizeData(withTemplate, langCode);
     }
@@ -127,31 +127,31 @@ class PagesApi extends asyncModules_1.default {
      */
     async getPageByUrl(url, langCode = this.state.lang) {
         // Fetch data from the server using a GET request with the specified URL and language code
-        const data = await this._fetchGet(`/url/${url}?langCode=${langCode}`);
+        const data = await this._fetchGet(`/url/${this._pathSegments(url)}?langCode=${encodeURIComponent(langCode)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(data, schema('PageEntitySchema'));
         // Add template information to the fetched page data
-        const withTemplate = await this.addTemplateToPage(validated);
+        const withTemplate = await this.addTemplateToPage(validated, langCode);
         // Normalize the result data and return it; ensures consistent structure or handles errors
         return this._normalizeData(withTemplate, langCode);
     }
     /**
      * Get child pages object with information as an array.
      * @handleName getChildPagesByParentUrl
-     * @param {string} url - URL of the parent page whose child pages to fetch. Example: "about/our-team".
+     * @param {string} url - URL of the parent page whose child pages to fetch — the page's own `pageUrl`, not a nested path: `blog/blog1` answers `404`. Example: "blog".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<IPagesEntity | IError>} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data) for the selected parent
+     * @returns {Promise<IPagesEntity[] | IError>} Returns an array of PageEntity objects for the selected parent, or an empty array [] when it has no child pages. A parent page that does not exist answers `404 Parent page not found` (IError).
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Get child pages object with information as an array.
      * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getChildPagesByParentUrl getChildPagesByParentUrl} documentation.
      */
     async getChildPagesByParentUrl(url, langCode = this.state.lang) {
         // Fetch data from the server using a GET request to retrieve child pages for the specified parent URL and language code
-        const data = await this._fetchGet(`/${url}/children?langCode=${langCode}`);
+        const data = await this._fetchGet(`/${this._pathSegments(url)}/children?langCode=${encodeURIComponent(langCode)}`);
         // Validate response if validation is enabled
         const validated = await this._validateResponse(data, schema('PagesResponseSchema'));
         // Add template information to each of the fetched child pages
-        const withTemplate = await this.addTemplateToPages(validated);
+        const withTemplate = await this.addTemplateToPages(validated, langCode);
         // Normalize the result data and return it; ensures consistent structure or handles errors
         return this._normalizeData(withTemplate, langCode);
     }
@@ -166,9 +166,9 @@ class PagesApi extends asyncModules_1.default {
      * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getBlocksByPageUrl getBlocksByPageUrl} documentation.
      */
     async getBlocksByPageUrl(url, langCode = this.state.lang) {
-        const response = await this._fetchGet(`/${url}/blocks?langCode=${langCode}`);
-        // Normalize the fetched response data
-        const normalizeResponse = this._normalizeData(response);
+        const response = await this._fetchGet(`/${this._pathSegments(url)}/blocks?langCode=${encodeURIComponent(langCode)}`);
+        // Normalize by the language of the call, not by the client's one
+        const normalizeResponse = this._normalizeData(response, langCode);
         if (!Array.isArray(normalizeResponse)) {
             return normalizeResponse;
         }
@@ -188,22 +188,27 @@ class PagesApi extends asyncModules_1.default {
             }
             // Remove internal-only properties from the result.
             delete item.customSettings;
-            delete item.attributesSetIdentifier;
             // In traffic-saving mode skip the extra product requests.
             if (this.state.traficLimit)
                 return;
             // Attach related products by block type. StaffModule already normalizes its results.
+            // A failed sub-request leaves an empty value of the declared type: with isShell the
+            // error comes back as a value, and it used to land in `products`/`similarProducts`
             if (item.type === 'similar_products_block') {
                 try {
-                    item.similarProducts = await staffModule.getSimilarProducts(item.identifier, langCode);
+                    const similar = await asyncModules_1.default._subRequestOf(staffModule).getSimilarProducts(item.identifier, langCode);
+                    item.similarProducts = this._isErrorResponse(similar)
+                        ? { items: [], total: 0 }
+                        : similar;
                 }
                 catch {
-                    item.similarProducts = [];
+                    item.similarProducts = { items: [], total: 0 };
                 }
             }
             else if (item.type === 'product_block') {
                 try {
-                    item.products = await staffModule.getProductsByBlockMarker(item.identifier, langCode);
+                    const products = await asyncModules_1.default._subRequestOf(staffModule).getProductsByBlockMarker(item.identifier, langCode);
+                    item.products = this._isErrorResponse(products) ? [] : products;
                 }
                 catch {
                     item.products = [];
@@ -218,15 +223,17 @@ class PagesApi extends asyncModules_1.default {
      * @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
@@ -238,7 +245,7 @@ class PagesApi extends asyncModules_1.default {
             // and broke `page.localizeInfos.title` on the caller's side (CMS-1068)
             const pageList = fetched.filter((page) => !this._isErrorResponse(page));
             // Add templates to the fetched pages
-            const withTemplate = await this.addTemplateToPages(pageList);
+            const withTemplate = await this.addTemplateToPages(pageList, langCode);
             // Normalize the data and return it; ensures consistent structure or handles errors
             return this._normalizeData(withTemplate, langCode);
         }
@@ -271,6 +278,7 @@ class PagesApi extends asyncModules_1.default {
      * Add template data to pages
      * @handleName addTemplateToPages
      * @param {IPagesEntity[]} data - An array of page objects (IPagesEntity[]) to which template data will be added.
+     * @param {string} [langCode] - Language the templates are fetched and unwrapped in. Default: the client's language.
      * @example
         [
           {
@@ -311,7 +319,7 @@ class PagesApi extends asyncModules_1.default {
      * @description Add template data to pages. Optimized to avoid N+1 query problem by fetching only unique templates in parallel.
      * For example, if 100 pages use 3 different templates, this method makes 3 requests instead of 100.
      */
-    async addTemplateToPages(data) {
+    async addTemplateToPages(data, langCode = this.state.lang) {
         // On API error responses (e.g. 403 without list permission, 422) the value
         // is an IError, not an array — return it as-is instead of calling array
         // methods (.filter/.map) on it and throwing a TypeError.
@@ -332,7 +340,9 @@ class PagesApi extends asyncModules_1.default {
         }
         // Step 3: Fetch unique templates in parallel (not N queries, but unique count queries)
         const Templates = new templatesApi_1.default(this.state);
-        const templatePromises = uniqueIdentifiers.map((identifier) => Templates.getTemplateByMarker(identifier).catch((error) => {
+        const templatePromises = uniqueIdentifiers.map((identifier) => asyncModules_1.default._subRequestOf(Templates)
+            .getTemplateByMarker(identifier, langCode)
+            .catch((error) => {
             // eslint-disable-next-line no-undef, no-console
             console.error(`Template fetch error for ${identifier}: `, error);
             return null; // Return null for failed templates
@@ -341,7 +351,8 @@ class PagesApi extends asyncModules_1.default {
         // Step 4: Create a Map for O(1) template lookup
         const templateMap = new Map();
         templates.forEach((template, index) => {
-            if (template !== null) {
+            // An error comes back as a value with isShell: it is not a template
+            if (template !== null && !this._isErrorResponse(template)) {
                 templateMap.set(uniqueIdentifiers[index], template);
             }
         });
@@ -366,12 +377,12 @@ class PagesApi extends asyncModules_1.default {
      * Add template data to page by page templateIdentifier
      * @handleName addTemplateToPage
      * @param {IPagesEntity} data - Page object (IPagesEntity) to which template data will be added.
+     * @param {string} [langCode] - Language the templates are fetched and unwrapped in. Default: the client's language.
      * @returns {Promise<any | IError>} An array of page objects with template data added
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Add template data to page by page templateIdentifier
-     * @see {@link https://js-sdk.oneentry.cloud/docs/pages/addTemplateToPage addTemplateToPage} documentation.
      */
-    async addTemplateToPage(data) {
+    async addTemplateToPage(data, langCode = this.state.lang) {
         // Check if 'templateIdentifier' exists in 'data' and is not null or an empty string
         if ('templateIdentifier' in data &&
             data.templateIdentifier !== null &&
@@ -382,7 +393,11 @@ class PagesApi extends asyncModules_1.default {
                 // Create a new instance of templatesApi with the current state
                 const Templates = new templatesApi_1.default(this.state);
                 // Fetch the template using the 'templateIdentifier'
-                const result = await Templates.getTemplateByMarker(templateIdentifier);
+                const result = await asyncModules_1.default._subRequestOf(Templates).getTemplateByMarker(templateIdentifier, langCode);
+                // An error comes back as a value with isShell: leave the page without a template
+                if (this._isErrorResponse(result)) {
+                    return data;
+                }
                 // Return the original data object with the fetched template added
                 return {
                     ...data,
@@ -415,18 +430,18 @@ class StaffModule extends asyncModules_1.default {
     // ({ total, items }) to match BlocksApi's similarProducts contract.
     async getSimilarProducts(marker, langCode = this.state.lang, offset = 0, limit = 30) {
         // Fetch similar products from the server
-        const result = await this._fetchGet(`/${this._pathSegment(marker)}/similar-products?langCode=${langCode}&offset=${offset}&limit=${limit}`);
-        return this._normalizeData(result);
+        const result = await this._fetchGet(`/${this._pathSegment(marker)}/similar-products?langCode=${encodeURIComponent(langCode)}&offset=${encodeURIComponent(String(offset))}&limit=${encodeURIComponent(String(limit))}`);
+        return this._normalizeData(result, langCode);
     }
     // Method to fetch products by block marker
     async getProductsByBlockMarker(marker, langCode = this.state.lang, offset = 0, limit = 30) {
         // Fetch products from the server
-        const result = await this._fetchGet(`/${this._pathSegment(marker)}/products?langCode=${langCode}&offset=${offset}&limit=${limit}`);
+        const result = await this._fetchGet(`/${this._pathSegment(marker)}/products?langCode=${encodeURIComponent(langCode)}&offset=${encodeURIComponent(String(offset))}&limit=${encodeURIComponent(String(limit))}`);
         // On API error responses there is no `items` array — return the (normalized)
         // error as-is instead of producing `undefined` from `result.items`.
         if (!Array.isArray(result === null || result === void 0 ? void 0 : result.items)) {
-            return this._normalizeData(result);
+            return this._normalizeData(result, langCode);
         }
-        return this._normalizeData(result.items);
+        return this._normalizeData(result.items, langCode);
     }
 }

package/dist/pages/pagesInterfaces.d.ts

@@ -49,9 +49,9 @@ interface IPagesApi {
     /**
      * Get child pages object with information as an array.
      * @handleName getChildPagesByParentUrl
-     * @param {string} url - URL of the parent page whose child pages to fetch. Example: "about".
+     * @param {string} url - URL of the parent page whose child pages to fetch — the page's own `pageUrl`, not a nested path: `blog/blog1` answers `404`. Example: "blog".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {IPagesEntity} Returns all created pages as an array of PageEntity objects or an empty array [] (if there is no data) for the selected parent
+     * @returns {IPagesEntity[]} Returns an array of PageEntity objects for the selected parent, or an empty array [] when it has no child pages. A parent page that does not exist answers `404 Parent page not found` (IError).
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method gets child pages object with information as an array.
      */
@@ -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
@@ -121,7 +122,7 @@ interface IPagesResponse {
  * @property {number} version - Version number of the object; changes with each update. Example: 10.
  * @property {string} identifier - Text identifier (marker) of the object. Example: "catalog".
  * @property {number} attributeSetId - ID of the attribute set in use. Example: 0.
- * @property {string} processingType - How form submissions are processed, for example `"email"` or `"url"`. Example: "email".
+ * @property {string} processingType - How form submissions are processed: the processing type chosen in the form settings. Example: "script".
  * @property {ILocalizeInfo} localizeInfos - Localized name and content of the page.
  * @example
     {
@@ -142,22 +143,27 @@ interface IPagesResponse {
         "listTitles": [
           {
             "title": "red",
-            "value": 1,
-            "position": 1,
-            "extendedValue": null,
-            "extendedValueType": null
+            "value": "1",
+            "extended": {
+              "type": null,
+              "value": null
+            },
+            "position": 1
           },
           {
             "title": "yellow",
-            "value": 2,
-            "position": 2,
-            "extendedValue": null,
-            "extendedValueType": null
+            "value": "2",
+            "extended": {
+              "type": null,
+              "value": null
+            },
+            "position": 2
           }
         ],
         "validators": {},
         "localizeInfos": {
-        "title": "l1"
+          "title": "l1"
+        }
       }
     ]
  * @description This interface defines the structure of a position form entity, including its identifiers, attributes, and processing data.
@@ -188,7 +194,7 @@ interface IPositionForm {
  * @property {number} version - Version number of the object; changes with each update. Example: 0.
  * @property {number} position - Position of the object, used for sorting. Example: 1.
  * @property {string} identifier - Text identifier (marker) of the object. Example: "product_block".
- * @property {BlockType} type - Block type. Example: "product".
+ * @property {BlockType} type - Block type. Example: "product_block".
  * @property {string | null} templateIdentifier - Marker of the linked template, or `null` when none is linked. Example: null.
  * @property {boolean} isVisible - Whether the page is visible. Example: true.
  * @property {boolean} isSync - Whether the page is indexed. Example: false.
@@ -285,7 +291,6 @@ type PageType = 'catalog_page' | 'common_page' | 'error_page' | 'external_page';
     }
  * @property {Array<IFormConfig>} [moduleFormConfigs] - Form configurations of the module linked to the page.
  * @property {IRating} [rating] - Rating data: average value, likes and dislikes, and the calculation method.
- * @property {string} [total] - Total number of products linked to the page. Example: "10".
  * @property {string | null} [categoryPath] - Category path; `null` for nested pages that have no category path of their own. Example: "catalog".
  * @property {number} [distance] - Cosine distance to the query. Returned only by the semantic (vector) search endpoint when `debug: true` is passed in the search body. Example: 0.12.
  * @description This interface defines the structure of a page entity, including its identifiers, attributes, and hierarchical relationships.
@@ -310,7 +315,6 @@ interface IPagesEntity {
     config?: Record<string, number>;
     products?: number;
     childrenCount?: number;
-    total?: string;
     categoryPath?: string | null;
     distance?: number;
 }

package/dist/pages/pagesSchemas.d.ts

@@ -32,7 +32,6 @@ export declare const PageEntitySchema: z.ZodObject<{
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     products: z.ZodOptional<z.ZodNumber>;
     childrenCount: z.ZodOptional<z.ZodNumber>;
-    total: z.ZodOptional<z.ZodString>;
     categoryPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     distance: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -64,7 +63,6 @@ export declare const PagesResponseSchema: z.ZodArray<z.ZodObject<{
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     products: z.ZodOptional<z.ZodNumber>;
     childrenCount: z.ZodOptional<z.ZodNumber>;
-    total: z.ZodOptional<z.ZodString>;
     categoryPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     distance: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>>;
@@ -111,7 +109,6 @@ export declare const SinglePageSchema: z.ZodObject<{
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     products: z.ZodOptional<z.ZodNumber>;
     childrenCount: z.ZodOptional<z.ZodNumber>;
-    total: z.ZodOptional<z.ZodString>;
     categoryPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     distance: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;

package/dist/pages/pagesSchemas.js

@@ -32,7 +32,6 @@ exports.PageEntitySchema = zod_1.z.object({
     config: zod_1.z.record(zod_1.z.string(), zod_1.z.number()).optional(),
     products: zod_1.z.number().optional(),
     childrenCount: zod_1.z.number().optional(),
-    total: zod_1.z.string().optional(),
     categoryPath: zod_1.z.string().nullable().optional(),
     distance: zod_1.z.number().optional(),
 });

package/dist/payments/paymentsApi.d.ts

@@ -43,13 +43,13 @@ export default class PaymentsApi extends AsyncModules implements IPaymentsApi {
      * Get one payment session object by order identifier
      * @handleName getSessionByOrderId
      * @param {number} id - Order ID. Example: 12345.
-     * @returns {Promise<IAccountsEntity | IError>} Returns a single payment account object.
+     * @returns {Promise<ISessionEntity[] | IError>} Returns the payment sessions of the order — an **array**, `[]` (with `200`) for an order without sessions, an order that does not exist or an order of another user.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method gets one payment session object by order identifier. This method requires user authorization.
+     * @description This method gets the payment sessions of an order by its identifier. The answer is an array even for one session. This method requires user authorization.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      * @see {@link https://js-sdk.oneentry.cloud/docs/payments/getSessionByOrderId getSessionByOrderId} documentation.
      */
-    getSessionByOrderId(id: number): Promise<ISessionEntity | ISessionEntity[] | IError>;
+    getSessionByOrderId(id: number): Promise<ISessionEntity[] | IError>;
     /**
      * Creation of payment session.
      * @handleName createSession
@@ -66,25 +66,24 @@ export default class PaymentsApi extends AsyncModules implements IPaymentsApi {
     /**
      * Get all payment accounts as an array.
      * @handleName getAccounts
-     * @returns {Promise<IAccountsEntity | IError>} Returns all created payment accounts as an array of PaymentAccountEntity objects.
+     * @param {string} [langCode] - Language code. Default: the client's language.
+     * @returns {Promise<IAccountsEntity[] | IError>} Returns all created payment accounts as an array of PaymentAccountEntity objects.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description This method gets all payment accounts as an array. This method requires user authorization.
-     * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
+     * @description This method gets all payment accounts as an array. It does not require user authorization: a guest gets the accounts too.
      * @see {@link https://js-sdk.oneentry.cloud/docs/payments/getAccounts getAccounts} documentation.
      */
-    getAccounts(): Promise<IAccountsEntity[] | IError>;
+    getAccounts(langCode?: string): Promise<IAccountsEntity[] | IError>;
     /**
      * Get a single payment account object by its identifier.
      * @handleName getAccountById
      * @param {number} id - Payment account ID. Example: 12345.
+     * @param {string} [langCode] - Language code. Default: the client's language.
      * @returns {Promise<IAccountsEntity | IError>} Returns a single payment account object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Get a single payment account object by its identifier.
-     * @description This method requires user authorization.
-     * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
+     * @description Get a single payment account object by its identifier. It does not require user authorization: a guest gets the account too.
      * @see {@link https://js-sdk.oneentry.cloud/docs/payments/getAccountById getAccountById} documentation.
      */
-    getAccountById(id: number): Promise<IAccountsEntity | IError>;
+    getAccountById(id: number, langCode?: string): Promise<IAccountsEntity | IError>;
     /**
      * Get the payment progress of an order: its stages and whether they are paid.
      * @handleName getPaymentStagesByOrderId