oneentry 1.0.171 → 1.0.173

package/dist/product-statuses/productStatusesApi.js

@@ -72,7 +72,7 @@ class ProductStatusesApi extends asyncModules_1.default {
     /**
      * 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
@@ -88,7 +88,7 @@ class ProductStatusesApi extends asyncModules_1.default {
     /**
      * 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/dist/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/dist/products/productsApi.d.ts

@@ -1,7 +1,7 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
-import type { IError } from '../base/utils';
-import type { IAggregatedProductGroup, IFilterParams, IProductBlock, IProductsApi, IProductsByIdsQuery, IProductsCount, IProductSearchResult, IProductsEntity, IProductsInfo, IProductsPriceQuery, IProductsQueryBase, IProductsRelatedQuery, IProductsResponse, IVectorSearchProducts } from './productsInterfaces';
+import type { IError, IVectorSearchResponse } from '../base/utils';
+import type { IFilterParams, IProductBlock, IProductsApi, IProductsByIdsQuery, IProductsCount, IProductSearchResult, IProductsEntity, IProductsInfo, IProductsPriceQuery, IProductsQueryBase, IProductsRelatedQuery, IProductsResponse, IVectorSearchProducts } from './productsInterfaces';
 /**
  * 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/dist/products/productsApi.js

@@ -125,7 +125,7 @@ class ProductsApi extends asyncModules_1.default {
           "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.
@@ -133,7 +133,9 @@ class ProductsApi extends asyncModules_1.default {
     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.
@@ -285,6 +287,7 @@ class ProductsApi extends asyncModules_1.default {
      * @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.
@@ -477,7 +480,7 @@ class ProductsApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @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.

package/dist/products/productsInterfaces.d.ts

@@ -1,4 +1,4 @@
-import type { IAttributeValues, IError, ILocalizeInfo, IRating } from '../base/utils';
+import type { IAttributeValues, IError, ILocalizeInfo, IRating, IVectorSearchResponse } from '../base/utils';
 import type { BlockType } from '../blocks/blocksInterfaces';
 import type { IFormConfig } from '../forms/formsInterfaces';
 /**
@@ -62,11 +62,11 @@ interface IProductsApi {
           "sortKey": "id",
           "signPrice": "orders"
         }
-     * @returns {IProductsResponse} Array with ProductEntity objects.
+     * @returns {Promise<IProductsResponse | IError>} Products without a category: `{ items, total }`, the same container as getProducts.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method searches for all product page objects with pagination that do not have a category.
      */
-    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
@@ -299,18 +299,18 @@ interface 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 {IProductsResponse} A promise that resolves to a products response (items + total) or an error.
+     * @returns {IVectorSearchResponse<IProductsResponse>} A promise that resolves to a products 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 products.
      */
-    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>;
 }
 /**
  * @interface IProductsQueryBase
  * @property {number} offset - Parameter for pagination. Default: 0.
  * @property {number} limit - Parameter for pagination. Default: 30.
  * @property {string} sortOrder - Sort order "DESC" | "ASC". Default: "DESC".
- * @property {string} sortKey - Field for sorting (default - null). Possible values: "id", "position", "title", "date", "price". Default: null.
+ * @property {string} sortKey - Field for sorting (default - null). Possible values: "id", "position", "title", "date", "price", "status". Default: null.
  * @property {string} [signPrice] - Order storage marker for price fixing. If the parameter is set, the price is fixed for a certain time.
  * @see {@link https://js-sdk.oneentry.cloud/docs/products/#Fixing-the-price-signPrice Fixing the price} documentation.
  * @description Base query parameters shared by the product listing endpoints (getProducts, getProductsEmptyPage, getProductsByPageId, getProductsByPageUrl): pagination, sorting and price fixing.
@@ -319,7 +319,7 @@ interface IProductsQueryBase {
     offset?: number;
     limit?: number;
     sortOrder?: 'DESC' | 'ASC' | null;
-    sortKey?: 'id' | 'position' | 'title' | 'date' | 'price' | null;
+    sortKey?: 'id' | 'position' | 'title' | 'date' | 'price' | 'status' | null;
     signPrice?: string;
 }
 /**
@@ -327,11 +327,13 @@ interface IProductsQueryBase {
  * @augments IProductsQueryBase
  * @property {string | null} [statusMarker] - Product page status marker, default null. Example: "in_stock".
  * @property {string | null} [templateMarker] - Product page template marker, default null. Example: "template_12345".
- * @description Query parameters for getRelatedProductsById: the base query plus product page status and template markers.
+ * @property {string} [relationMode] - How relations are computed: "global" (the default) runs the template's chain of conditions as is; "local" additionally requires the attribute value of the product `id` to satisfy the template condition (same operator, same stored operand) before the products of that step are kept. Example: "local".
+ * @description Query parameters for getRelatedProductsById: the base query plus product page status and template markers and the relation mode.
  */
 interface IProductsRelatedQuery extends IProductsQueryBase {
     statusMarker?: string | null;
     templateMarker?: string | null;
+    relationMode?: 'global' | 'local';
 }
 /**
  * Query parameters for getProductsPriceByPageUrl: the base query without
@@ -365,9 +367,9 @@ type IProductsByIdsQuery = Pick<IProductsQueryBase, 'signPrice'>;
 type IProductsQuery = IProductsQueryBase;
 /**
  * @interface IFilterParams
- * @property {string | null} attributeMarker - The text identifier of the indexed attribute by which values are filtered. Default: null. Example: "color".
- * @property {string | null} [conditionMarker] - Id of the filter condition by which the values are filtered. Default: null. Example: "equals".
- * @property {number | string | null} conditionValue - The value that is being searched for, default null. Example: "new".
+ * @property {string} [attributeMarker] - The text identifier of the indexed attribute by which values are filtered. Example: "color". Optional: a filter entry may select by `statusMarker` (or `pageUrls`, `title`) alone, e.g. `{ statusMarker: "in_stock" }`.
+ * @property {string | null} [conditionMarker] - Id of the filter condition by which the values are filtered. Default: null. Example: "eq".
+ * @property {number | string | null} [conditionValue] - The value that is being searched for, default null. Example: "new". Needed together with `attributeMarker`.
  * @property {string | null} [pageUrl] - Url of the category page object. Example: ["23-laminat-floorwood-maxima"].
  * @property {string[] | null} [pageUrls] - Url of the category page object. Example: ["23-laminat-floorwood-maxima"].
  * @property {string | null} [statusMarker] - Text identifier of the product page status (default not set). Example: "in_stock".
@@ -376,9 +378,9 @@ type IProductsQuery = IProductsQueryBase;
  * @description This interface defines the structure of filter parameters used for querying products, including conditions, attributes, and pagination.
  */
 interface IFilterParams {
-    attributeMarker: string;
+    attributeMarker?: string;
     conditionMarker?: 'in' /** 'in' - Contains */ | 'nin' /** 'nin' - Does not contain */ | 'eq' /** 'eq' - Equal */ | 'neq' /** 'neq' - Not equal */ | 'mth' /** 'mth' - Greater than */ | 'lth' /** 'lth' - Less than */ | 'exs' /** 'exs' - Exists */ | 'nexs' /** 'nexs' - Does not exist */ | 'pat' /** 'pat' - Matches pattern */ | 'same' /** 'same' - Matches the value exactly */ | 'same_part' /** 'same_part' - Matches a part of the value exactly */ | null;
-    conditionValue: number | string | null;
+    conditionValue?: number | string | null;
     pageUrl?: string | null;
     pageUrls?: string[] | null;
     statusMarker?: string;
@@ -694,6 +696,9 @@ interface IProductBlock {
 }
 /**
  * @interface IAggregatedProductGroup
+ * @deprecated No method returns this shape: getProductsEmptyPage was declared with it,
+ * but the endpoint answers `{ items, total }` — see IProductsResponse (CMS-1065).
+ * Kept so that existing imports still compile.
  * @property {string} attrValue - Attribute value.
  * @property {IProductsEntity[]} items - Array of product entities.
  * @property {string[]} productIds - Array of product ids.

package/dist/system/systemApi.d.ts

@@ -1,7 +1,7 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
 import type { IError } from '../base/utils';
-import type { ISystemApi } from './systemInterfaces';
+import type { IApiStatEntry, ISystemApi } from './systemInterfaces';
 /**
  * Controllers for working with system components
  * @handle /api/content/system
@@ -37,10 +37,10 @@ export default class SystemApi extends AsyncModules implements ISystemApi {
     /**
      * Getting the number of requests to API.
      * @handleName getApiStat
-     * @returns {Promise<unknown | IError>} Return object with date and count.
+     * @returns {Promise<IApiStatEntry[] | IError>} Array of one-key objects `{ [YYYY-MM-DD]: count }`, one per day. Example: `[{ "2026-10-25": 17280 }, { "2026-10-26": 13671 }]`.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Getting the number of requests to API.
+     * @description Getting the number of requests to API, per day.
      * @see {@link https://js-sdk.oneentry.cloud/docs/system/getApiStat getApiStat} documentation.
      */
-    getApiStat(): Promise<unknown>;
+    getApiStat(): Promise<IApiStatEntry[] | IError>;
 }

