oneentry 1.0.156 → 1.0.158

package/dist/orders/ordersSchemas.d.ts

@@ -69,6 +69,10 @@ export declare const OrderEntitySchema: z.ZodObject<{
     isPartial: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     paymentStrategy: z.ZodOptional<z.ZodString>;
     statusLocalizeInfos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    fulfillmentStatusIdentifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    fulfillmentStatusLocalizeInfos: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    paymentStatusIdentifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    paymentStatusLocalizeInfos: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
     discountConfig: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         bonus: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             availableBalance: z.ZodNumber;
@@ -133,6 +137,10 @@ export declare const OrdersResponseSchema: z.ZodObject<{
         isPartial: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         paymentStrategy: z.ZodOptional<z.ZodString>;
         statusLocalizeInfos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        fulfillmentStatusIdentifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fulfillmentStatusLocalizeInfos: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+        paymentStatusIdentifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        paymentStatusLocalizeInfos: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
         discountConfig: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             bonus: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                 availableBalance: z.ZodNumber;
@@ -220,6 +228,7 @@ export declare const CreateOrderResponseSchema: z.ZodObject<{
     totalSum: z.ZodNumber;
     createdDate: z.ZodOptional<z.ZodString>;
     statusIdentifier: z.ZodOptional<z.ZodString>;
+    statusLocalizeInfos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     couponCode: z.ZodOptional<z.ZodString>;
     additionalDiscountsMarkers: z.ZodOptional<z.ZodArray<z.ZodString>>;
     discountConfig: z.ZodOptional<z.ZodObject<{
@@ -267,6 +276,7 @@ export declare const UpdateOrderResponseSchema: z.ZodObject<{
     totalSum: z.ZodNumber;
     createdDate: z.ZodOptional<z.ZodString>;
     statusIdentifier: z.ZodOptional<z.ZodString>;
+    statusLocalizeInfos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     couponCode: z.ZodOptional<z.ZodString>;
     additionalDiscountsMarkers: z.ZodOptional<z.ZodArray<z.ZodString>>;
     discountConfig: z.ZodOptional<z.ZodObject<{

package/dist/orders/ordersSchemas.js

@@ -75,6 +75,16 @@ exports.OrderEntitySchema = zod_1.z.object({
     isPartial: zod_1.z.boolean().nullable().optional(),
     paymentStrategy: zod_1.z.string().optional(),
     statusLocalizeInfos: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+    fulfillmentStatusIdentifier: zod_1.z.string().nullable().optional(),
+    fulfillmentStatusLocalizeInfos: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.any())
+        .nullable()
+        .optional(),
+    paymentStatusIdentifier: zod_1.z.string().nullable().optional(),
+    paymentStatusLocalizeInfos: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.any())
+        .nullable()
+        .optional(),
     discountConfig: exports.OrderDiscountConfigSchema.nullable().optional(),
     split: zod_1.z
         .object({
@@ -132,6 +142,7 @@ exports.CreateOrderResponseSchema = zod_1.z.object({
     totalSum: zod_1.z.number(),
     createdDate: zod_1.z.string().optional(),
     statusIdentifier: zod_1.z.string().optional(),
+    statusLocalizeInfos: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
     couponCode: zod_1.z.string().optional(),
     additionalDiscountsMarkers: zod_1.z.array(zod_1.z.string()).optional(),
     discountConfig: exports.OrderDiscountConfigSchema.optional(),
@@ -153,6 +164,7 @@ exports.UpdateOrderResponseSchema = zod_1.z.object({
     totalSum: zod_1.z.number(),
     createdDate: zod_1.z.string().optional(),
     statusIdentifier: zod_1.z.string().optional(),
+    statusLocalizeInfos: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
     couponCode: zod_1.z.string().optional(),
     additionalDiscountsMarkers: zod_1.z.array(zod_1.z.string()).optional(),
     discountConfig: exports.OrderDiscountConfigSchema.optional(),

package/dist/pages/pagesApi.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 { IPageConfig, IPagesApi, IPagesEntity, IPositionBlock } from './pagesInterfaces';
+import type { IPageConfig, IPagesApi, IPageSearchResult, IPagesEntity, IPositionBlock } from './pagesInterfaces';
 /**
  * Controllers for working with page objects, including catalog pages
  * @handle /api/content/pages
@@ -96,12 +96,12 @@ export default class PagesApi extends AsyncModules implements IPagesApi {
      * @param {string} name - Text for searching page objects (search is performed on the title field of the localizeInfos object with the language taken into account). Example: "About Us".
      * @param {string} [url] - Page URL. Example: "catalog".
      * @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)
+     * @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.
+     * @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.
      * @see {@link https://js-sdk.oneentry.cloud/docs/pages/searchPage searchPage} documentation.
      */
-    searchPage(name: string, url?: string, langCode?: string): Promise<IPagesEntity[] | IError>;
+    searchPage(name: string, url?: string, langCode?: string): Promise<IPagesEntity[] | IPageSearchResult[] | IError>;
     /**
      * Add template data to pages
      * @handleName addTemplateToPages

package/dist/pages/pagesApi.js

@@ -201,16 +201,18 @@ class PagesApi extends asyncModules_1.default {
      * @param {string} name - Text for searching page objects (search is performed on the title field of the localizeInfos object with the language taken into account). Example: "About Us".
      * @param {string} [url] - Page URL. Example: "catalog".
      * @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)
+     * @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.
+     * @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.
      * @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 data = await this._fetchGet(`/quick/search?${urlPart}lang=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
+        const searchPages = await this._fetchGet(`/quick/search?${urlPart}lang=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
         // /quick/search?url=catalog&langCode=en_US&name=cat
+        // Validate response if validation is enabled
+        const data = this._validateResponse(searchPages, pagesSchemas_1.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
@@ -224,13 +226,12 @@ class PagesApi extends asyncModules_1.default {
             }));
             // Add templates to the fetched pages
             const withTemplate = await this.addTemplateToPages(pageList);
-            // Post-process the data and return it; ensures consistent structure or handles errors
-            return this._dataPostProcess(withTemplate, langCode);
+            // Normalize the data and return it; ensures consistent structure or handles errors
+            return this._normalizeData(withTemplate, langCode);
         }
-        // If there is a traffic limit, add templates to the initially fetched data without fetching detailed information
-        const withTemplate = await this.addTemplateToPages(data);
-        // Normalize the data and return it; ensures consistent structure or handles errors
-        return this._normalizeData(withTemplate, langCode);
+        // With a traffic limit (or on an API error) return the quick search response as is:
+        // short cards carry no templateIdentifier, so there is nothing to attach a template to
+        return this._normalizeData(data, langCode);
     }
     /**
      * Add template data to pages

package/dist/pages/pagesInterfaces.d.ts

@@ -81,11 +81,11 @@ interface IPagesApi {
      * @param {string} name - Text for searching page objects (search is performed on the title field of the localizeInfos object with the language taken into account). Example: "About Us".
      * @param {string} [url] - Optional page URL to filter search results. Example: "catalog".
      * @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)
+     * @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.
+     * @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[] | IError>;
+    searchPage(name: string, url?: string, langCode?: LangType): Promise<IPagesEntity[] | IPageSearchResult[] | IError>;
 }
 /**
  * @interface IPageConfig
@@ -294,4 +294,14 @@ interface IPagesEntity {
     total?: string;
     categoryPath?: string | null;
 }
-export type { IPageConfig, IPagesApi, IPagesEntity, IPositionBlock, IPositionForm, PageType, };
+/**
+ * @interface IPageSearchResult
+ * @property {number} id - The identifier of the page. Example: 10.
+ * @property {string} title - Page title in the requested language. Example: "Catalog".
+ * @description This interface defines the short page card returned by the quick search endpoint when the traficLimit config option is enabled. It contains only identification fields, without attributeValues, localizeInfos, blocks and other fields of a full page entity.
+ */
+interface IPageSearchResult {
+    id: number;
+    title: string;
+}
+export type { IPageConfig, IPagesApi, IPageSearchResult, IPagesEntity, IPositionBlock, IPositionForm, PageType, };

package/dist/pages/pagesSchemas.d.ts

@@ -66,6 +66,21 @@ export declare const PagesResponseSchema: z.ZodArray<z.ZodObject<{
     total: z.ZodOptional<z.ZodString>;
     categoryPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>>;
+/**
+ * Page search result schema
+ * Short card returned by the quick search endpoint
+ */
+export declare const PageSearchResultSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    title: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Page search response schema (array of short cards)
+ */
+export declare const PageSearchResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodNumber;
+    title: z.ZodString;
+}, z.core.$strip>>;
 /**
  * Single page response schema
  */

package/dist/pages/pagesSchemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PageConfigSchema = exports.SinglePageSchema = exports.PagesResponseSchema = exports.PageEntitySchema = void 0;
+exports.PageConfigSchema = exports.SinglePageSchema = exports.PageSearchResponseSchema = exports.PageSearchResultSchema = exports.PagesResponseSchema = exports.PageEntitySchema = void 0;
 /**
  * Validation schemas for Pages module
  * @description Zod schemas for validating pages-related API responses
@@ -38,6 +38,18 @@ exports.PageEntitySchema = zod_1.z.object({
  * Pages response schema (array of pages)
  */
 exports.PagesResponseSchema = zod_1.z.array(exports.PageEntitySchema);
+/**
+ * Page search result schema
+ * Short card returned by the quick search endpoint
+ */
+exports.PageSearchResultSchema = zod_1.z.object({
+    id: zod_1.z.number(),
+    title: zod_1.z.string(),
+});
+/**
+ * Page search response schema (array of short cards)
+ */
+exports.PageSearchResponseSchema = zod_1.z.array(exports.PageSearchResultSchema);
 /**
  * Single page response schema
  */

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, IProductsEntity, IProductsInfo, IProductsPriceQuery, IProductsQueryBase, IProductsRelatedQuery, IProductsResponse, IVectorSearchProducts } from './productsInterfaces';
+import type { IAggregatedProductGroup, 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
@@ -267,12 +267,12 @@ export default class ProductsApi extends AsyncModules implements IProductsApi {
      * @handleName searchProduct
      * @param {string} name - Text to search product page objects (search is based on the title field of the localizeInfos object with language consideration). Example: "laminat".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<IProductsEntity[] | IError>} Array with ProductEntity objects
+     * @returns {Promise<IProductsEntity[] | IProductSearchResult[] | IError>} Array with ProductEntity objects, or an array with short ProductSearchResult cards when the traficLimit config option is enabled
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Quick search for product page objects with limited output.
+     * @description Quick search for product page objects with limited output. The quick search endpoint returns short cards ({ id, title, pageId }); with traficLimit enabled they are returned as is, otherwise full product entities are fetched for the found ids.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/searchProduct searchProduct} documentation.
      */
-    searchProduct(name: string, langCode?: string): Promise<IProductsEntity[] | IError>;
+    searchProduct(name: string, langCode?: string): Promise<IProductsEntity[] | IProductSearchResult[] | IError>;
     /**
      * Getting the number of products for the entire catalog.
      * @handleName getProductsCount
@@ -350,12 +350,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<IProductsEntity[] | IError>} Array with ProductEntity objects.
+     * @returns {Promise<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<IProductsEntity[] | IError>;
+    getProductsByVectorSearch(body: IVectorSearchProducts, langCode?: string, offset?: number, limit?: number): Promise<IProductsResponse | IError>;
     /**
      * Get products by page url.
      * @param {string} url - Page url.

package/dist/products/productsApi.js

@@ -75,7 +75,7 @@ class ProductsApi extends asyncModules_1.default {
         const result = await this._fetchPost(`/all?` + this._queryParamsToString(query), { filter: body });
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, productsSchemas_1.ProductsResponseSchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Search for all product page objects with pagination (and aggregation) that do not have a category.
@@ -150,7 +150,7 @@ class ProductsApi extends asyncModules_1.default {
         const result = await this._fetchPost(`/page/${id}?langCode=${langCode}&` + this._queryParamsToString(query), { filter: body });
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, productsSchemas_1.ProductsResponseSchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Search for information about products and prices for the selected category.
@@ -229,7 +229,7 @@ class ProductsApi extends asyncModules_1.default {
             this._queryParamsToString(query), { filter: body });
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, productsSchemas_1.ProductsResponseSchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Find all related product page objects.
@@ -261,7 +261,7 @@ class ProductsApi extends asyncModules_1.default {
         const result = await this._fetchGet(`/${id}/related?langCode=${langCode}&` + this._queryParamsToString(query));
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, productsSchemas_1.ProductsResponseSchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Find products by its ids.
@@ -290,7 +290,7 @@ class ProductsApi extends asyncModules_1.default {
             ...userQuery,
         };
         const result = await this._fetchGet(`/ids?` + this._queryParamsToString(query));
-        return this._dataPostProcess(result, langCode);
+        return this._normalizeData(result, langCode);
     }
     /**
      * Retrieve one product object.
@@ -310,7 +310,7 @@ class ProductsApi extends asyncModules_1.default {
         const result = await this._fetchGet(`/${id}?` + this._queryParamsToString(query));
         // Validate response if validation is enabled
         const validated = this._validateResponse(result, productsSchemas_1.ProductEntitySchema);
-        return this._dataPostProcess(validated, langCode);
+        return this._normalizeData(validated, langCode);
     }
     /**
      * Getting a product block object by product id.
@@ -330,13 +330,15 @@ class ProductsApi extends asyncModules_1.default {
      * @handleName searchProduct
      * @param {string} name - Text to search product page objects (search is based on the title field of the localizeInfos object with language consideration). Example: "laminat".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {Promise<IProductsEntity[] | IError>} Array with ProductEntity objects
+     * @returns {Promise<IProductsEntity[] | IProductSearchResult[] | IError>} Array with ProductEntity objects, or an array with short ProductSearchResult cards when the traficLimit config option is enabled
      * @throws {IError} When isShell=false and an error occurs during the fetch
-     * @description Quick search for product page objects with limited output.
+     * @description Quick search for product page objects with limited output. The quick search endpoint returns short cards ({ id, title, pageId }); with traficLimit enabled they are returned as is, otherwise full product entities are fetched for the found ids.
      * @see {@link https://js-sdk.oneentry.cloud/docs/products/searchProduct searchProduct} documentation.
      */
     async searchProduct(name, langCode = this.state.lang) {
-        const searchProducts = await this._fetchGet(`/quick/search?langCode=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
+        const result = await this._fetchGet(`/quick/search?langCode=${encodeURIComponent(langCode)}&name=${encodeURIComponent(name)}`);
+        // Validate response if validation is enabled
+        const searchProducts = this._validateResponse(result, productsSchemas_1.ProductSearchResponseSchema);
         if (!this.state.traficLimit && Array.isArray(searchProducts)) {
             if (searchProducts.length === 0)
                 return searchProducts;
@@ -441,7 +443,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<IProductsEntity[] | IError>} Array with ProductEntity objects.
+     * @returns {Promise<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.
@@ -453,7 +455,7 @@ class ProductsApi extends asyncModules_1.default {
             limit,
         };
         const result = await this._fetchPost(`/vector/search?` + this._queryParamsToString(query), body);
-        return this._dataPostProcess(result, langCode);
+        return this._normalizeData(result, langCode);
     }
     /**
      * Get products by page url.

package/dist/products/productsInterfaces.d.ts

@@ -189,11 +189,11 @@ interface IProductsApi {
      * @handleName searchProduct
      * @param {string} name - Text to search product page objects (search is based on the title field of the localizeInfos object with language consideration). Example: 'laminat'.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {IProductsEntity[]} Array with ProductEntity objects
+     * @returns {IProductsEntity[] | IProductSearchResult[]} Array with ProductEntity objects, or an array with short ProductSearchResult cards when the traficLimit config option is enabled
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
-     * @description This method performs a quick search for product page objects with limited output.
+     * @description This method performs a quick search for product page objects with limited output. With traficLimit enabled the raw quick search response is returned as short cards; otherwise full product entities are fetched for the found ids.
      */
-    searchProduct(name: string, langCode?: string): Promise<IProductsEntity[] | IError>;
+    searchProduct(name: string, langCode?: string): Promise<IProductsEntity[] | IProductSearchResult[] | IError>;
     /**
      * Getting the number of products for the entire catalog.
      * @handleName getProductsCount
@@ -299,11 +299,11 @@ 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 {IProductsEntity[]} Array with ProductEntity objects.
+     * @returns {IProductsResponse} A promise that resolves to a products response (items + total) or an error.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @description This method performs a semantic (vector) search for products.
      */
-    getProductsByVectorSearch(body: IVectorSearchProducts, langCode?: string, offset?: number, limit?: number): Promise<IProductsEntity[] | IError>;
+    getProductsByVectorSearch(body: IVectorSearchProducts, langCode?: string, offset?: number, limit?: number): Promise<IProductsResponse | IError>;
 }
 /**
  * @interface IProductsQueryBase
@@ -533,11 +533,25 @@ interface IProductsEntity {
         "title": "Product 2"
       }
     ]
+ * @property {number} [totalFound] - Number of products matched before limits are applied; returned by block product endpoints (`similarProducts`, cart/wishlist recommendations, frequently ordered). Optional. Example: 2.
  * @description This interface defines the structure of a response containing multiple product entities, including the total count and an array of product items.
  */
 interface IProductsResponse {
     items: IProductsEntity[];
     total: number;
+    totalFound?: number;
+}
+/**
+ * @interface IProductSearchResult
+ * @property {number} id - The identifier of the product. Example: 2957.
+ * @property {string} title - Product title in the requested language. Example: "Cosmo".
+ * @property {number} pageId - The identifier of the catalog page the product is linked to. Example: 10.
+ * @description This interface defines the short product card returned by the quick search endpoint when the traficLimit config option is enabled. It contains only identification fields, without attributeValues, localizeInfos and other fields of a full product entity.
+ */
+interface IProductSearchResult {
+    id: number;
+    title: string;
+    pageId: number;
 }
 /**
  * @interface IProductsCount
@@ -632,31 +646,37 @@ interface IProductBlockSettings {
 }
 /**
  * @interface IProductBlockProductConfig
- * @property {string | number} quantity - Number of products to render. Example: 9.
- * @property {string | number} countElementsPerRow - Products per row. Example: 3.
+ * @property {string | number} [quantity] - Number of products to render; absent when the block config is empty. Example: 9.
+ * @property {string | number} [countElementsPerRow] - Products per row; absent when the block config is empty. Example: 3.
  * @property {string | number} [sortType] - Sort field. Example: "price".
  * @property {string | number} [sortOrder] - Sort direction. Example: "ASC".
- * @description Layout config for products inside a {@link IProductBlock}.
+ * @description Layout config for products inside a {@link IProductBlock}; an empty object when the block is not configured.
  */
 interface IProductBlockProductConfig {
-    quantity: string | number;
-    countElementsPerRow: string | number;
+    quantity?: string | number;
+    countElementsPerRow?: string | number;
     sortType?: string | number;
     sortOrder?: string | number;
 }
 /**
  * @interface IProductBlockSimilarRule
- * @property {string} property - Product property to match on. Example: "categories".
- * @property {string} includes - Match strategy (e.g. "any", "all"). Example: "any".
- * @property {string} keywords - Keywords used for the match. Example: "foo,bar".
- * @property {string} strict - Strictness flag ("true"/"false") of the match. Example: "false".
+ * @property {string} id - Rule identifier (UUID). Example: "812ee2bb-a90f-4743-9643-663f87acedf5".
+ * @property {string} title - Rule title; empty string when not set. Example: "".
+ * @property {string} attributeMarker - Marker of the product attribute the rule matches on. Example: "nameofproduct_3".
+ * @property {string} conditionMarker - Condition operator applied to the attribute. Example: "in".
+ * @property {string} conditionValue - Value the condition compares against. Example: "Blue".
+ * @property {string} statusMarker - Product status marker the rule is limited to; empty string when not limited. Example: "".
+ * @property {string[]} pageUrls - Page URLs the rule is scoped to; empty array when not restricted.
  * @description Single rule used to compute similar products for a {@link IProductBlock}.
  */
 interface IProductBlockSimilarRule {
-    property: string;
-    includes: string;
-    keywords: string;
-    strict: string;
+    id: string;
+    title: string;
+    attributeMarker: string;
+    conditionMarker: string;
+    conditionValue: string;
+    statusMarker: string;
+    pageUrls: string[];
 }
 interface IProductBlock {
     id: number;
@@ -700,4 +720,4 @@ interface IVectorSearchProducts {
     maxHits?: number;
     debug?: boolean;
 }
-export type { IAggregatedProductGroup, IFilterParams, IProductBlock, IProductInfo, IProductsApi, IProductsByIdsQuery, IProductsCount, IProductsEntity, IProductsInfo, IProductsPriceQuery, IProductsQuery, IProductsQueryBase, IProductsRelatedQuery, IProductsResponse, IVectorSearchProducts, };
+export type { IAggregatedProductGroup, IFilterParams, IProductBlock, IProductInfo, IProductsApi, IProductsByIdsQuery, IProductsCount, IProductSearchResult, IProductsEntity, IProductsInfo, IProductsPriceQuery, IProductsQuery, IProductsQueryBase, IProductsRelatedQuery, IProductsResponse, IVectorSearchProducts, };

package/dist/products/productsSchemas.d.ts

@@ -106,6 +106,7 @@ export declare const ProductsResponseSchema: z.ZodObject<{
         discountConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     }, z.core.$strip>>;
     total: z.ZodNumber;
+    totalFound: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 /**
  * Single product response schema
@@ -148,6 +149,23 @@ export declare const SingleProductSchema: z.ZodObject<{
     distance: z.ZodOptional<z.ZodNumber>;
     discountConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
 }, z.core.$strip>;
+/**
+ * Product search result schema
+ * Short card returned by the quick search endpoint
+ */
+export declare const ProductSearchResultSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    title: z.ZodString;
+    pageId: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Product search response schema (array of short cards)
+ */
+export declare const ProductSearchResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodNumber;
+    title: z.ZodString;
+    pageId: z.ZodNumber;
+}, z.core.$strip>>;
 /**
  * Products count schema
  */

package/dist/products/productsSchemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RelatedProductsSchema = exports.ProductBlockSchema = exports.ProductsCountSchema = exports.SingleProductSchema = exports.ProductsResponseSchema = exports.ProductEntitySchema = exports.ProductImageSchema = exports.ProductPriceSchema = void 0;
+exports.RelatedProductsSchema = exports.ProductBlockSchema = exports.ProductsCountSchema = exports.ProductSearchResponseSchema = exports.ProductSearchResultSchema = exports.SingleProductSchema = exports.ProductsResponseSchema = exports.ProductEntitySchema = exports.ProductImageSchema = exports.ProductPriceSchema = void 0;
 /**
  * Validation schemas for Products module
  * @description Zod schemas for validating products-related API responses
@@ -74,11 +74,25 @@ exports.ProductEntitySchema = zod_1.z.object({
 exports.ProductsResponseSchema = zod_1.z.object({
     items: zod_1.z.array(exports.ProductEntitySchema),
     total: zod_1.z.number(),
+    totalFound: zod_1.z.number().optional(),
 });
 /**
  * Single product response schema
  */
 exports.SingleProductSchema = exports.ProductEntitySchema;
+/**
+ * Product search result schema
+ * Short card returned by the quick search endpoint
+ */
+exports.ProductSearchResultSchema = zod_1.z.object({
+    id: zod_1.z.number(),
+    title: zod_1.z.string(),
+    pageId: zod_1.z.number(),
+});
+/**
+ * Product search response schema (array of short cards)
+ */
+exports.ProductSearchResponseSchema = zod_1.z.array(exports.ProductSearchResultSchema);
 /**
  * Products count schema
  */

package/dist/subscriptions/subscriptionsApi.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 { ICancelSubscription, ICreatedSubscription, ISubscribe, ISubscriptionsApi } from './subscriptionsInterfaces';
+import type { ICancelSubscription, ICreatedSubscription, ISubscribe, ISubscriptionEntity, ISubscriptionsApi } from './subscriptionsInterfaces';
 /**
  * Controllers for working with paid subscriptions.
  * @handle /api/content/subscriptions
@@ -41,15 +41,15 @@ export default class SubscriptionsApi extends AsyncModules implements ISubscript
      */
     cancelSubscription(body: ICancelSubscription): Promise<boolean | IError>;
     /**
-     * Get all available subscription markers.
+     * Get all available subscriptions.
      * @handleName getAllSubscriptions
-     * @returns {Promise<string[] | IError>} Returns an array of available subscription markers.
+     * @returns {Promise<ISubscriptionEntity[] | IError>} Returns an array of available subscriptions.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @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}.
      * @see {@link https://js-sdk.oneentry.cloud/docs/subscriptions/getAllSubscriptions getAllSubscriptions} documentation.
      */
-    getAllSubscriptions(): Promise<string[] | IError>;
+    getAllSubscriptions(): Promise<ISubscriptionEntity[] | IError>;
     /**
      * Get markers of the user's active subscriptions.
      * @handleName getActiveSubscriptions

package/dist/subscriptions/subscriptionsApi.js

@@ -51,9 +51,9 @@ class SubscriptionsApi extends asyncModules_1.default {
         return this._fetchBoolean(() => this._fetchDelete(``, body));
     }
     /**
-     * Get all available subscription markers.
+     * Get all available subscriptions.
      * @handleName getAllSubscriptions
-     * @returns {Promise<string[] | IError>} Returns an array of available subscription markers.
+     * @returns {Promise<ISubscriptionEntity[] | IError>} Returns an array of available subscriptions.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @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}.
@@ -61,7 +61,7 @@ class SubscriptionsApi extends asyncModules_1.default {
      */
     async getAllSubscriptions() {
         const data = await this._fetchGet(``);
-        const validated = this._validateResponse(data, subscriptionsSchemas_1.SubscriptionMarkersSchema);
+        const validated = this._validateResponse(data, subscriptionsSchemas_1.SubscriptionsListSchema);
         return this._normalizeData(validated);
     }
     /**

package/dist/subscriptions/subscriptionsInterfaces.d.ts

@@ -1,4 +1,4 @@
-import type { IError } from '../base/utils';
+import type { IError, ILocalizeInfo } from '../base/utils';
 /**
  * Interface for the Subscriptions API module.
  * @interface ISubscriptionsApi
@@ -26,14 +26,14 @@ interface ISubscriptionsApi {
      */
     cancelSubscription(body: ICancelSubscription): Promise<boolean | IError>;
     /**
-     * Get all available subscription markers.
+     * Get all available subscriptions.
      * @handleName getAllSubscriptions
-     * @returns {Promise<string[] | IError>} Returns an array of available subscription markers.
+     * @returns {Promise<ISubscriptionEntity[] | IError>} Returns an array of available subscriptions.
      * @throws {IError} When isShell=false and an error occurs during the fetch
      * @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}.
      */
-    getAllSubscriptions(): Promise<string[] | IError>;
+    getAllSubscriptions(): Promise<ISubscriptionEntity[] | IError>;
     /**
      * Get markers of the user's active subscriptions.
      * @handleName getActiveSubscriptions
@@ -87,4 +87,25 @@ interface ICreatedSubscription {
     paymentUrl: string;
     status: string;
 }
-export type { ICancelSubscription, ICreatedSubscription, ISubscribe, ISubscriptionsApi, };
+/**
+ * Available subscription.
+ * @interface ISubscriptionEntity
+ * @property {number} id - Subscription identifier. Example: 1.
+ * @property {string} identifier - Subscription textual identifier (marker). Example: "test_subscription".
+ * @property {ILocalizeInfo} localizeInfos - Localized subscription info for the current language. Example: `{ title: "Test subscription" }`.
+ * @property {number[]} productIds - Identifiers of the products included in the subscription. Example: [3445].
+ * @property {number} periodInDays - Subscription period in days. Example: 30.
+ * @property {number} paymentAccountId - Identifier of the payment account the subscription is billed through. Example: 1.
+ * @property {boolean} isUsed - Indicates whether the subscription is in use. Example: false.
+ * @description Subscription configured in the project, returned by getAllSubscriptions.
+ */
+interface ISubscriptionEntity {
+    id: number;
+    identifier: string;
+    localizeInfos: ILocalizeInfo;
+    productIds: number[];
+    periodInDays: number;
+    paymentAccountId: number;
+    isUsed: boolean;
+}
+export type { ICancelSubscription, ICreatedSubscription, ISubscribe, ISubscriptionEntity, ISubscriptionsApi, };