oneentry 1.0.171 → 1.0.173

package/esm/integration-collections/integrationCollectionsApi.js

@@ -27,18 +27,14 @@ export default class IntegrationCollectionsApi extends AsyncModules {
      * Get all collections.
      * @handleName getICollections
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {object} [userQuery] - Optional set query parameters.
+     * @param {ICollectionsListQuery} [userQuery] - Optional set query parameters.
      * @example
         {
-          "limit": 0,
-          "offset": 30,
-          "entityType": "orders",
-          "entityId": 1
+          "limit": 30,
+          "offset": 0
         }
-     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 0.
-     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 30.
-     * @param {string} [userQuery.entityType] - Entity type. Example: "orders".
-     * @param {number} [userQuery.entityId] - Entity identifier. Example: 1.
+     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30.
+     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0.
      * @returns {Promise<ICollectionEntity[] | IError>} Returns an array of ICollection objects or an error object if there was an issue.
      * @see {@link https://js-sdk.oneentry.cloud/docs/integration-collections/getICollections getICollections} documentation.
      */
@@ -70,16 +66,16 @@ export default class IntegrationCollectionsApi extends AsyncModules {
      * @handleName getICollectionRowsById
      * @param {number} id - Collection id. Example: 1.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {any} [userQuery] - Optional set query parameters.
+     * @param {ICollectionQuery} [userQuery] - Optional set query parameters.
      * @example
         {
-          "limit": 0,
-          "offset": 30,
+          "limit": 30,
+          "offset": 0,
           "entityType": "orders",
           "entityId": 1
         }
-     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 0.
-     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 30.
+     * @param {number} [userQuery.limit] - Optional parameter for pagination. Default: 30.
+     * @param {number} [userQuery.offset] - Optional parameter for pagination. Default: 0.
      * @param {string} [userQuery.entityType] - Entity type. Example: "orders".
      * @param {number} [userQuery.entityId] - Entity identifier. Example: 1.
      * @returns {Promise<ICollectionRowsResponce | IError>} Returns object ItemsWithTotal, where items is an array of requested objects.

package/esm/integration-collections/integrationCollectionsInterfaces.d.ts

@@ -8,23 +8,19 @@ interface ICollectionsApi {
      * Get all collections.
      * @handleName getICollections
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @param {ICollectionQuery} [userQuery] - Query parameters.
+     * @param {ICollectionsListQuery} [userQuery] - Query parameters.
      * @example
         {
           "limit": 30,
-          "offset": 0,
-          "entityType": "orders",
-          "entityId": 1
+          "offset": 0
         }
-     * @param {number} [userQuery.limit] - Parameter for pagination. Default: 0.
-     * @param {number} [userQuery.offset] - Parameter for pagination. Default: 30.
-     * @param {string} [userQuery.entityType] - Entity type. Example: "orders".
-     * @param {number} [userQuery.entityId] - Entity identifier. Example: 1.
+     * @param {number} [userQuery.limit] - Parameter for pagination. Default: 30.
+     * @param {number} [userQuery.offset] - Parameter for pagination. Default: 0.
      * @returns {ICollectionEntity[]} Returns an array of ICollection objects or an error object if there was an issue.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method gets all collections.
      */
-    getICollections(langCode?: string, userQuery?: ICollectionQuery): Promise<ICollectionEntity[] | IError>;
+    getICollections(langCode?: string, userQuery?: ICollectionsListQuery): Promise<ICollectionEntity[] | IError>;
     /**
      * Get a single collection object by id.
      * @handleName getICollectionById
@@ -205,7 +201,7 @@ interface ICollectionFormData {
  * Collection form object
  * @interface ICollectionFormObject
  * @property {string} formIdentifier - Text identifier (marker) of the form. Example: "collection-form".
- * @property {Record<string, ICollectionFormData>} formData - An object where keys are form field markers and values are arrays of ICollectionFormData objects.
+ * @property {ICollectionFormData[] | Record<string, ICollectionFormData[]>} formData - Field values: a flat array `[{ marker, type, value }]` (as in the example), or the same array wrapped in a language code — `{ "en_US": [...] }`. The platform stores both; the SDK sends the value as is.
  * @example
     [
       {
@@ -221,9 +217,7 @@ interface ICollectionFormData {
  */
 interface ICollectionFormObject {
     formIdentifier: string;
-    formData: {
-        [key: string]: ICollectionFormData[];
-    };
+    formData: ICollectionFormData[] | Record<string, ICollectionFormData[]>;
 }
 /**
  * Collection row object
@@ -301,17 +295,24 @@ interface ICollectionIsValid {
     valid: boolean;
 }
 /**
- * Query parameters for collection requests.
+ * Query parameters for collection row requests. All of them are optional.
  * @interface ICollectionQuery
- * @property {number} limit - Parameter for pagination. Default: 30.
- * @property {number} offset - Parameter for pagination. Default: 0.
- * @property {string} entityType - Entity type. Example: "orders".
- * @property {number} entityId - Entity identifier. Example: 1.
+ * @property {number} [limit] - Parameter for pagination. Default: 30.
+ * @property {number} [offset] - Parameter for pagination. Default: 0.
+ * @property {string} [entityType] - Entity type. Example: "orders".
+ * @property {number} [entityId] - Entity identifier. Example: 1.
  */
 interface ICollectionQuery {
-    limit: number;
-    offset: number;
-    entityType: string;
-    entityId: number;
+    limit?: number;
+    offset?: number;
+    entityType?: string;
+    entityId?: number;
 }
-export type { ICollectionEntity, ICollectionFormObject, ICollectionIsValid, ICollectionQuery, ICollectionResponce, ICollectionRow, ICollectionRowsResponce, ICollectionsApi, };
+/**
+ * Query parameters for getICollections: pagination only — the collection list takes no entity filter.
+ * @typedef {object} ICollectionsListQuery
+ * @property {number} [limit] - Parameter for pagination. Default: 30.
+ * @property {number} [offset] - Parameter for pagination. Default: 0.
+ */
+type ICollectionsListQuery = Pick<ICollectionQuery, 'limit' | 'offset'>;
+export type { ICollectionEntity, ICollectionFormObject, ICollectionIsValid, ICollectionQuery, ICollectionResponce, ICollectionRow, ICollectionRowsResponce, ICollectionsApi, ICollectionsListQuery, };

package/esm/orders/ordersApi.d.ts

@@ -1,6 +1,6 @@
 import AsyncModules from '../base/asyncModules.js';
 import type StateModule from '../base/stateModule.js';
-import type { IError } from '../base/utils.js';
+import type { IError, IVectorSearchResponse } from '../base/utils.js';
 import type { IBaseOrdersEntity, ICreateOrderPreview, ICreateRefundRequest, IOrderByMarkerEntity, IOrderData, IOrderPreviewResponse, IOrdersApi, IOrdersByMarkerEntity, IOrdersEntity, IOrderStatus, IOrdersVectorSearch, IRefundRequest } from './ordersInterfaces.js';
 /**
  * Controllers for working with orders.
@@ -204,13 +204,13 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IOrdersByMarkerEntity | IError>} Returns an object with an array of found orders and total count.
+     * @returns {Promise<IVectorSearchResponse<IOrdersByMarkerEntity> | IError>} Returns an object with an array of found orders and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search over the orders of the authorized user. It 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/orders/getOrdersByVectorSearch getOrdersByVectorSearch} documentation.
      */
-    getOrdersByVectorSearch(body: IOrdersVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IOrdersByMarkerEntity | IError>;
+    getOrdersByVectorSearch(body: IOrdersVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IOrdersByMarkerEntity> | IError>;
     /**
      * Runs a fetch against the `/orders` base URL instead of the default
      * `/orders-storage`, then restores the original URL.
@@ -224,4 +224,17 @@ export default class OrdersApi extends AsyncModules implements IOrdersApi {
      * @template T
      */
     private _withOrdersUrl;
+    /**
+     * Builds the order body the API expects: `formData` wrapped in a map keyed by locale.
+     *
+     * The wrapping is done on a copy. Writing it back into the caller's object made
+     * a reused body — a retry, a shared template — arrive wrapped twice: `createOrder`
+     * answered `400 formData's marker '#0' marker is required`, and
+     * `updateOrderByMarkerAndId` answered `200` and stored the broken `formData` in
+     * the order (CMS-1063).
+     * @param {IOrderData} body - Order body as the caller passed it. Left unchanged.
+     * @param {string} langCode - Locale key to wrap `formData` into.
+     * @returns {object} A new body with `formData` as `{ [langCode]: [...] }`.
+     */
+    private _wrapOrderFormData;
 }

package/esm/orders/ordersApi.js

@@ -149,13 +149,7 @@ export default class OrdersApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/orders/createOrder createOrder} documentation.
      */
     async createOrder(marker, body, langCode = this.state.lang) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const formData = {};
-        formData[langCode] = Array.isArray(body.formData)
-            ? body.formData
-            : [body.formData];
-        body.formData = formData;
-        const result = await this._fetchPost(`/marker/${marker}/orders`, body);
+        const result = await this._fetchPost(`/marker/${marker}/orders`, this._wrapOrderFormData(body, langCode));
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('CreateOrderResponseSchema'));
         return this._normalizeData(validated);
@@ -191,13 +185,7 @@ export default class OrdersApi extends AsyncModules {
      * @see {@link https://js-sdk.oneentry.cloud/docs/orders/updateOrderByMarkerAndId updateOrderByMarkerAndId} documentation.
      */
     async updateOrderByMarkerAndId(marker, id, body, langCode = this.state.lang) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const formData = {};
-        formData[langCode] = Array.isArray(body.formData)
-            ? body.formData
-            : [body.formData];
-        body.formData = formData;
-        const result = await this._fetchPut(`/marker/${marker}/orders/${id}?langCode=${langCode}`, body);
+        const result = await this._fetchPut(`/marker/${marker}/orders/${id}?langCode=${langCode}`, this._wrapOrderFormData(body, langCode));
         // Validate response if validation is enabled
         const validated = await this._validateResponse(result, schema('UpdateOrderResponseSchema'));
         return this._normalizeData(validated);
@@ -267,7 +255,7 @@ export default class OrdersApi extends AsyncModules {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IOrdersByMarkerEntity | IError>} Returns an object with an array of found orders and total count.
+     * @returns {Promise<IVectorSearchResponse<IOrdersByMarkerEntity> | IError>} Returns an object with an array of found orders and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search over the orders of the authorized user. It 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}.
@@ -304,4 +292,26 @@ export default class OrdersApi extends AsyncModules {
             this._url = savedUrl;
         }
     }
+    /**
+     * Builds the order body the API expects: `formData` wrapped in a map keyed by locale.
+     *
+     * The wrapping is done on a copy. Writing it back into the caller's object made
+     * a reused body — a retry, a shared template — arrive wrapped twice: `createOrder`
+     * answered `400 formData's marker '#0' marker is required`, and
+     * `updateOrderByMarkerAndId` answered `200` and stored the broken `formData` in
+     * the order (CMS-1063).
+     * @param {IOrderData} body - Order body as the caller passed it. Left unchanged.
+     * @param {string} langCode - Locale key to wrap `formData` into.
+     * @returns {object} A new body with `formData` as `{ [langCode]: [...] }`.
+     */
+    _wrapOrderFormData(body, langCode) {
+        return {
+            ...body,
+            formData: {
+                [langCode]: Array.isArray(body.formData)
+                    ? body.formData
+                    : [body.formData],
+            },
+        };
+    }
 }

package/esm/orders/ordersInterfaces.d.ts

@@ -1,4 +1,4 @@
-import type { IError, ILocalizeInfo } from '../base/utils.js';
+import type { IError, ILocalizeInfo, IVectorSearchResponse } from '../base/utils.js';
 /**
  * @interface IOrdersApi
  * @description Represents the API for managing orders in the order storage.
@@ -176,10 +176,10 @@ interface IOrdersApi {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IOrdersByMarkerEntity | IError>} Returns an object with an array of found orders and total count.
+     * @returns {Promise<IVectorSearchResponse<IOrdersByMarkerEntity> | IError>} Returns an object with an array of found orders and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      */
-    getOrdersByVectorSearch(body: IOrdersVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IOrdersByMarkerEntity | IError>;
+    getOrdersByVectorSearch(body: IOrdersVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IOrdersByMarkerEntity> | IError>;
 }
 /**
  * Body for semantic (vector) order search.
@@ -211,7 +211,7 @@ interface IOrdersVectorSearch {
         "formData": [
           {
           "marker": "order_name",
-          "value": "Ivan",
+          "value": "John",
           "type": "string"
           }
         ],
@@ -578,7 +578,7 @@ interface IOrderSplit {
     [
       {
         "marker": "order_name",
-        "value": "Ivan",
+        "value": "John",
         "type": "string"
       }
     ]

package/esm/pages/pagesApi.d.ts

@@ -1,6 +1,6 @@
 import AsyncModules from '../base/asyncModules.js';
 import type StateModule from '../base/stateModule.js';
-import type { IError } from '../base/utils.js';
+import type { IError, IVectorSearchResponse } from '../base/utils.js';
 import type { IPagesApi, IPageSearchResult, IPagesEntity, IPagesResponse, IPagesVectorSearch, IPositionBlock } from './pagesInterfaces.js';
 /**
  * Controllers for working with page objects, including catalog pages
@@ -88,7 +88,7 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @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.
+     * @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>;
@@ -99,12 +99,12 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IPagesResponse | IError>} Returns an object with an array of found pages and total count.
+     * @returns {Promise<IVectorSearchResponse<IPagesResponse> | IError>} Returns an object with an array of found pages and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for pages.
      * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getPagesByVectorSearch getPagesByVectorSearch} documentation.
      */
-    getPagesByVectorSearch(body: IPagesVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IPagesResponse | IError>;
+    getPagesByVectorSearch(body: IPagesVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IPagesResponse> | IError>;
     /**
      * Add template data to pages
      * @handleName addTemplateToPages

package/esm/pages/pagesApi.js

@@ -182,27 +182,23 @@ export default class PagesApi extends AsyncModules {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @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.
+     * @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) {
         // 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}lang=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
-        // /quick/search?url=catalog&langCode=en_US&name=cat
+        const searchPages = await this._fetchGet(`/quick/search?${urlPart}langCode=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
         // 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
         if (!this.state.traficLimit && Array.isArray(data)) {
-            // Initialize an empty array to store detailed page information
-            const pageList = [];
-            // Use Promise.all to fetch detailed information for each page concurrently
-            await Promise.all(data.map(async (page) => {
-                // Fetch detailed page information by page ID and push it to pageList
-                await this.getPageById(page.id, langCode).then((result) => {
-                    pageList.push(result);
-                });
-            }));
+            // Fetch detailed information for each page concurrently, keeping the search order
+            const fetched = await Promise.all(data.map((page) => this.getPageById(page.id, langCode)));
+            // A page the quick search found but getPageById could not load (404 in this
+            // language, closed route) is left out: an IError has no place in IPagesEntity[]
+            // 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);
             // Normalize the data and return it; ensures consistent structure or handles errors
@@ -219,7 +215,7 @@ export default class PagesApi extends AsyncModules {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IPagesResponse | IError>} Returns an object with an array of found pages and total count.
+     * @returns {Promise<IVectorSearchResponse<IPagesResponse> | IError>} Returns an object with an array of found pages and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for pages.
      * @see {@link https://js-sdk.oneentry.cloud/docs/pages/getPagesByVectorSearch getPagesByVectorSearch} documentation.

package/esm/pages/pagesInterfaces.d.ts

@@ -1,4 +1,4 @@
-import type { IAttributes, IAttributeValues, IError, ILocalizeInfo, IRating, LangType } from '../base/utils.js';
+import type { IAttributes, IAttributeValues, IError, ILocalizeInfo, IRating, IVectorSearchResponse, LangType } from '../base/utils.js';
 import type { BlockType, IBlockEntity } from '../blocks/blocksInterfaces.js';
 import type { IFormConfig } from '../forms/formsInterfaces.js';
 import type { IProductsEntity, IProductsResponse } from '../products/productsInterfaces.js';
@@ -84,11 +84,11 @@ interface IPagesApi {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {IPagesResponse} A promise that resolves to a pages response (items + total) or an error.
+     * @returns {IVectorSearchResponse<IPagesResponse>} A promise that resolves to a pages response (items + total + indexReady) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method performs a semantic (vector) search for pages.
      */
-    getPagesByVectorSearch(body: IPagesVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IPagesResponse | IError>;
+    getPagesByVectorSearch(body: IPagesVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IPagesResponse> | IError>;
 }
 /**
  * Body for semantic (vector) page search.

package/esm/product-statuses/productStatusesApi.d.ts

@@ -29,7 +29,7 @@ export default class ProductStatusesApi extends AsyncModules implements IProduct
     /**
      * Search for a product status object by its textual identifier (marker).
      * @handleName getProductsByStatusMarker
-     * @param {string} marker - Product marker. Example: "in_stock".
+     * @param {string} marker - Product status marker. Example: "in_stock".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IProductStatusEntity | IError>} Returns a product status object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -40,7 +40,7 @@ export default class ProductStatusesApi extends AsyncModules implements IProduct
     /**
      * Check the existence of a textual identifier.
      * @handleName validateMarker
-     * @param {string} marker - Product marker. Example: "in_stock".
+     * @param {string} marker - Product status marker. Example: "in_stock".
      * @returns {Promise<boolean | IError>} Returns true if the textual identifier (marker) exists or false if it doesn't.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Check the existence of a textual identifier.

package/esm/product-statuses/productStatusesApi.js

@@ -34,7 +34,7 @@ export default class ProductStatusesApi extends AsyncModules {
     /**
      * Search for a product status object by its textual identifier (marker).
      * @handleName getProductsByStatusMarker
-     * @param {string} marker - Product marker. Example: "in_stock".
+     * @param {string} marker - Product status marker. Example: "in_stock".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {Promise<IProductStatusEntity | IError>} Returns a product status object.
      * @throws {IError} When isShell=false and an error occurs during the fetch
@@ -50,7 +50,7 @@ export default class ProductStatusesApi extends AsyncModules {
     /**
      * Check the existence of a textual identifier.
      * @handleName validateMarker
-     * @param {string} marker - Product marker. Example: "in_stock".
+     * @param {string} marker - Product status marker. Example: "in_stock".
      * @returns {Promise<boolean | IError>} Returns true if the textual identifier (marker) exists or false if it doesn't.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Check the existence of a textual identifier.

package/esm/product-statuses/productStatusesInterfaces.d.ts

@@ -16,7 +16,7 @@ interface IProductStatusesApi {
     /**
      * Search for a product status object by its textual identifier (marker).
      * @handleName getProductsByStatusMarker
-     * @param {string} marker - Product marker. Example: "in_stock".
+     * @param {string} marker - Product status marker. Example: "in_stock".
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @returns {IProductStatusEntity} Returns a product status object.
      * @throws {IError} If there is an error during the fetch operation, it will return an error object.
@@ -26,7 +26,7 @@ interface IProductStatusesApi {
     /**
      * Check the existence of a textual identifier.
      * @handleName validateMarker
-     * @param {string} marker - Product marker. Example: "in_stock".
+     * @param {string} marker - Product status marker. Example: "in_stock".
      * @returns {boolean} Returns true if the textual identifier (marker) exists or false if it doesn't.
      * @throws {IError} If there is an error during the fetch operation, it will return an error object.
      * @description This method checks the existence of a textual identifier.

package/esm/products/productsApi.d.ts

@@ -1,7 +1,7 @@
 import AsyncModules from '../base/asyncModules.js';
 import type StateModule from '../base/stateModule.js';
-import type { IError } from '../base/utils.js';
-import type { IAggregatedProductGroup, IFilterParams, IProductBlock, IProductsApi, IProductsByIdsQuery, IProductsCount, IProductSearchResult, IProductsEntity, IProductsInfo, IProductsPriceQuery, IProductsQueryBase, IProductsRelatedQuery, IProductsResponse, IVectorSearchProducts } from './productsInterfaces.js';
+import type { IError, IVectorSearchResponse } from '../base/utils.js';
+import type { IFilterParams, IProductBlock, IProductsApi, IProductsByIdsQuery, IProductsCount, IProductSearchResult, IProductsEntity, IProductsInfo, IProductsPriceQuery, IProductsQueryBase, IProductsRelatedQuery, IProductsResponse, IVectorSearchProducts } from './productsInterfaces.js';
 /**
  * Controllers for working with product pages
  * @handle /api/content/products
@@ -77,12 +77,12 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
           "sortKey": "id",
           "signPrice": "orders"
         }
-     * @returns {Promise<IAggregatedProductGroup[] | IError>} Array with AggregatedProductGroup objects.
+     * @returns {Promise<IProductsResponse | IError>} Products without a category: `{ items, total }`, the same container as getProducts.
      * @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?: IProductsQueryBase): Promise<IAggregatedProductGroup[] | IError>;
+    getProductsEmptyPage(body?: object, langCode?: string, userQuery?: IProductsQueryBase): Promise<IProductsResponse | IError>;
     /**
      * Search for all products with pagination for the selected category.
      * @handleName getProductsByPageId
@@ -213,6 +213,7 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @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.relationMode] - How relations are computed: "global" (default) or "local", which also requires the product `id` itself to satisfy the template condition. Example: "local".
      * @returns {Promise<IProductsResponse | IError>} Array with ProductEntity objects
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Find all related product page objects.
@@ -350,12 +351,12 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of found products and total count.
+     * @returns {Promise<IVectorSearchResponse<IProductsResponse> | IError>} Returns an object with an array of found products and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for products.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsByVectorSearch getProductsByVectorSearch} documentation.
      */
-    getProductsByVectorSearch(body: IVectorSearchProducts, langCode?: string, offset?: number, limit?: number): Promise<IProductsResponse | IError>;
+    getProductsByVectorSearch(body: IVectorSearchProducts, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IProductsResponse> | IError>;
     /**
      * Get products by page url.
      * @param {string} url - Page url.

package/esm/products/productsApi.js

@@ -87,7 +87,7 @@ export default class ProductsApi extends AsyncModules {
           "sortKey": "id",
           "signPrice": "orders"
         }
-     * @returns {Promise<IAggregatedProductGroup[] | IError>} Array with AggregatedProductGroup objects.
+     * @returns {Promise<IProductsResponse | IError>} Products without a category: `{ items, total }`, the same container as getProducts.
      * @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.
@@ -95,7 +95,9 @@ export default class ProductsApi extends AsyncModules {
     async getProductsEmptyPage(body = {}, langCode = this.state.lang, userQuery) {
         const query = { ...userQuery, langCode };
         const result = await this._fetchPost(`/empty-page?` + this._queryParamsToString(query), body);
-        return this._normalizeData(result);
+        // Validate response if validation is enabled
+        const validated = await this._validateResponse(result, schema('ProductsResponseSchema'));
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Search for all products with pagination for the selected category.
@@ -247,6 +249,7 @@ export default class ProductsApi extends AsyncModules {
      * @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.relationMode] - How relations are computed: "global" (default) or "local", which also requires the product `id` itself to satisfy the template condition. Example: "local".
      * @returns {Promise<IProductsResponse | IError>} Array with ProductEntity objects
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Find all related product page objects.
@@ -439,7 +442,7 @@ export default class ProductsApi extends AsyncModules {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IProductsResponse | IError>} Returns an object with an array of found products and total count.
+     * @returns {Promise<IVectorSearchResponse<IProductsResponse> | IError>} Returns an object with an array of found products and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for products.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/getProductsByVectorSearch getProductsByVectorSearch} documentation.