package/dist/system/systemApi.js

@@ -46,9 +46,9 @@ class SystemApi extends asyncModules_1.default {
     /**
      * Getting the number of requests to API.
      * @handleName getApiStat
-     * @returns {Promise<unknown | IError>} Return object with date and count.
+     * @returns {Promise<IApiStatEntry[] | IError>} Array of one-key objects `{ [YYYY-MM-DD]: count }`, one per day. Example: `[{ "2026-10-25": 17280 }, { "2026-10-26": 13671 }]`.
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Getting the number of requests to API.
+     * @description Getting the number of requests to API, per day.
      * @see {@link https://js-sdk.oneentry.cloud/docs/system/getApiStat getApiStat} documentation.
      */
     async getApiStat() {

package/dist/system/systemInterfaces.d.ts

@@ -19,11 +19,17 @@ interface ISystemApi {
      */
     test500(): Promise<unknown | IError>;
     /**
-     * getApiStat
+     * Getting the number of requests to API.
      * @handleName getApiStat
-     * @returns {unknown} Returns a Promise that resolves with any data.
-     * @description This method getApiStat.
+     * @returns {Promise<IApiStatEntry[] | IError>} Array of one-key objects `{ [YYYY-MM-DD]: count }`, one per day. Example: `[{ "2026-10-25": 17280 }, { "2026-10-26": 13671 }]`.
+     * @description Getting the number of requests to API, per day.
      */
-    getApiStat(): Promise<unknown>;
+    getApiStat(): Promise<IApiStatEntry[] | IError>;
 }
-export type { ISystemApi };
+/**
+ * One day of API request statistics: a single key — the date `YYYY-MM-DD` — holding the number of requests.
+ * @typedef {Record<string, number>} IApiStatEntry
+ * @description Element of the array returned by getApiStat. Example: `{ "2026-10-26": 13671 }`.
+ */
+type IApiStatEntry = Record<string, number>;
+export type { IApiStatEntry, ISystemApi };

package/dist/templates/templatesApi.d.ts

@@ -22,7 +22,7 @@ export default class TemplatesPreviewApi extends AsyncModules implements ITempla
      * Get all template objects grouped by types.
      * @handleName getAllTemplates
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<Record<BlockType, ITemplateEntity[]> | IError>} Returns an object GroupedTemplatesObject, which contains an array of template objects TemplateEntity
+     * @returns {Promise<Record<BlockType, ITemplateEntity[]> | IError>} Object keyed by `BlockType`; each value is an array of `ITemplateEntity` of that type.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This function is designed to fetch organized template objects in groups based on their types.
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates/getAllTemplates getAllTemplates} documentation.
@@ -33,7 +33,7 @@ export default class TemplatesPreviewApi extends AsyncModules implements ITempla
      * @handleName getTemplateByType
      * @param {BlockType} type - The type of templates to retrieve. This parameter specifies the category or classification of templates being requested. Example: "product".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<ITemplateEntity[] | IError>} Returns a TemplateEntity object.
+     * @returns {Promise<ITemplateEntity[] | IError>} Array of `ITemplateEntity` objects of the given type.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Fetch template objects that belong to a specific type, with an optional filter by language.
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates/getTemplateByType getTemplateByType} documentation.
@@ -44,7 +44,7 @@ export default class TemplatesPreviewApi extends AsyncModules implements ITempla
      * @handleName getTemplateByMarker
      * @param {string} marker - The unique marker of the template to retrieve. Example: "template_12345".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<ITemplateEntity | IError>} Returns a TemplateEntity object
+     * @returns {Promise<ITemplateEntity | IError>} Returns an `ITemplateEntity` object
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Fetch a specific template object based on its unique marker.
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates/getTemplateByMarker getTemplateByMarker} documentation.

package/dist/templates/templatesApi.js

@@ -60,7 +60,7 @@ class TemplatesPreviewApi extends asyncModules_1.default {
      * Get all template objects grouped by types.
      * @handleName getAllTemplates
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<Record<BlockType, ITemplateEntity[]> | IError>} Returns an object GroupedTemplatesObject, which contains an array of template objects TemplateEntity
+     * @returns {Promise<Record<BlockType, ITemplateEntity[]> | IError>} Object keyed by `BlockType`; each value is an array of `ITemplateEntity` of that type.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This function is designed to fetch organized template objects in groups based on their types.
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates/getAllTemplates getAllTemplates} documentation.
@@ -86,7 +86,7 @@ class TemplatesPreviewApi extends asyncModules_1.default {
      * @handleName getTemplateByType
      * @param {BlockType} type - The type of templates to retrieve. This parameter specifies the category or classification of templates being requested. Example: "product".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<ITemplateEntity[] | IError>} Returns a TemplateEntity object.
+     * @returns {Promise<ITemplateEntity[] | IError>} Array of `ITemplateEntity` objects of the given type.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Fetch template objects that belong to a specific type, with an optional filter by language.
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates/getTemplateByType getTemplateByType} documentation.
@@ -102,7 +102,7 @@ class TemplatesPreviewApi extends asyncModules_1.default {
      * @handleName getTemplateByMarker
      * @param {string} marker - The unique marker of the template to retrieve. Example: "template_12345".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<ITemplateEntity | IError>} Returns a TemplateEntity object
+     * @returns {Promise<ITemplateEntity | IError>} Returns an `ITemplateEntity` object
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Fetch a specific template object based on its unique marker.
      * @see {@link https://js-sdk.oneentry.cloud/docs/templates/getTemplateByMarker getTemplateByMarker} documentation.

package/dist/templates/templatesInterfaces.d.ts

@@ -9,7 +9,7 @@ interface ITemplatesApi {
      * Get all template objects grouped by types.
      * @handleName getAllTemplates
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Record<BlockType, ITemplateEntity[]>} Returns an object GroupedTemplatesObject, which contains an array of template objects TemplateEntity
+     * @returns {Record<BlockType, ITemplateEntity[]>} Object keyed by `BlockType`; each value is an array of `ITemplateEntity` of that type.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method gets all template objects grouped by types.
      */
@@ -19,7 +19,7 @@ interface ITemplatesApi {
      * @handleName getTemplateByType
      * @param {BlockType} type - The type of templates to retrieve. This parameter specifies the category or classification of templates being requested. Example: "product".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {ITemplateEntity[]} Returns a TemplateEntity object.
+     * @returns {ITemplateEntity[]} Array of `ITemplateEntity` objects of the given type.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method gets template objects by type.
      */
@@ -29,7 +29,7 @@ interface ITemplatesApi {
      * @handleName getTemplateByMarker
      * @param {string} marker - The unique marker of the template to retrieve. Example: "template_12345".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {ITemplateEntity} Returns a TemplateEntity object
+     * @returns {ITemplateEntity} Returns an `ITemplateEntity` object
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method gets one template object by id.
      */

package/dist/user-activity/userActivityApi.js

@@ -31,13 +31,10 @@ class UserActivityApi extends asyncModules_1.default {
      * @see {@link https://js-sdk.oneentry.cloud/docs/user-activity/trackUserActivity trackUserActivity} documentation.
      */
     async trackUserActivity(body) {
-        try {
-            await this._fetchPost(`/track`, body);
-            return true;
-        }
-        catch (e) {
-            return e;
-        }
+        // The endpoint answers 204: success is the absence of an error. Through
+        // _fetchBoolean a 400 comes back as IError instead of `true`, and with
+        // isShell=false it is thrown as documented (CMS-1064)
+        return this._fetchBoolean(() => this._fetchPost(`/track`, body));
     }
 }
 exports.default = UserActivityApi;

package/dist/users/usersApi.d.ts

@@ -1,6 +1,6 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
-import type { IError } from '../base/utils';
+import type { IError, IVectorSearchResponse } from '../base/utils';
 import type { ICartAddItem, ICartResponse, ICartSet, IUserBody, IUserEntity, IUsersApi, IUsersResponse, IUsersVectorSearch, IWishlistAddItem, IWishlistResponse, IWishlistSet } from './usersInterfaces';
 /**
  * Controllers for working with users
@@ -239,11 +239,11 @@ export default class UsersApi extends AsyncModules implements IUsersApi {
      * @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<IUsersResponse | IError>} Returns an object with an array of found users and total count.
+     * @returns {Promise<IVectorSearchResponse<IUsersResponse> | IError>} Returns an object with an array of found users and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for users. 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/users/getUsersByVectorSearch getUsersByVectorSearch} documentation.
      */
-    getUsersByVectorSearch(body: IUsersVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IUsersResponse | IError>;
+    getUsersByVectorSearch(body: IUsersVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IUsersResponse> | IError>;
 }

package/dist/users/usersApi.js

@@ -332,7 +332,7 @@ class UsersApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {Promise<IUsersResponse | IError>} Returns an object with an array of found users and total count.
+     * @returns {Promise<IVectorSearchResponse<IUsersResponse> | IError>} Returns an object with an array of found users and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for users. 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}.

package/dist/users/usersInterfaces.d.ts

@@ -1,5 +1,5 @@
 import type { IAuthData, IAuthFormData, INotificationData } from '../auth-provider/authProvidersInterfaces';
-import type { IError, IRating } from '../base/utils';
+import type { IError, IRating, IVectorSearchResponse } from '../base/utils';
 import type { IFormConfig } from '../forms/formsInterfaces';
 import type { FormDataType } from '../forms-data/formsDataInterfaces';
 /**
@@ -217,12 +217,12 @@ interface IUsersApi {
      * @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<IUsersResponse | IError>} A promise resolving to a users response (items + total), or an error.
+     * @returns {Promise<IVectorSearchResponse<IUsersResponse> | IError>} A promise resolving to a users response (items + total), 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 users. 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}.
      */
-    getUsersByVectorSearch(body: IUsersVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IUsersResponse | IError>;
+    getUsersByVectorSearch(body: IUsersVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IUsersResponse> | IError>;
 }
 /**
  * Body for semantic (vector) user search.

package/esm/admins/adminsApi.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 { IFilterParams } from '../products/productsInterfaces.js';
 import type { IAdminEntity, IAdmins, IAdminsResponse, IAdminsVectorSearch } from './adminsInterfaces.js';
 /**
@@ -57,10 +57,10 @@ export default class AdminsApi extends AsyncModules implements IAdmins {
      * @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<IAdminsResponse | IError>} Returns an object with an array of found admins and total count.
+     * @returns {Promise<IVectorSearchResponse<IAdminsResponse> | IError>} Returns an object with an array of found admins and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for admins.
      * @see {@link https://js-sdk.oneentry.cloud/docs/admins/getAdminsByVectorSearch getAdminsByVectorSearch} documentation.
      */
-    getAdminsByVectorSearch(body: IAdminsVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IAdminsResponse | IError>;
+    getAdminsByVectorSearch(body: IAdminsVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IAdminsResponse> | IError>;
 }

package/esm/admins/adminsApi.js

@@ -66,7 +66,7 @@ export default class AdminsApi 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<IAdminsResponse | IError>} Returns an object with an array of found admins and total count.
+     * @returns {Promise<IVectorSearchResponse<IAdminsResponse> | IError>} Returns an object with an array of found admins and total count.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method performs a semantic (vector) search for admins.
      * @see {@link https://js-sdk.oneentry.cloud/docs/admins/getAdminsByVectorSearch getAdminsByVectorSearch} documentation.

package/esm/admins/adminsInterfaces.d.ts

@@ -1,4 +1,4 @@
-import type { IAttributeValues, IError } from '../base/utils.js';
+import type { IAttributeValues, IError, IVectorSearchResponse } from '../base/utils.js';
 import type { IFormConfig } from '../forms/formsInterfaces.js';
 import type { IFilterParams } from '../products/productsInterfaces.js';
 /**
@@ -40,10 +40,10 @@ interface IAdmins {
      * @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 {IAdminsResponse} Returns an object with an array of found admins and total count.
+     * @returns {IVectorSearchResponse<IAdminsResponse>} Returns an object with an array of found admins, total count and indexReady.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getAdminsByVectorSearch(body: IAdminsVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IAdminsResponse | IError>;
+    getAdminsByVectorSearch(body: IAdminsVectorSearch, langCode?: string, offset?: number, limit?: number): Promise<IVectorSearchResponse<IAdminsResponse> | IError>;
 }
 /**
  * Body for semantic (vector) admin search.

package/esm/auth-provider/authProviderApi.d.ts

@@ -233,9 +233,9 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * Getting active user sessions data.
      * @handleName getActiveSessionsByMarker
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
-     * @returns {Promise<IActiveSession[] | IError>} Returns an auth provider object.
+     * @returns {Promise<IActiveSession[] | IError>} Array of the authenticated user's active sessions for this provider, one per device (`deviceInfo`).
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Getting a single authorization provider object by marker.
+     * @description Getting the authenticated user's active sessions for the authorization provider. This method requires user authorization.
      * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/getActiveSessionsByMarker getActiveSessionsByMarker} documentation.
      */
     getActiveSessionsByMarker(marker: string): Promise<IActiveSession[] | IError>;

package/esm/auth-provider/authProviderApi.js

@@ -328,9 +328,9 @@ export default class AuthProviderApi extends AsyncModules {
      * Getting active user sessions data.
      * @handleName getActiveSessionsByMarker
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
-     * @returns {Promise<IActiveSession[] | IError>} Returns an auth provider object.
+     * @returns {Promise<IActiveSession[] | IError>} Array of the authenticated user's active sessions for this provider, one per device (`deviceInfo`).
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Getting a single authorization provider object by marker.
+     * @description Getting the authenticated user's active sessions for the authorization provider. This method requires user authorization.
      * @see {@link https://js-sdk.oneentry.cloud/docs/auth-provider/getActiveSessionsByMarker getActiveSessionsByMarker} documentation.
      */
     async getActiveSessionsByMarker(marker) {

package/esm/auth-provider/authProvidersInterfaces.d.ts

@@ -405,11 +405,11 @@ interface IAuthPostBody {
     {
       "os": "Win32",
       "browser": "Node.js/22",
-      "location": "ru-RU"
+      "location": "en-US"
     }
  * @property {string} deviceInfo.os - The operating system of the active session. Example: "Win32".
  * @property {string} deviceInfo.browser - The browser used in the active session. Example: "Node.js/22".
- * @property {string} deviceInfo.location - The location of the active session. Example: "ru-RU".
+ * @property {string} deviceInfo.location - The location of the active session. Example: "en-US".
  * @description This interface defines the structure of the body used in authentication requests, containing an array of authentication data.
  */
 interface IActiveSession {
@@ -419,7 +419,7 @@ interface IActiveSession {
  * @interface IDeviceInfo
  * @property {string} os - The operating system of the active session. Example: "Win32".
  * @property {string} browser - The browser used in the active session. Example: "Node.js/22".
- * @property {string} location - The locale of the active session. Example: "ru-RU".
+ * @property {string} location - The locale of the active session. Example: "en-US".
  * @description Information about the device tied to an active authentication session.
  */
 interface IDeviceInfo {

package/esm/base/asyncModules.d.ts

@@ -79,8 +79,13 @@ export default abstract class AsyncModules extends SyncModules {
      * (the default) browserResponse returns the API error instead of throwing
      * it, so relying on the catch alone would report every failed call — a 404
      * from cancelSubscription, a 403 from recoverSubscriptions — as a success.
+     *
+     * With `isShell` disabled browserResponse throws, and the error is thrown on
+     * from here too: returning it would break the `@throws` contract every caller
+     * documents, and a `try/catch` around the call would never fire (CMS-1067).
      * @param {() => Promise<unknown>} request - Thunk performing the fetch call.
-     * @returns {Promise<boolean | IError>} `true` on success, IError on failure.
+     * @returns {Promise<boolean | IError>} `true` on success, IError on failure when isShell=true.
+     * @throws {IError} When isShell=false and the request fails.
      */
     protected _fetchBoolean(request: () => Promise<unknown>): Promise<boolean | IError>;
     /**

package/esm/base/asyncModules.js

@@ -130,8 +130,13 @@ export default class AsyncModules extends SyncModules {
      * (the default) browserResponse returns the API error instead of throwing
      * it, so relying on the catch alone would report every failed call — a 404
      * from cancelSubscription, a 403 from recoverSubscriptions — as a success.
+     *
+     * With `isShell` disabled browserResponse throws, and the error is thrown on
+     * from here too: returning it would break the `@throws` contract every caller
+     * documents, and a `try/catch` around the call would never fire (CMS-1067).
      * @param {() => Promise<unknown>} request - Thunk performing the fetch call.
-     * @returns {Promise<boolean | IError>} `true` on success, IError on failure.
+     * @returns {Promise<boolean | IError>} `true` on success, IError on failure when isShell=true.
+     * @throws {IError} When isShell=false and the request fails.
      */
     async _fetchBoolean(request) {
         try {
@@ -142,6 +147,9 @@ export default class AsyncModules extends SyncModules {
             return true;
         }
         catch (e) {
+            if (!this.state.isShell) {
+                throw e;
+            }
             return e;
         }
     }